Skip to main content

​
O que você vai fazer

Checkouts permitem receber pagamentos por uma página de pagamento hospedada sem construir sua própria UI de transferência ou PIX. Você cria uma sessão, compartilha um checkoutUrl com o pagador e a HG.Cash confirma o pagamento automaticamente — ou marca para revisão manual quando necessário. No painel HG.Cash (Checkouts na barra lateral), você pode:
  • Ver estatísticas (criados, concluídos, conversão, valor recebido) e sessões recentes
  • Criar novos checkouts e copiar o link do pagador
  • Validar comprovantes quando o match automático não concluiu (Argentina)
  • Conciliar movimentações bancárias de entrada com um checkout pendente quando o match falhou
Também é possível integrar só pela API REST (POST /api/v1/checkouts e endpoints relacionados). Esquemas interativos ficam em Referência da API → Checkouts.

​
Visão geral por país

Pagadores não fazem login na HG.Cash na página pública. Seu backend (ou o painel) usa o mesmo token Bearer da API que o restante da v1.

​
Status do checkout

​
Webhooks

Quando um checkout muda de estado, a HG.Cash pode enviar webhook CHECKOUT (checkout.completed, checkout.awaiting_manual_review ou checkout.rejected). Configure webhookUrl por checkout na criação ou a URL padrão do usuário. Veja Receber webhooks para assinatura HMAC.

​
Guias nesta seção

​
Antes de começar

  • Acesso a Checkouts no painel (habilitado por usuário; fale com a HG.Cash se não aparecer)
  • Conta receptora operativa para o país (ARS + Urbana em AR, plataforma PIX BRL em BR, PayRetailers CL em CL, BOB em BO). Contas Bloqueada ou Cerrada não podem ser usadas para checkouts BR, CL ou BO e retornam 403 com ACCOUNT_NOT_OPERATIVE.
  • successUrl em toda criação — destino após o sucesso
  • Segredo de assinatura de webhook opcional em Configurações