Skip to main content
POST
/
transfers
Solicitar Saque
curl --request POST \
  --url https://api.example.com/transfers \
  --header 'Content-Type: application/json' \
  --data '
{
  "api_token": "<string>",
  "amount": 123
}
'
{
  "201": {},
  "400": {},
  "401": {},
  "422": {},
  "500": {}
}

​
Visão Geral

Este endpoint permite solicitar a transferência de valores do seu saldo disponível na KlivoPay para sua conta bancária cadastrada.
Valor mínimo para saque: R$ 10,00 (1000 centavos)

​
Endpoint

POST https://api.klivopay.com.br/api/public/v1/transfers

​
Parâmetros

​
api_token
string
required
Seu token de autenticação da API KlivoPay
​
amount
integer
required
Valor da transferência em centavos. Mínimo: 1000 (R$ 10,00)

​
Exemplo de Requisição

curl -X POST 'https://api.klivopay.com.br/api/public/v1/transfers' \
  -H 'Content-Type: application/json' \
  -d '{
    "api_token": "seu_token_aqui",
    "amount": 50000
  }'

​
Resposta de Sucesso

201 Created
{
  "success": true,
  "data": {
    "hash": "transfer123abc",
    "amount": 50000,
    "status": "pending",
    "bank_account": {
      "type": "checking",
      "bank_code": "001",
      "agency": "1234",
      "account_number": "12345-6",
      "holder_name": "João Silva"
    },
    "created_at": "2025-01-20T10:15:00Z",
    "estimated_completion": "2025-01-21T10:15:00Z"
  }
}

​
Códigos de Resposta

​
201
Created
Saque solicitado com sucesso
​
400
Bad Request
Dados inválidos ou saldo insuficiente
​
401
Unauthorized
Token de API inválido ou ausente
​
422
Unprocessable Entity
Valor abaixo do mínimo permitido (R$ 10,00)
​
500
Internal Server Error
Erro interno do servidor

​
Status do Saque

Saque solicitado e aguardando processamento
Transferência em processamento pelo banco
Transferência concluída com sucesso
Transferência falhou (verifique dados bancários)
O prazo para processamento varia de acordo com o tipo de conta bancária cadastrada e pode levar de 1 a 3 dias úteis.