Link do checkout e redirecionamento do cliente
Disponibilize o link do Checkout e configure o redirecionamento
Após criar o Checkout, use o id retornado para montar a URL que será acessada pelo pagador.
Configure também as URLs de callback para definir para onde ele será direcionado após concluir, cancelar ou deixar o Checkout expirar.
Como funciona
%%{init: {"flowchart": {"nodeSpacing": 28,"rankSpacing": 32,"diagramPadding": 8,"padding": 10}}}%%
flowchart TD
A["Criar o Checkout"] --> B["Receber o ID"]
B --> C["Montar a URL"]
C --> D["Redirecionar o pagador"]
D --> E["Pagador conclui a jornada"]
E --> F["Executar o callback"]
F --> G["Receber o Webhook"]
classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px,font-size:17px
classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px,font-size:17px
classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px,font-size:17px
class A inicio
class B,C,D,E,F validacao
class G sucesso
linkStyle default stroke:#94A3B8,stroke-width:2px
1. Armazene o ID do Checkout
Uma criação bem-sucedida retorna o identificador do Checkout:
{
"id": "c7b1c696-b27b-4d3d-80b9-d1c018e387f8"
}Armazene esse id junto ao pedido correspondente na sua aplicação.
2. Monte a URL
Substitua ID_RETORNADO pelo identificador recebido:
https://asaas.com/checkoutSession/show?id=ID_RETORNADOExemplo:
https://asaas.com/checkoutSession/show?id=c7b1c696-b27b-4d3d-80b9-d1c018e387f8Redirecione o pagador para essa URL ou compartilhe o link pelo canal utilizado na sua jornada.

A página será exibida de acordo com as configurações enviadas na criação do Checkout.
3. Configure o redirecionamento
Informe as URLs de retorno no objeto callback ao criar o Checkout:
{
"callback": {
"successUrl": "https://meusite.com/sucesso",
"cancelUrl": "https://meusite.com/cancelado",
"expiredUrl": "https://meusite.com/expirado"
}
}| Campo | Redirecionamento |
|---|---|
successUrl | Jornada concluída |
cancelUrl | Jornada cancelada |
expiredUrl | Checkout expirado |
AtençãoO callback controla o redirecionamento do navegador.
Não utilize
successUrlcomo confirmação financeira. Acompanhe o resultado do Checkout por Webhook.
Consulte os Eventos para Checkout.
Dados do cliente
Se customerData for enviado na criação, os dados correspondentes serão apresentados preenchidos no Checkout.

A configuração dos dados do pagador está detalhada em Como informar os dados do cliente.
Próximos passos
Updated 6 days ago
