Notifikasi Callback

Saat pay-in / pay-out mencapai status akhir, Smilepayz mengirim HTTP POST ke URL Anda.

Hanya order API

Callback hanya untuk order lewat Pay-in / Pay-out API. Order Payment Link di portal tidak dikirim.

Alur: set URL → verifikasi & update order → balas SUCCESS.

1. Konfigurasi callback URL

1. Login Merchant Portal. Toggle Sandbox (atau Production) di atas.
2. Configuration → API Setting → API Notify Address:
   • Payin — URL notifikasi pay-in
   • Withdraw — URL notifikasi pay-out
3. Klik Save.

Sarankan HTTPS (443). URL production / whitelist IP: Info Integrasi. Gagal bisa diulang — tangani callback secaraidempotent.

Utamakan `tradeNo` sebagai kunci idempotency

Retry mempertahankan tradeNo yang sama. Di Meksiko (dan region serupa), sub-order pay-in dapat berbagi orderNo order utama tetapi masing-masing punya tradeNo sendiri — gunakan tradeNo untuk idempotency tingkat transaksi, jangan hanya orderNo. Lihat Mexico Pay-in · Sub-order transaction & callback.

2. Verifikasi tanda tangan (bukan formula request)

Verifikasi sebelum update order. Aturan, Platform Public Key, dan contoh kode ada di halaman terpisah (beda dari formula request):

Lihat jugaCallback Signature→

3. Body & respons

Body JSON — field umum: orderNo, tradeNo, merchantId, status, money, transactionTime (yyyy-MM-ddTHH:mm:ss, timezone region order). Field lengkap: Pay-in / Pay-out → Notification/Callback per region.

Setelah verifikasi + simpan, HTTP 200 harus teks polos:

SUCCESS

Penting

Setelah trim harus tepat SUCCESS. Jangan balas JSON / HTML, atau kami retry.

Tes sandbox

1. Buat pay-in via API (paymentMethod tidak boleh kosong, mis. QRIS di Indonesia).
2. Portal Pay-in Order → Operate → Set Callback (sukses / gagal).
3. Cek Callback Status.

Production mengirim otomatis saat status akhir — tanpa Set Callback.

Pemecahan masalah

Masalah	Cek
Tidak terima	URL sudah Save? Firewall / sertifikat HTTPS
Verifikasi gagal	Lihat Callback Signature
Set Callback tidak jalan	Harus order via API; paymentMethod tidak kosong
Terus diulang	SUCCESS tepat setelah trim?