post https://backend.sa.amwal.tech/payment_links//create
Create In-Store Payment Links
Generate payment links optimized for in-store transactions—including POS systems, retail checkout, restaurant orders, and immediate payment processing. Perfect for businesses with physical locations that require real-time Installment flow.
Environment Selection
Use the optional X-Amwal-Key header to specify the environment:
- Sandbox testing:
X-Amwal-Key: sandbox-amwal-xxx - Production:
X-Amwal-Key: prod-amwal-xxx(or omit the header to default to production)
Typical In-Store Flow
- Cashier scans items and creates a payment link via POS integration
- Customer sees QR code on terminal screen or receives SMS
- Customer scans QR code with mobile banking app
- Payment processes immediately with real-time feedback
- Receipt generated automatically and/or sent via SMS
- POS system receives webhook notification for transaction completion
Best Practices for In-Store Payments
- Use short expiry times (5–30 minutes) with
auto_expire_minutes - Include
terminal_idandcashier_idfor audit trails - Enable real-time webhooks for immediate POS updates
- Use QR codes for customer scanning convenience
- Keep titles concise for terminal display limitations