This document describes how to handle checkout flows, including callbacks, return, and cancellation endpoints.
| URL Type | Method | Payload Type | Notes |
|---|
callbackUrl | POST | JSON | Asynchronous notification of transaction status. Respond with HTTP 200. |
returnUrl | POST | Form URL Encoded | Redirect user after payment. Include secure hash as query string. |
cancelUrl | POST | Optional | Redirect user if transaction is canceled. |
Security:
Secure your returnUrl with a special hash or signature passed as a query string to validate the integrity of the request.https://checkout.merchant.com/return?hash=abcd1234
Usage:
Contains the same transaction data as the callbackUrl, allowing your system to confirm checkout details.
Modified at 2026-01-30 08:37:26