Novidades

4 de novembro de 2026: sem limite fixo de requisições por minutoCopiar link da seção

• A documentação deixa de publicar limites fixos de requisições por minuto: abertura de sessões do SDK de campos, emissão de sessões 3DS, tokenização e rotas de saque. Uma resposta 429 continua possível em excesso momentâneo: trate repetindo com espera crescente e respeitando Retry-After quando presente. Veja Erros.
• As regras de uso não mudam: a sessão do SDK vale 1 hora e aceita 5 tentativas, o token tok_… vale 1 hora e serve para uma cobrança, a sessão 3DS vale 30 minutos, e os limites de saque por valor e quantidade da sua conta continuam valendo.

3 de novembro de 2026: saldo, sandbox completo e várias lojas no 3DSCopiar link da seção

Novas rotas e páginas

• Saldo. Nova rota GET /api/v1/balance?accountId=…, com a permissão balance:read: saldo da conta por tipo (Available, Blocked, PendingSettlement, Reserved, PendingWithdrawal), em centavos de BRL ou USD. Guia: Consulte o saldo.
• Várias lojas e domínios no 3DS. Uma conta pode ter várias origens HTTPS cadastradas, e a cobrança informa a loja em paymentMethodOptions.creditCard.threeDs.checkoutOrigin. Novos códigos 400 three_ds_checkout_origin_invalid e 400 three_ds_checkout_origin_required. Guia: Use o 3DS em várias lojas e domínios.
• Contas, chaves e identificadores. Nova página que explica a separação entre operação doméstica e offshore e a diferença entre accountId, o número interno da conta e o accountNumber do extrato: Contas, chaves e identificadores.

Sandbox

• Saldo, saques e extrato agora existem no sandbox, com o mesmo contrato da produção. O Pix de saída dos saques é simulado. Veja Ambientes.
• O SDK de campos de cartão está no sandbox, com habilitação por conta.
• Nas rotas de saldo, saques e extrato, o sandbox confere a permissão da chave e a lista de IPs como a produção.

Mudanças de contrato

• Endereço internacional. Em endereços fora do Brasil, zipCode pode ser omitido ou vazio, e códigos postais com letras, espaços e hífens são preservados. No Brasil, o CEP continua obrigatório. A regra vale também para shipping.address. Veja Dados do comprador.
• Saque e extrato em centavos. O pedido e a consulta de saque e os três valores do extrato seguem o contrato em centavos inteiros. Decimais e texto no amount do saque são recusados com 400, sem arredondamento. Integrações que enviavam reais precisam converter. Em 3 de novembro de 2026, o sandbox já opera assim; em produção, confirme com a equipe de integração antes do primeiro saque.

Esclarecimentos

• Pix pago depois do vencimento. Uma cobrança cancelada por vencimento ainda pode virar Succeeded até 72 horas depois de expiresAt. Cancelamentos por outro motivo e cobranças estornadas não são reabertos. Veja Expiração e pagamento tardio.
• Token do SDK × cartão salvo. O tok_… do SDK de campos é temporário e não é um cartão salvo; o cardTokenUid que aparece nas respostas e nos webhooks não serve para cobrar de novo. O cartão salvo continua sendo o ctok_….
• Lista de IPs. Vale o IP público de saída do seu servidor; X-Forwarded-For e X-Client-Ip enviados pelo cliente não escolhem a origem. Veja Autenticação, que agora lista a permissão de cada operação.

2 de novembro de 2026: SDK de campos de cartãoCopiar link da seção

• Novo guia Capture o cartão com o SDK de campos e a referência do SDK: o comprador digita o cartão em campos seguros da Accelerazione e a sua integração cobra com um token tok_…, sem número nem código de segurança passarem pela sua página ou pelo seu servidor. Disponível em produção, com habilitação por conta.
• Nova operação na referência: POST /v1/card-token-sessions.
• Novos códigos na cobrança com token: 422 card_token_consumed e 422 card_token_expired.

2 de novembro de 2026: documentação onlineCopiar link da seção

A documentação deixa de ser um PDF e passa a ser este site, com versão em Markdown de cada página, llms.txt e especificação OpenAPI 3.1. O conteúdo da edição 1.1 do Guia de integração em sandbox (8 de setembro de 2026) foi revisado contra o comportamento atual da API.

Novo nesta edição:

• Saques e saldo. Documentação completa de POST /api/v1/withdrawals, consulta, listagem, cancelamento e do extrato com saldo.
• Referência da API gerada da especificação OpenAPI, publicada em /openapi.yaml.
• Catálogo de eventos com o formato completo de cada webhook, incluindo payment_intent.charged_back.
• Exemplos de verificação HMAC em Node.js, Python, C# e Go, com vetor de teste.

Esclarecimentos em relação ao PDF:

• Uma recusa de cartão sem 3DS chega só na resposta da criação, com status: "Failed"; não há webhook payment_intent.failed para ela.
• A cobrança com 3DS deve ser criada depois que a coleta do dispositivo terminar.
• card_3ds.processing não encerra o desafio: não remova o iframe ao recebê-lo. A mensagem traz detail.reason (awaiting_outcome, ui_timeout ou tail_timeout).
• Na tokenização, bin tem sempre seis dígitos; um mesmo cartão enviado sem customerId devolve o mesmo token; card_token_not_usable e card_expired não são devolvidos pela rota de tokenização, e sim na cobrança.
• Webhooks só contam como entregues com HTTP 200 exato, com até três tentativas.
• A pré-análise do Pix parcelado responde 422 merchant_not_eligible ou 502 pagaleve_pre_analysis_failed em falhas.