Skip to main content
POST
/
api
/
v1
/
withdraw
/
create
curl -X POST 'https://api.eyowallet.ru/api/v1/withdraw/create' \
  -H 'X-API-Key: sua_api_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": 100.00,
    "pixKey": "usuario@example.com",
    "pixKeyType": "EMAIL",
    "description": "Saque para conta pessoal"
  }'

{
  "success": true,
  "message": "Saque processado com sucesso",
  "data": {
    "id": "withdraw_abc123",
    "value": 10000,
    "fee": 50,
    "sent": 9950,
    "status": "COMPLETED",
    "pixKey": "usuario@example.com",
    "createdAt": "2024-01-15T10:30:00Z"
  }
}

curl -X POST 'https://api.eyowallet.ru/api/v1/withdraw/create' \
  -H 'X-API-Key: sua_api_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": 100.00,
    "pixKey": "usuario@example.com",
    "pixKeyType": "EMAIL",
    "description": "Saque para conta pessoal"
  }'

{
  "success": true,
  "message": "Saque processado com sucesso",
  "data": {
    "id": "withdraw_abc123",
    "value": 10000,
    "fee": 50,
    "sent": 9950,
    "status": "COMPLETED",
    "pixKey": "usuario@example.com",
    "createdAt": "2024-01-15T10:30:00Z"
  }
}

​
Parâmetros

​
amount
number
required
Valor do saque em reais. Valor mínimo: R$ 5,00 (500 centavos).
​
pixKey
string
required
Chave PIX do destinatário (CPF, CNPJ, e-mail, telefone ou chave aleatória).
​
pixKeyType
string
required
Tipo da chave PIX: CPF, CNPJ, EMAIL, PHONE, ou RANDOM.
​
description
string
Descrição opcional do saque.
​
coverFee
boolean
default:"false"
Se true, o valor informado é o valor líquido que será enviado. A taxa será deduzida do saldo adicional.
​
splitUser
string
Email de outro usuário Eyo Wallet para dividir o saque. O valor do split será enviado via PIX para o usuário especificado.
​
splitTax
number
default:"50"
Porcentagem do valor a ser transferida para o usuário de split. Valor entre 1 e 100. Padrão: 50% (divisão igualitária).
O saldo do usuário será debitado imediatamente ao criar o saque. Certifique-se de que há saldo suficiente antes de criar um saque.

​
Status do Saque

Os saques podem ter os seguintes status:
StatusDescrição
PENDINGSaque criado, aguardando processamento
COMPLETEDSaque processado com sucesso
FAILEDSaque falhou
A maioria dos saques é processada instantaneamente e ficam com status COMPLETED imediatamente após a criação.

​
Permissões Necessárias

Esta rota requer a permissão write:withdraw:create.

​
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
​
amount
number
required

Valor do saque em reais. Mínimo: R$ 7,00

Required range: x >= 7
​
pixKey
string
required

Chave PIX do destinatário

​
pixKeyType
enum<string>
required

Tipo da chave PIX

Available options:
CPF,
CNPJ,
EMAIL,
PHONE,
RANDOM
​
description
string

Descrição opcional do saque

​
coverFee
boolean
default:false

Se true, o valor informado é o valor líquido que será enviado

​
verificationCode
string

Código de verificação se a segurança de transferências estiver ativada

​
splitUser
string

Email de outro usuário Eyo Wallet para dividir o saque

​
splitTax
number
default:50

Porcentagem do valor a ser transferida para o usuário de split

Required range: 1 <= x <= 100

Response

Saque criado com sucesso

​
success
boolean
​
message
string
​
data
object