What is the difference between callback_url and return_url?
callback_url is the address on your server that receives webhooks; return_url is where the buyer's browser goes after paying. The first tells your system the money arrived, the second only brings the buyer back to your store.
This page was checked against the API code as of October 16, 2026.
How do they differ in detail?#
| callback_url | return_url | |
|---|---|---|
| Called by | SekaliPay's server | The buyer's browser |
| When | When the payment is confirmed paid | When the buyer is on a payment page that is paid, failed, or expired |
| Signed | Yes, X-Signature | No |
| Can mark an order paid | Yes, after verification | No |
Which URL is used?#
- The value in the
POST /paymentrequest. - The default under API Settings, Webhook & Return URL.
- If both are empty: no webhook is sent, and the buyer is sent to a SekaliPay page.
What does the buyer see after paying?#
The payment page shows a paid confirmation, then redirects the browser automatically after 5 seconds to return_url with three added parameters:
https://toko-anda.id/checkout/selesai?invoice=SPY1791446400K3QZ&status=success&merchant_ref_id=ORDER-2026-00184If your URL already has a query string, the parameters are appended with &. Without a return URL, the buyer is sent to a SekaliPay page after 3 seconds. Failed and expired pages do not redirect automatically; the buyer gets a button back to return_url without parameters.
status=success is not proof of payment
Anyone can open your URL with that parameter. Mark orders paid only from a verified webhook or a status check.
Ready to use your own keys?
Sign in to the merchant dashboard to copy your API key and secret key, set the access mode and webhook URL, and download a Postman collection with your account's keys.
Sign in to the dashboard