Skip to main content

PIX OUT – Solicitar Saque

Use este endpoint para enviar fundos via PIX da sua conta para o cliente ou parceiro.
Informe o valor, a chave de destino e, se quiser, um código seu para rastrear a operação.

O que enviar no corpo da requisição:

  • amount
    Valor em centavos (ex.: R$ 1,00 = 100).
  • pixKey
    Chave Pix de destino (CPF, CNPJ, e‑mail, telefone ou chave aleatória).
  • pixKeyType
    Tipo da chave: CPF, CNPJ, phone, email ou random.
  • externalCode (opcional)
    Seu identificador interno para correlacionar transações.
  • baasPostbackUrl (opcional)
    URL que receberá notificações de status (webhook).

Como testar no Swagger​

  1. Clique em Try it out.
  2. Preencha o cabeçalho:
    • x-authorization-key: sua chave secreta
  3. Ajuste o corpo da requisição conforme necessário.
  4. Clique em Execute.

Verifique a resposta
Role até o painel Response para ver o JSON retornado.

🔍 Exemplo de Requisição​

curl --request POST \
  --url https://api.cashtime.com.br/v1/request/withdraw \
  --header 'Content-Type: application/json' \
  --header 'x-authorization-key: SUA_CHAVE_SECRETA' \
  --data '{
    "amount": 1000,
    "pixKey": "12345678910",
    "pixKeyType": "cpf",
    "externalCode": "pedido_123",
    "baasPostbackUrl": "https://seusistema.com.br/webhook"
  }'

✅ Exemplo de Resposta​

{
  "id": "64905df5-ee95-42f7-bc79-6bbff92ee055",
  "amount": 1000,
  "taxes": 100.1,
  "pixKey": "12345678910",
  "pixKeyType": "cpf",
  "externalCode": "pedido_123",
  "withdrawStatusId": "AwaitingAprove",
  "createdAt": "2025-03-05T18:55:22.919Z",
  "updatedAt": "2025-03-05T18:55:22.919Z"
}