Create checkouts

​

Dashboard

1. Open Checkouts in the sidebar (/app/checkouts).
2. Review the stats row and recent sessions on the overview.
3. In Create checkout, choose country, account (optional—HG.Cash picks an eligible operative account if omitted), amount, and success URL.
4. Click Create checkout. Copy the checkout link from the success panel and send it to your payer.

​

Country notes (dashboard)

​

API

{
  "country": "AR",
  "amount": "1500.00",
  "successUrl": "https://merchant.example/success"
}

​

Argentina (AR)

• Response includes accountDisplay (alias, CVU/CBU, holder).
• Payer completes name, amount, and 8-digit DNI on the hosted page.
• Completion when an inbound transfer matches amount + DNI on the assigned account.

​

Brazil (BR)

• payer.name, payer.document (CPF or CNPJ — digits only or formatted), and payer.email required on create.
• Response may include qrCode and pixCopiaECola.

​

Chile (CL)

• paymentMethodId and customer required — see Chile cash-in for payment method listing.

​

Example (Brazil)

curl -X POST https://hg.cash/api/v1/checkouts \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "BR",
    "amount": "100.50",
    "successUrl": "https://merchant.example/success",
    "payer": {
      "name": "Federico Autuori",
      "document": "957.937.532-14",
      "email": "fautuori@gmail.com"
    }
  }'

​

Example (Argentina)

curl -X POST https://hg.cash/api/v1/checkouts \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "AR",
    "amount": "1500.00",
    "successUrl": "https://merchant.example/success",
    "cancelUrl": "https://merchant.example/cancel",
    "webhookUrl": "https://merchant.example/hooks/checkout",
    "metadata": { "orderId": "ORD-42" }
  }'

​

Related

• Introduction — Statuses and webhooks
• Validate payments
• Reconcile checkouts
• API reference → Checkouts → Create checkout session