Changelog
Changelog
O que mudou na API e nesta documentação.
Novembro de 2026
- Contas em análise: já usam a API e o painel (pagamentos, reembolsos, chaves de API, webhooks); só os saques esperam a aprovação (
403 withdrawals_not_allowed).GET /v1/withdrawals/limitstrazaccount_statusecan_withdraw. Ao suspender uma conta, os saques ainda não enviados são recusados (reason: account_suspended) e o valor volta para o saldo disponível. - Saques:
POST /v1/withdrawalsaceitaexpected_net_cents(opcional), o líquido que você conferiu; se a taxa mudou, a resposta é409 fee_changedcom a simulação nova emdetaile nada é reservado.GET /v1/withdrawals/limitsnão traz maisfee_cents(a taxa fixa somada ao saque): no lugar vêmfee_bpsefee_min_cents. - Pagamentos: a resposta de criação traz o mesmo
payerda consulta, com oemailquando ele existe. - Saques: a taxa de saque agora é descontada do valor pedido (nunca somada).
amount_centsé o que sai do saldo; a resposta traz tambémnet_cents, o que chega na sua chave. NovoGET /v1/withdrawals/quotepara saber o valor exato antes de pedir. - Pagamentos: um pagamento
failedtraz o motivo emfailure_code(payer_document_invalid,payer_data_invalidoucharge_refused), também no webhookpayment.failed. - Webhooks: todo evento traz
created_at(RFC 3339, UTC). - Chave Pix de saque: pela API, toda chave passa por análise, inclusive a primeira.
- Reembolsos: não podem ser pedidos nem enviados enquanto o pagamento tiver uma infração em aberto (
infraction_open); a devolução vai para quem pagou, conforme confirmado pelo banco. - Pagamentos Pix: criar (por valor ou por produtos do catálogo com
items), buscar e listar (/v1/payments). - Reembolsos: pedir, listar e buscar (
/v1/payments/{id}/refunds,/v1/refunds). - Saldo, chave Pix de saque e saques (
/v1/balance,/v1/payout-keys,/v1/withdrawals). - Infrações: listar e buscar (
/v1/infractions). - Webhooks assinados para pagamentos, reembolsos, saques e infrações.
- Chaves de API com escopos.
- Documentação pública com exemplos em cURL, Node.js, PHP e Python,
llms.txt,llms-full.txteopenapi.json. - Botão "Fazer com IA" para copiar um prompt pronto de integração.
- Pagamentos: QR Code em SVG (
pix.qr_svg) ao criar e ao buscar; busca (q) e filtro por período (period,from,to) na lista.