In-Store Checkout (POS) Flow
Create an installment payment link at the physical point of sale, generate a dynamic QR code on the cashier screen, and complete the sale only after Amwal confirms the transaction.
POS Payment Sequence
Rendering diagram...
Key POS Guidelines
- Keep POS Sale Pending: Creating a link only initiates the checkout flow. Never mark the sale as paid until a verified
status: "success"response is received. - Set
singleUse: true: Ensure payment links cannot be paid multiple times. - Short Expiry Duration: For in-store checkout counters, set short expiry timestamps (e.g. 15–30 minutes) via the
selectedDateparameter. - Idempotent Webhook Processing: Ensure POS webhook handlers do not duplicate thermal receipts or decrement stock multiple times.
Confirming POS Results
Retrieve the transaction details using the transaction_id received from the webhook or callback:
GET /installment/transaction/{transaction_id}/details
Authorization: your_secret_key_here| Amwal Transaction Status | Action Required on POS |
|---|---|
success | Mark sale as paid, print receipt, and release merchandise to customer. |
fail | Display failure reason (e.g. Insufficient funds or 3DS failed) and prompt customer for alternate card. |
| Any other status | Keep sale in pending state. Do not release goods. |