DocsIntegrations

Callbacks & return URLs

Each payment carries two URLs:

URLPurpose
backend_return_urlServer-to-server. We POST the final result here. Treat this as the source of truth and finalize the order on it.
frontend_return_urlBrowser redirect. Where the customer lands after checkout. Do not finalize orders here — it can be skipped if the customer closes the tab.

Both support {gateway} and {txn_id} placeholders, which we substitute when calling them.

Verify before trusting

Always verify the callback signature (same HMAC scheme as requests) and cross-check status with Inquiry before fulfilling an order. placeholder — confirm exact callback payload + signature header