| API Name | Callback Payment Notif QR |
|---|
| Function | API ini digunakan untuk menginformasikan status pembayaran dan informasi dari PakaiLink ke platform merchant. |
| Service Code | 52 |
| Method | POST |
| URL | URL yang ditambahkan saat mengakses endpoint generate QR Code sebelumnya. |
| Accept | application/json |
| Content Type | application/json |
| Related Service | QRIS MPM (Acquirer) |
| Notes | PakaiLink akan melakukan maksimal 3x hit retry callback. |
Request
Header
| No | Name | Type | Length | Required | Condition | Remarks |
|---|
| 1 | Content-Type | String | Variable, 127 max | Mandatory | – | Tipe konten, nilai selalu application/json |
| 2 | X-TIMESTAMP | String | Fixed, 25 max | Mandatory | – | Waktu transaksi, dalam format YYYY-MM-DDTHH:mm:ss+07:00. Zona waktu harus GMT+7 (Jakarta time) |
| 3 | X-PARTNER-ID | String | Variable, 36 max | Mandatory | – | ID untuk mitra yang dihasilkan oleh PakaiLink. Unique ID untuk mitra |
| 4 | X-EXTERNAL-ID | String | Variable, 36 max | Mandatory | – | Messaging reference ID unik yang dihasilkan oleh merchant. Numeric String. Nomor referensi harus unik di hari yang sama. |
| 5 | CHANNEL-ID | String | Variable, 5 max | Mandatory | – | Identifikasi perangkat dimana API Service ini sedang diakses oleh pengguna. Daftar Channel ID dapat dilihat di sini. |
| 6 | X-SIGNATURE | String | Variable | Mandatory | – | Signature harus dihasilkan dengan metode Symmetric Signature |
Body
| No | Name | Type | Length | Required | Condition | Remarks |
|---|
| 1 | originalPartnerReferenceNo | String | Variable, 64 max | Wajib | – | Pengidentifikasi transaksi asli pada sistem mitra |
| 2 | originalReferenceNo | String | Variable, 64 max | Wajib | – | Pengidentifikasi transaksi asli pada sistem PakaiLink |
| 3 | callbackType | callbackType | Variable, 64 max | Wajib | | Jenis callback yang dikirim oleh sistem |
| 4 | latestTransactionStatus | String | Fixed, 2 max | Wajib | – | Status transaksi terakhir |
| 5 | transactionStatusDesc | String | Variable, 50 max | Optional | – | Deskripsi status transaksi |
| 6 | amount | Money | Variable | Wajib | – | Berisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO |
| 7 | additionalInfo | JSON Object | Variable | Optional | – | Informasi tambahan |
Request Sample
POST /callback/partner
"Content-Type": "application/json",
"X-Timestamp": "2025-03-04T21:34:12+07:00",
"X-Signature": "V+0jAw/sXmW23c6j+5tb3bXTqrujxBd1fVKIHVtA84th/p6GAO9/PHBXCKvkVOCbCbv/w5uyht+oyjC8csQnZdKZm3yYbl+RJKEP1AvAcKX0de9BPGpMqiDSME9EKASBzoD6ieEkL77wXdnD9KoX2fd51f5COZQD2SUcrKoseKDNLrTMyPoI1dBMbxQjectdypO6seTzYOYsDnkzlpkFtYhPDD1h+Uk/jGqVjvKnegnvuU6f3baonrPU7lTsBCn50ZwbrBJYZnjlZDZVDgbUAwAsLzyCTcpy/RaFI56Hz6SzSAREOPMfgdF26qvCEVOnm2XGNv+jPjFUrToDOTO6ZQ==",
{
"responseCode": "2004700",
"responseMessage": "Successful",
"originalPartnerReferenceNo": "Mkbk7WbPyEB3PAYDI5ZlunhK02qOG8cPEZ4B",
"originalReferenceNo": "1741098450422",
"callbackType": "settlement",
"originalExternalId": "1098449924",
"serviceCode": "52",
"latestTransactionStatus": "00",
"transactionStatusDesc": "success",
"createdTime": "2025-03-04T21:27:31+07:00",
"finishedTime": "2025-03-04T21:34:12+07:00",
"amount": {
"value": "10000.00",
"currency": "IDR"
},
"additionalInfo": {
"callback": "http://localhost:10007/callback/partner",
"customerData": "Hore Studio",
"rrn": "20231011103236",
"payor": "AkunPembayar_001",
"issuer": "Issuer_provider",
"type":"statis / dinamis"
"mdr": {
"value": "0.00",
"currency": "IDR"
},
"merchantId":"value merchant"
"serviceFee": {
"value": "3000.00",
"currency": "IDR"
},
"nominalPaid": {
"value": "10000.00",
"currency": "IDR"
},
"totalPaid": {
"value": "10000.00",
"currency": "IDR"
},
"totalReceive": {
"value": "7000.00",
"currency": "IDR"
}
}
}
Response
Body
| No | Name | Type | Length | Required | Condition | Remarks |
|---|
| 1 | responseCode | String | Fixed, 7 max | Mandatory | – | Lihat daftar kode response. |
| 2 | responseMessage | String | Variable, 150 max | Mandatory | – | Lihat daftar kode response. |
Response Sample
{
"responseCode": "2005200",
"responseMessage": "Successful"
}
Kode dan Pesan Response
| No | Response Code | Response Message | Remarks |
|---|
| 1 | 2005200 | Successful | Request telah berhasil diproses tanpa ada masalah. |
| 2 | 5005202 | Backend system failure | Kesalahan yang terjadi di server saat mencoba memproses request |
