POST
/
withdrawals
/
withdraw
cURL
curl --request POST \
  --url https://sandbox-api.superpagamentos.com/withdrawals/withdraw \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "withdrawalMethod": "pix",
  "amount": 10000,
  "bankAccountId": 1234567890,
  "pixKeyType": "CPF",
  "pixKey": "1234567890",
  "postbackUrl": "https://example.com/callback"
}'
{
  "data": {
    "id": "5509e70d-fa20-4103-84c6-27370138948b",
    "amount": 10000,
    "liquidAmount": 9990,
    "status": "PENDING",
    "pixKeyType": "CPF",
    "pixKey": "1234567890",
    "createdAt": "2025-06-09T19:14:20.125Z",
    "updatedAt": "2025-06-09T19:14:20.125Z"
  },
  "message": "Pagamento PIX criado com sucesso"
}

Authorizations

​
Authorization
string
header
required

Token JWT gerado na rota de autenticação (/auth). Deve ser enviado no formato: Bearer <token>

Headers

​
x-subaccount-id
string<uuid>

ID da subconta onde a operação será realizada. Quando fornecido, a operação será executada no contexto desta subconta específica.

Body

application/json

Payload para criação de um novo saque. O tipo de saque determina a estrutura específica dos dados necessários.

The body is of type object.

Response

201
application/json

Saque solicitado com sucesso

The response is of type object.