Callback Notify

Callback notify adalah notifikasi yang dikirim ke notifyUrl milik merchant setelah transaksi diproses.

Callback ini berlaku untuk:

• Transaksi Pay-in (setelah generate transaksi QRIS)
• Transaksi Disbursement (setelah request transfer)

Ringkasan Pengiriman

Item	Nilai
Method	POST
Content-Type	application/json
Tujuan	notifyUrl yang dikirim saat request transaksi

Whitelist IP Server KingsPay

Jika sistem merchant menerapkan IP-based whitelisting pada endpoint notifyUrl, tambahkan IP server KingsPay berikut:

• 172.237.80.251
• 172.237.86.181
• 104.64.211.91
• 104.64.213.171
• 172.236.138.74

Payload Callback Pay-in

{
  "idMerchant": 1,
  "merchantName": "TESTING STORE",
  "merchantTrxId": "D1776936915102936",
  "platformTrxId": "20260423093515686737973",
  "amount": 10000,
  "status": "success",
  "success_at": "2026-04-23 16:37:04.815+07:00",
  "additionalInfo": {
    "rrn": "001137044141",
    "nmid": "ID1026481167827",
    "storeName": "Lumibook Digital Store"
  }
}

Field Payload Pay-in

Field	Tipe	Keterangan
idMerchant	number	ID merchant di sistem
merchantName	string	Nama merchant
merchantTrxId	string	ID transaksi dari merchant
platformTrxId	string	ID transaksi dari platform
amount	number	Nominal transaksi
status	string	Status transaksi
success_at	string	Waktu transaksi berhasil
additionalInfo.rrn	string	Reference Retrieval Number
additionalInfo.nmid	string	National Merchant ID
additionalInfo.storeName	string	Nama toko pada transaksi QRIS

Payload Callback Disbursement

{
  "merchantTrxId": "2026042420291140486107584",
  "platformTrxId": "20260424132917411739651",
  "accountNo": "3324234234",
  "accountName": "JOHN DOE",
  "amount": 10000,
  "status": "success",
  "success_at": "2026-04-24 15:35:24"
}

Field Payload Disbursement

Field	Tipe	Keterangan
merchantTrxId	string	ID transaksi dari merchant
platformTrxId	string	ID transaksi dari platform
accountNo	string	Nomor rekening tujuan
accountName	string	Nama pemilik rekening
amount	number	Nominal transfer
status	string	Status transaksi
success_at	string	Waktu transaksi berhasil

Respons Endpoint Merchant

Endpoint notifyUrl disarankan mengembalikan HTTP 200 OK setelah payload berhasil diterima, agar proses callback tercatat sukses.