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/limits traz account_status e can_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/withdrawals aceita expected_net_cents (opcional), o líquido que você conferiu; se a taxa mudou, a resposta é 409 fee_changed com a simulação nova em detail e nada é reservado. GET /v1/withdrawals/limits não traz mais fee_cents (a taxa fixa somada ao saque): no lugar vêm fee_bps e fee_min_cents.
  • Pagamentos: a resposta de criação traz o mesmo payer da consulta, com o email quando 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ém net_cents, o que chega na sua chave. Novo GET /v1/withdrawals/quote para saber o valor exato antes de pedir.
  • Pagamentos: um pagamento failed traz o motivo em failure_code (payer_document_invalid, payer_data_invalid ou charge_refused), também no webhook payment.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.txt e openapi.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.