Skip to main content
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