> ## Documentation Index
> Fetch the complete documentation index at: https://developer.pagou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Migration from WebSDK

> Migre do fluxo legado de cartão com WebSDK para Payment Element com baixo risco operacional e contrato estável de back-end.

Use esta página quando estiver substituindo um fluxo legado de cartão no navegador.

## 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

```json theme={null}
{
  "external_ref": "order_2001",
  "amount": 2490,
  "currency": "BRL",
  "method": "credit_card",
  "token": "pgct_token_from_browser"
}
```

## Leia a seguir

* [Visão geral](/pt/frontend/payment-element/overview)
* [Início rápido](/pt/frontend/payment-element/quickstart)
* [Aceitar um pagamento](/pt/frontend/payment-element/accept-a-payment)