Asaas Checkout

Crie e integre uma página de pagamento hospedada pelo Asaas com Pix, cartão, assinaturas, parcelamentos, callbacks e Webhooks.

Conheça o Asaas Checkout

O Asaas Checkout disponibiliza uma página hospedada para o pagador concluir uma compra com Pix ou cartão de crédito.

Utilize quando sua aplicação já possui o fluxo de compra, mas não quer implementar a interface de pagamento.

Quando utilizar

Utilize o Asaas Checkout quando precisar:

aceitar Pix, cartão de crédito ou ambos;
criar pagamentos avulsos, parcelados ou recorrentes;
redirecionar o pagador para uma página hospedada pelo Asaas;
retornar o pagador à sua aplicação após conclusão, cancelamento ou expiração;
utilizar Split de Pagamentos;
preencher previamente os dados do cliente, quando disponíveis.

Escolha o fluxo

Necessidade	Conteúdo
Receber uma venda avulsa via Pix	Checkout para Pix
Receber via cartão de crédito, à vista ou parcelado	Checkout para Cartão de Crédito
Criar uma assinatura recorrente	Checkout com Assinatura
Distribuir o pagamento entre contas	Checkout com Split de Pagamento
Preencher ou reutilizar dados do cliente	Como informar os dados do cliente
Montar a URL e configurar o retorno do pagador	Link do checkout e redirecionamento do cliente

Como o Checkout é configurado

Duas configurações definem o fluxo principal:

Campo	Valores	Define
`billingTypes`	`PIX`, `CREDIT_CARD`	Formas de pagamento disponíveis
`chargeTypes`	`DETACHED`, `INSTALLMENT`, `RECURRENT`	Tipo de cobrança criada

Alguns recursos exigem configurações adicionais:

subscription para RECURRENT;
installment para INSTALLMENT;
splits quando houver Split de Pagamentos;
customer ou customerData quando sua aplicação quiser preencher os dados do pagador;
callback para definir as URLs de retorno;
minutesToExpire para controlar a validade do Checkout.

Os campos, limites e dependências completos estão na referência de criação do Checkout.

Como funciona

%%{init: {"flowchart": {"nodeSpacing": 28,"rankSpacing": 32,"diagramPadding": 8,"padding": 10}}}%%
flowchart TD
    A["Criar o pedido"] --> B["Criar o Checkout"]
    B --> C["Armazenar o ID"]
    C --> D["Montar o link"]
    D --> E["Redirecionar o pagador"]
    E --> F["Pagador conclui a jornada"]
    F --> G["Receber o Webhook"]
    G --> H["Atualizar o pedido"]

    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,G validacao
    class H sucesso

    linkStyle default stroke:#94A3B8,stroke-width:2px

A criação retorna o id do Checkout. Utilize esse identificador para montar a URL que será disponibilizada ao pagador.

Consulte como montar o link do Checkout.

Acompanhe o resultado por Webhook

A criação do Checkout não confirma o pagamento.

Acompanhe o ciclo de vida pelos eventos:

CHECKOUT_CREATED;
CHECKOUT_PAID;
CHECKOUT_CANCELED;
CHECKOUT_EXPIRED.

Consulte os Eventos para Checkout.

👍
Recomendado
Utilize Webhooks como mecanismo principal para sincronizar o Checkout com seu pedido.
As URLs de callback controlam a navegação do pagador, mas não substituem a confirmação assíncrona por Webhook.

Os Webhooks utilizam entrega at least once. Processe os eventos de forma idempotente utilizando o id do evento.

Próximos passos

Defina um tempo de expiração compatível com a jornada do pagador.
Teste primeiro em Sandbox antes de liberar o checkout em produção.

Conteúdos relacionados

Updated 1 day ago

Did this page help you?