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_RETORNADO

Exemplo:

https://asaas.com/checkoutSession/show?id=c7b1c696-b27b-4d3d-80b9-d1c018e387f8

Redirecione o pagador para essa URL ou compartilhe o link pelo canal utilizado na sua jornada.

Tela de checkout exibida ao cliente

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"
  }
}
CampoRedirecionamento
successUrlJornada concluída
cancelUrlJornada cancelada
expiredUrlCheckout expirado
⚠️

Atenção

O callback controla o redirecionamento do navegador.

Não utilize successUrl como 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.

Tela de checkout com dados do cliente preenchidos automaticamente

A configuração dos dados do pagador está detalhada em Como informar os dados do cliente.

Próximos passos


Did this page help you?