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.
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.
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.
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?
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.
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.
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:
POST /v3/checkouts/{id}/cancelApós o cancelamento, acompanhe CHECKOUT_CANCELED para sincronizar sua aplicação.
Consulte o endpoint 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.
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.
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.
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.
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.
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 para revisar campos obrigatórios, autenticação, callbacks, expiração e conciliação.
Próximos passos
Updated 20 days ago