--- updatedAt: 2026-08-26T20:41:39.000Z agentTools: projectIndex: https://docs.asaas.com/llms.txt --- # FAQ do Asaas Checkout Consulte respostas rápidas sobre configuração, pagamento, expiração, redirecionamento e acompanhamento do Checkout. Para implementar um fluxo específico, siga os guias indicados em cada resposta. ## Quais formas de pagamento estão disponíveis? O Checkout aceita: * `PIX`; * `CREDIT_CARD`. Você pode informar uma ou ambas em `billingTypes`. Para escolher o fluxo, consulte [Asaas Checkout](https://docs.asaas.com/docs/checkout-asaas). ## Quais tipos de cobrança podem ser criados? O campo `chargeTypes` aceita: | Valor | Uso | | ------------- | --------------------- | | `DETACHED` | Pagamento avulso | | `INSTALLMENT` | Pagamento parcelado | | `RECURRENT` | Assinatura recorrente | `INSTALLMENT` exige a configuração de `installment` e `RECURRENT` exige `subscription`. [Consulte o endpoint Criar novo checkout](https://docs.asaas.com/reference/criar-novo-checkout). ## Criar o Checkout significa que o pagamento foi confirmado? Não. A criação inicia a jornada de pagamento. O resultado financeiro ocorre depois da ação do pagador. Utilize `CHECKOUT_PAID` para identificar quando o Checkout foi pago. [Consulte os Eventos para Checkout](https://docs.asaas.com/docs/eventos-para-checkout). ## Quais estados um Checkout pode assumir? O Checkout pode ficar nos seguintes estados: | Status | Significado | | ---------- | ------------------------- | | `ACTIVE` | Disponível para pagamento | | `PAID` | Pago | | `CANCELED` | Cancelado | | `EXPIRED` | Expirado | Prefira Webhooks para reagir às alterações de estado em vez de consultar a API continuamente. ## `successUrl` confirma que o pagamento foi aprovado? Não. `successUrl`, `cancelUrl` e `expiredUrl` controlam o redirecionamento do navegador. Utilize Webhooks para confirmar o resultado do Checkout. Não marque um pedido como pago apenas porque o pagador chegou à `successUrl`. [Consulte Link do checkout e redirecionamento do cliente](https://docs.asaas.com/docs/link-do-checkout-e-redirecionamento-do-cliente). ## Como obtenho o link que será enviado ao pagador? Após criar o Checkout, utilize o `id` retornado pela API para disponibilizar a página de pagamento. A montagem e o redirecionamento estão detalhados em [Link do checkout e redirecionamento do cliente](https://docs.asaas.com/docs/link-do-checkout-e-redirecionamento-do-cliente). ## Por quanto tempo o Checkout fica disponível? O campo `minutesToExpire` define o período de validade e aceita valores entre **10 e 1440 minutos**. Após a expiração, o Checkout não fica mais disponível para pagamento. Se o pagador ainda precisar concluir a compra, crie um novo Checkout. ## Posso cancelar um Checkout antes da expiração? Sim. Utilize: ```http POST /v3/checkouts/{id}/cancel ``` Após o cancelamento, acompanhe `CHECKOUT_CANCELED` para sincronizar sua aplicação. [Consulte o endpoint Cancelar um checkout](https://docs.asaas.com/reference/cancelar-um-checkout). ## Posso enviar os dados do cliente preenchidos? Sim. Envie `customerData` quando sua aplicação já possuir os dados do pagador. Se essas informações não forem enviadas, o pagador poderá preenchê-las durante o Checkout. [Consulte Como informar os dados do cliente](https://docs.asaas.com/docs/como-informar-os-dados-do-cliente). ## Posso oferecer parcelamento no cartão de crédito? Sim. Utilize `INSTALLMENT` em `chargeTypes` e configure o objeto `installment`. `maxInstallmentCount` aceita valores entre **1 e 21**. [Consulte Checkout para Cartão de Crédito](https://docs.asaas.com/docs/checkout-para-cart%C3%A3o-de-cr%C3%A9dito). ## Posso criar uma assinatura pelo Checkout? Sim. Utilize `RECURRENT` em `chargeTypes` e envie o objeto `subscription` com as regras da recorrência. [Consulte Checkout com Assinatura](https://docs.asaas.com/docs/checkout-com-assinatura-recorrente). ## Posso utilizar Split de Pagamento? Sim. Inclua `splits` na criação do Checkout para distribuir valores entre contas Asaas. As regras de valor fixo, percentual e liquidação estão detalhadas em [Checkout com Split de Pagamento](https://docs.asaas.com/docs/checkout-com-split-de-pagamento). ## Como relaciono o Checkout ao pedido no meu sistema? Utilize `externalReference` para armazenar o identificador do pedido, carrinho ou contrato da sua aplicação. O campo aceita até **200 caracteres**. Mantenha também o `id` do Checkout associado ao mesmo registro para facilitar conciliação e suporte. ## Um mesmo Webhook pode ser recebido mais de uma vez? Sim. Os Webhooks utilizam entrega **at least once**, portanto o mesmo evento pode ser reenviado. Implemente idempotência utilizando o `id` do evento para evitar processamentos duplicados. Os principais eventos do Checkout são: * `CHECKOUT_CREATED`; * `CHECKOUT_PAID`; * `CHECKOUT_CANCELED`; * `CHECKOUT_EXPIRED`. [Consulte os Eventos para Checkout](https://docs.asaas.com/docs/eventos-para-checkout). ## Onde consultar erros na criação do Checkout? Erros de validação podem retornar `HTTP 400` e problemas de autenticação podem retornar `HTTP 401`. Consulte [Erros comuns do Asaas Checkout](https://docs.asaas.com/docs/erros-comuns-e-boas-pr%C3%A1ticas) para revisar campos obrigatórios, autenticação, callbacks, expiração e conciliação. ## Próximos passos * [Implemente o Asaas Checkout](https://docs.asaas.com/docs/introdu%C3%A7%C3%A3o-1) * [Consulte o endpoint Criar novo checkout](https://docs.asaas.com/reference/criar-novo-checkout) * [Configure o link e o redirecionamento](https://docs.asaas.com/docs/link-do-checkout-e-redirecionamento-do-cliente) * [Acompanhe os Eventos para Checkout](https://docs.asaas.com/docs/eventos-para-checkout) * [Consulte erros comuns do Checkout](https://docs.asaas.com/docs/erros-comuns-e-boas-pr%C3%A1ticas) # Sibling pages * [Introdução - Asaas Checkout](https://docs.asaas.com/docs/introdução-1.md) * [Como informar os dados do cliente](https://docs.asaas.com/docs/como-informar-os-dados-do-cliente.md) * [Checkout com dados do cliente preenchidos](https://docs.asaas.com/docs/checkout-com-dados-do-cliente-preenchidos.md) * [Checkout para Pix](https://docs.asaas.com/docs/checkout-para-pix.md) * [Checkout para Cartão de Crédito](https://docs.asaas.com/docs/checkout-para-cartão-de-crédito.md) * [Checkout com Assinatura (recorrente)](https://docs.asaas.com/docs/checkout-com-assinatura-recorrente.md) * [Checkout com Split de Pagamento](https://docs.asaas.com/docs/checkout-com-split-de-pagamento.md) * [Link do checkout e redirecionamento do cliente](https://docs.asaas.com/docs/link-do-checkout-e-redirecionamento-do-cliente.md) * [Erros comuns e boas práticas](https://docs.asaas.com/docs/erros-comuns-e-boas-práticas.md)