Handle the Result

After the customer completes checkout, HesabPay can redirect the browser to your configured success or failure URL.

Redirects

Use redirects to show a customer-facing result page:

• redirect_success_url: customer sees confirmation.
• redirect_failure_url: customer sees failure instructions.

Redirects are not the final source of truth because browser navigation is not guaranteed.

Webhooks

Use webhooks to update your backend systems:

• Mark orders as paid.
• Release digital products.
• Notify warehouse or fulfillment systems.
• Reconcile transaction records.
• Handle failed payments.

Recommended pattern

1. Show a pending order state after the customer returns from checkout.
2. Wait for a verified webhook before fulfilling the order.
3. Make webhook handling idempotent so retries do not duplicate fulfillment.