Histórico de mudanças e versionamento

Política de versionamento

• A versão da API é uma data. A versão atual é 2026-10-01, informada em todo webhook como api_version.
• Os caminhos trazem um prefixo de versão principal estável (/v1). Dentro de /v1:
  • Mudanças aditivas podem ser publicadas a qualquer momento: novos endpoints, novos campos opcionais de requisição, novos campos de resposta, novos tipos de evento, novos valores de code de erro. Escreva clientes que ignorem campos desconhecidos e tratem códigos desconhecidos pelo seu type.
  • Mudanças incompatíveis (remover ou renomear campos, mudar tipos ou semântica) só são publicadas em uma nova versão datada, anunciada com antecedência neste histórico, com a versão anterior mantida disponível por um período documentado.
• Os payloads de webhook seguem as mesmas regras. Baseie o seu tratamento em event_type e api_version.
• Os SDKs seguem versionamento semântico e informam a versão da API a partir da qual foram gerados.

2026-10-21 — plataforma somente live e pagamentos live em custódia

A plataforma agora é somente live: toda chave de API é uma chave live e todo pagamento é real. As chaves de API de teste, as redes de teste, o simulador de cadeia e o checkout de demonstração público foram removidos. Cadastro, organizações, lojas, convites de equipe, verificação da empresa e chamados de suporte estão disponíveis para todas as contas; chaves de API live, intenções de pagamento, sessões de checkout e saques ficam disponíveis quando a sua conta for ativada e, antes disso, são recusados com feature_unavailable_error.

• GET /v1/health ganha test_mode_enabled (sempre false nesta plataforma) e um valor adicional de environment.
• Novo código de erro test_mode_disabled para chaves e pagamentos que não são live.

Os pagamentos live são em custódia: eles são processados pela conta Bitcart da plataforma, e o FeitPay mantém os fundos como o seu saldo até que você os retire por meio de saques aprovados. As contas só são ativadas para pagamentos live depois que cada requisito de liberação (release gate) é aprovado, incluindo um novo requisito legal de autorização de custódia e transferência. Mudanças aditivas na API:

• Saldos e saques: GET /v1/balances, GET /v1/payout-assets, GET /v1/payout-destinations, GET e POST /v1/payouts, GET /v1/payouts/{payout_id} e POST /v1/payouts/{payout_id}/cancel. Aprovar saques e gerenciar endereços de saque são ações do painel.
• POST /v1/public/checkout-sessions/{id}/processor-invoice para checkouts live processados pela Bitcart, e um objeto processor anulável nas intenções de pagamento e nas sessões de checkout públicas.
• Webhooks payout.requested, payout.approved, payout.rejected, payout.canceled, payout.sent, payout.completed e payout.failed.
• Escopos de chave de API balances:read, payouts:read e payouts:write; tipos de divergência custody_uncredited e payout_attention.
• Códigos de erro live_processing_unavailable, allowed_networks_unsupported (pagamentos live oferecem todos os ativos que a plataforma aceita), payouts_live_only e payouts_unavailable.

2026-10-01 — versão inicial da API

• Intenções de pagamento, sessões de checkout hospedado, faturas e links de pagamento.
• Cotações imutáveis com a política de arredondamento ceil_to_asset_base_unit.
• Carteiras somente de observação (xpub) com derivação de endereço por intenção e provas de titularidade.
• Máquina de estados central com tratamento de underpaid, overpaid, late_payment, reorged e manual_review.
• Webhooks assinados (HMAC-SHA256, rotação com assinaturas duplas), novas tentativas com backoff, dead letters e nova tentativa manual.
• Divergências de conciliação, relatórios de pagamentos (CSV/JSON), uso para cobrança e log de auditoria.
• SDKs: TypeScript, helpers para React, verificador de webhooks, Python e Go.