Use esta página quando estiver substituindo um fluxo legado de cartão no navegador.
A tokenização legada via POST /v2/payment_token/:public_token é descontinuada em 1º de agosto de 2026 às 00:00 BRT (03:00 UTC). Após o corte, a rota retorna 410 LEGACY_TOKENIZATION_RETIRED; tokens existentes, cartões salvos e assinaturas mantêm o ciclo de vida atual.
O que muda
- fluxo de tokenização bruta no navegador -> campo hospedado do Payment Element
- orquestração antiga no navegador ->
elements.submit(...)
- plumbing manual de challenge -> autenticação de cartão tratada dentro de
elements.submit(...)
- retry manual após uma autenticação interrompida ->
elements.resume({ transactionId })
- contrato instável no navegador -> contrato estável no back-end com
POST /v2/transactions
O que manter estável durante a migração
- mantenha estável sua rota de transaction no back-end
- mantenha inalterada a persistência de
external_ref, ID da transaction e requestId
- mantenha inalterada a lógica de webhook e reconciliação
- migre uma superfície de checkout por vez
Exemplo de contrato do back-end
Leia a seguir