Checkout iPag

Modificado em Seg, 20 Out na (o) 9:02 AM

O Checkout iPag é um recurso que permite a criação automática de uma página de pagamento pronta, sem que o desenvolvedor precise construir manualmente a tela de checkout.
Por meio da API, é possível gerar uma URL única para cada venda, redirecionando o cliente para uma página segura do iPag, onde ele pode concluir o pagamento por cartão, PIX ou boleto.

Como funciona o processo

O sistema do estabelecimento realiza uma chamada à API Criar Checkout, informando os dados da compra (valor, descrição, cliente, formas de pagamento, etc.).
A API retorna uma URL do checkout, que redireciona o cliente para uma página de pagamento gerenciada pelo iPag.
O cliente finaliza o pagamento diretamente nessa página.
Após a conclusão, o iPag registra a transação e permite a consulta via API (como no endpoint de “Listar Transações” ).
Dessa forma, o pagamento realizado gera automaticamente uma transação dentro do sistema, sem a necessidade de um link de pagamento manual.

Observação importante

Quando ocorre um pagamento pelo checkout criado, ele não gera exatamente um link de pagamento tradicional.
Isso acontece porque, ao realizar a compra por meio do checkout, o pagamento gera diretamente uma transação no sistema.
Por esse motivo:

Não são exibidos novos links de pagamento na aba correspondente do menu;
Devem ser cadastrados webhooks de transações, já que o processo é tratado como uma transação e não como um link de pagamento.

Webhooks necessários para receber callbacks

Para configurar os webhooks acesse:

https://suporteipag.freshdesk.com/a/solutions/articles/35000295162

https://developers.ipag.com.br/pt-br/webhook?id=webhook-

Para que o sistema receba corretamente os retornos automáticos (callbacks) dos pagamentos realizados via Checkout iPag, é necessário configurar os webhooks de transações na conta do estabelecimento.

Abaixo estão os principais eventos disponíveis, conforme a documentação oficial da iPag:

Evento	Descrição
TransactionCreated	Transação criada.
TransactionWaitingPayment	Transação aguardando pagamento (ex.: boleto).
TransactionInAnalysis	Transação em análise.
TransactionCanceled	Transação cancelada com sucesso.
TransactionPreAuthorized	Transação pré-autorizada com sucesso.
TransactionCaptured	Transação capturada com sucesso.
TransactionDenied	Transação recusada pela adquirente.
TransactionDisputed	Transação sofreu disputa do pagador/cliente.
TransactionChargedback	Transação estornada, valor devolvido ao cliente.

Obs: Para validar todos os eventos que podem ser cadastrados no webhook acesse https://developers.ipag.com.br/pt-br/webhook?id=a%c3%a7%c3%b5es-de-eventos