Solicitar saque
Cria um pedido de saque por Pix para a chave de destino cadastrada da conta. O valor é reservado no saldo e o pedido entra em análise. `201` confirma o pedido, não o envio do Pix. `amount` é inteiro em centavos, como nas cobranças: `25000` é R$ 250,00. Decimal ou texto recebem `400 withdrawal.validation_failed`. No sandbox, o Pix de saída é simulado.
Cria um pedido de saque por Pix para a chave de destino cadastrada da conta. O valor é reservado
no saldo e o pedido entra em análise. 201 confirma o pedido, não o envio do Pix.
amount é inteiro em centavos, como nas cobranças: 25000 é R$ 250,00. Decimal ou texto
recebem 400 withdrawal.validation_failed. No sandbox, o Pix de saída é simulado.
ApiKeyAuthorization<token>A chave de API crua, sem prefixo: kpa_test_sk_… no sandbox e kpa_live_sk_… em produção.
Use apenas no servidor.
Idempotency-Key*string10 a 200 caracteres, única por pedido de saque. Alternativa ao campo idempotencyKey do corpo; o cabeçalho tem precedência.
10 <= length <= 200application/json- body
accountId*stringConta de origem, entregue no credenciamento.
uuidamount*integerValor em centavos. 25000 é R$ 250,00. Mínimo 100 (R$ 1,00).
100 <= valuecurrencyCode*stringpixKeyType*PixKeyTypeRequestTipo da chave no pedido. Chave aleatória é Random; EVP é recusado.
"CPF""CNPJ""Email""Phone""Random"pixKey*stringChave Pix de destino. Precisa ser a cadastrada como destino de saque.
beneficiaryName?string|nullbeneficiaryDocument?|CPF ou CNPJ do titular cadastrado.
idempotencyKey?string10 <= length <= 200Repetição idempotente. Devolve o saque original com o status atual.
application/json- response
withdrawalId?stringuuidstatus?WithdrawalStatus"processando""transferido""rejeitado""cancelado""devolvido""expirado""falha"curl -X POST 'https://g6idryo27h.execute-api.us-east-1.amazonaws.com/api/v1/withdrawals' \ -H 'Idempotency-Key: saque-2026-11-02-000123' \ -H 'Content-Type: application/json' \ -d '{ "accountId": "3f6b2c1e-8d4a-4b7f-9e21-5a0c7d9e1b42", "amount": 25000, "currencyCode": "BRL", "pixKeyType": "CNPJ", "pixKey": "11222333000181"}'{ "withdrawalId": "01932f5e-7c3a-7b21-9f4e-2d8c6a1b0e47", "status": "transferido"}