Online Checkout Flow

Integrate Amwal Bank Installments into your web checkout using the Installment Links API. This flow covers generating a payment link, redirecting the shopper, and reconciling order results through both callbacks and signed webhooks.

Online Checkout Practice

Implementation Steps

1. Add Amwal as a Payment Method: Add Amwal to your checkout page's list of available payment methods.
2. Generate Installment Link via API: Call POST /payment_links/{store_id}/create with order amount, currency, customer phone/email, and callback URL.
3. Redirect or Share: Direct the shopper to Amwal's secure hosted payment URL.
4. Complete Payment: The customer selects their preferred installment tenure (3, 6, 12, 24 months) and completes 3DS authentication.
5. Callback URL: Amwal redirects the customer back to your callback_url with the transaction_id parameter.
6. Webhook Reconciliation: Amwal delivers an asynchronous, RSA-PSS signed order.success notification to your backend webhook endpoint.
7. Order Confirmation: Mark the order as paid in your database and fulfill goods.

Related Endpoints