Sacar para uma chave Pix
Tira o valor do saldo e envia para a chave Pix. Precisa da permissão withdrawals:write, que vem desligada, e respeita o limite diário e os IPs da chave. Com chave de teste, o saque é simulado e pago na hora.
Permissão da chave: withdrawals:write.
x-api-key<token>Sua chave de API, criada no painel em Desenvolvedores → Chaves de API.
idempotency-key?stringEnvie a mesma chave para repetir com segurança: o mesmo saque volta, sem sacar de novo.
application/json- body
amountCents*integerQuanto sai do saldo, em centavos, já incluindo a taxa de saque. Mínimo 600 (R$ 6,00).
600 <= valuepixKey*stringA chave Pix de destino.
3 <= length <= 140pixKeyType*stringCPF, CNPJ, PHONE (celular com DDD), EMAIL ou EVP (chave aleatória).
"CPF""CNPJ""PHONE""EMAIL""EVP"O saque.
application/json- response
Um saque do saldo para uma chave Pix.
id*stringstatus*stringPENDING enquanto é enviado; PAID, PARTIALLY_PAID ou FAILED no fim.
"CREATED""PENDING""APPROVED""PAID""PARTIALLY_PAID""FAILED""CANCELLED"amountCents*integerO que chega no destino.
feeCents*integerA taxa de saque.
pixKeyType*string"CPF""CNPJ""PHONE""EMAIL""EVP"pixKey*stringA chave de destino, parcialmente escondida.
livemode*booleancreatedAt*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$date-timeupdatedAt*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$date-timecurl -X POST "https://example.com/api/v1/withdrawals" \ -H "Content-Type: application/json" \ -d '{ "amountCents": 50000, "pixKey": "12345678000190", "pixKeyType": "CNPJ" }'{ "id": "wd_01k6g8m2v4x7z9b3c5d7f9h0j2", "status": "PAID", "amountCents": 49900, "feeCents": 100, "pixKeyType": "CPF", "pixKey": "12.***.***/0001-90", "livemode": true, "createdAt": "2026-10-04T15:30:00.000Z", "updatedAt": "2026-10-04T15:30:00.000Z"}