When validation is needed
For Argentina, if an inbound transfer is not detected automatically within about 30 seconds, the payer can tap “I already paid” and upload a receipt (JPEG, PNG, WebP, or PDF, max 10 MB). The checkout moves toawaiting_manual_review.
You receive a checkout.awaiting_manual_review webhook. A badge on Validate in the dashboard shows how many sessions need attention.
Open the validate view
- Go to Checkouts (
/app/checkouts). - Click Validate (top right), or open
/app/checkouts/validate.
awaiting_manual_review with date, account, amount, payer, and a link to the receipt.
Approve a payment
- Click Review on a row.
- Confirm amount, payer, and receipt image.
- Click Approve.
completed and checkout.completed webhook fires.
Reject a payment
- Open Review, then Reject.
- Enter a reason (required).
- Confirm rejection.
rejected; payer may see rejection on the hosted page if they return. Webhook: checkout.rejected.
Receipt download (API)
GET /api/v1/checkouts/{id}/receipt returns a short-lived signed URL for the uploaded file (merchant token with access to the checkout).
Permissions
- Merchants (
USER) can validate their own checkouts. - Admins need validate checkouts permission (or super admin).
Related
- Create checkouts
- Reconcile checkouts — When no receipt was uploaded but money arrived
- Introduction — Status reference

