Skip to main content
POST
/
api
/
v1
/
transfer
/
internal
curl -X POST 'https://api.eyowallet.ru/api/v1/transfer/internal' \
  -H 'X-API-Key: sua_api_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "[email protected]",
    "value": 50.00,
    "description": "Pagamento de serviço"
  }'
{
  "success": true,
  "message": "Transferência realizada com sucesso",
  "data": {
    "id": "transfer_abc123",
    "value": 5000,
    "valueInReais": 50.00,
    "recipientEmail": "[email protected]",
    "recipientName": "João Silva",
    "description": "Pagamento de serviço",
    "createdAt": "2024-01-15T10:30:00Z"
  }
}
curl -X POST 'https://api.eyowallet.ru/api/v1/transfer/internal' \
  -H 'X-API-Key: sua_api_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "[email protected]",
    "value": 50.00,
    "description": "Pagamento de serviço"
  }'
{
  "success": true,
  "message": "Transferência realizada com sucesso",
  "data": {
    "id": "transfer_abc123",
    "value": 5000,
    "valueInReais": 50.00,
    "recipientEmail": "[email protected]",
    "recipientName": "João Silva",
    "description": "Pagamento de serviço",
    "createdAt": "2024-01-15T10:30:00Z"
  }
}

Parâmetros

email
string
required
Email do destinatário da transferência. Deve ser uma conta Eyo Wallet ativa.
value
number
required
Valor da transferência em reais. Pode ser qualquer valor acima de R$ 0,01.
description
string
Descrição opcional da transferência. Aparecerá no extrato do destinatário.

Campos da Resposta

id
string
ID único da transferência.
value
integer
Valor da transferência em centavos.
valueInReais
number
Valor da transferência em reais.
recipientEmail
string
Email do destinatário.
recipientName
string
Nome do destinatário.
description
string
Descrição da transferência.

Vantagens da Transferência Interna

CaracterísticaDescrição
GratuitaSem taxa de transferência
InstantâneaSaldo disponível imediatamente
Sem limiteSem valor mínimo ou máximo
SimplesApenas email + valor necessários
Transferências internas são a forma mais rápida e econômica de enviar dinheiro para outros usuários Eyo Wallet.

Erros Comuns

CódigoErroDescrição
404Usuário não encontradoO email informado não pertence a nenhuma conta Eyo Wallet
400Saldo insuficienteVocê não tem saldo suficiente para a transferência
400Não é possível transferir para si mesmoO email é o mesmo da sua conta

Permissões Necessárias

Esta rota requer a permissão write:transfer:internal.

Rate Limiting

  • 10 req/s (600 req/min) por API Key

Authorizations

X-API-Key
string
header
required

API Key obtida no painel da Eyo Wallet

Body

application/json
email
string<email>
required

Email do destinatário (conta Eyo Wallet ativa)

value
number
required

Valor da transferência em reais (mínimo R$ 0,01)

Required range: x >= 0.01
description
string

Descrição opcional da transferência

Response

Transferência realizada com sucesso

success
boolean
message
string
data
object