Apa beda callback_url dan return_url?
callback_url adalah alamat server Anda yang menerima webhook; return_url adalah halaman tujuan browser pembeli setelah membayar. Yang pertama memberi tahu sistem Anda bahwa uang sudah masuk, yang kedua hanya membawa pembeli kembali ke toko Anda.
Isi halaman ini dicocokkan dengan kode API per 16 Oktober 2026.
Apa bedanya secara rinci?#
| callback_url | return_url | |
|---|---|---|
| Dipanggil oleh | Server SekaliPay | Browser pembeli |
| Kapan | Saat pembayaran terkonfirmasi lunas | Saat pembeli berada di halaman bayar yang sudah lunas, gagal, atau kedaluwarsa |
| Bertanda tangan | Ya, X-Signature | Tidak |
| Boleh dipakai menandai lunas | Ya, setelah diverifikasi | Tidak |
URL mana yang dipakai?#
- Nilai di permintaan
POST /payment. - Nilai bawaan di Pengaturan API, Webhook & Return URL.
- Bila keduanya kosong: webhook tidak dikirim, dan pembeli diarahkan ke halaman SekaliPay.
Apa yang dilihat pembeli setelah membayar?#
Halaman bayar menampilkan konfirmasi lunas, lalu mengalihkan browser otomatis setelah 5 detik ke return_url dengan tiga parameter tambahan:
https://toko-anda.id/checkout/selesai?invoice=SPY1791446400K3QZ&status=success&merchant_ref_id=ORDER-2026-00184Bila URL Anda sudah punya query string, parameternya ditambahkan dengan &. Tanpa return URL, pembeli dialihkan ke halaman SekaliPay setelah 3 detik. Di halaman gagal atau kedaluwarsa tidak ada pengalihan otomatis; pembeli mendapat tombol kembali ke return_url tanpa parameter.
status=success bukan bukti bayar
Siapa pun bisa membuka URL Anda dengan parameter itu. Tandai pesanan lunas hanya dari webhook yang terverifikasi atau dari cek status.
Siap memakai kunci Anda sendiri?
Masuk ke dasbor merchant untuk mengambil API key dan secret key, mengatur mode akses dan URL webhook, serta mengunduh koleksi Postman berisi kunci akun Anda.
Masuk ke dasbor