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