Dokumentasi API

Inquiry Transaction Status

API NameInquiry Transaction Status
FunctionAPI ini digunakan untuk menanyakan status pembayaran dan informasi yang dihasilkan qr dari platform merchant ke PakaiLink.
Service Code53
MethodPOST
URL/snap/v1.0/qr/qr-mpm-status
Content Typeapplication/json
Related ServiceQRIS MPM (Acquirer)


Request​

Header​

NoNameTypeLengthRequiredConditionRemarks
1Content-TypeStringVariable, 127 maxWajibTipe konten, nilai selalu application/json
2AuthorizationStringVariableWajibBerisikan B2B Bearer JWT Token, yang didapatkan dari Access Token B2B
3X-TIMESTAMPStringFixed, 25 maxWajibWaktu transaksi, dalam format YYYY-MM-DDTHH:mm:ss+07:00. Zona waktu harus GMT+7 (Jakarta time)
4X-PARTNER-IDStringVariable, 36 maxWajibID untuk mitra yang dihasilkan oleh PakaiLink. Unique ID untuk mitra
5X-EXTERNAL-IDStringVariable, 36 maxWajibMessaging reference ID unik yang dihasilkan oleh merchant. Numeric String. Nomor referensi harus unik di hari yang sama.
6CHANNEL-IDStringVariable, 5 maxWajibIdentifikasi perangkat dimana API Service ini sedang diakses oleh pengguna. Daftar Channel ID dapat dilihat di sini.
7X-SIGNATUREStringVariableWajibSignature harus dihasilkan dengan metode Symmetric Signature

Body​

NoNameTypeLengthRequiredConditionRemarks
1originalPartnerReferenceNoStringVariable, 64 maxOptionaly: (originalReferenceNo = null)Pengidentifikasi transaksi asli pada sistem mitra
2originalReferenceNoStringVariable, 64 maxOptionaly: (originalPartnerReferenceNo = null)Pengidentifikasi transaksi asli pada sistem PakaiLink
3serviceCodeStringVariable, 2 maxWajibIndikator jenis transaksi (kode layanan dari transaksi asli)

Contoh Request

POST /snap/v1.0/qr/qr-mpm-status
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJQQUtBSUxJTksiLCJqdGkiOiIyNDc0NzdlNjk0ZGM3N2FhZDU5YzA4MjA1NzdmZmViNyIsImV4cCI6MTE3NDAyOTc2NzgsImFzIjoicGFydG5lciIsImlkIjoiUFRSMDAwMDAwMyJ9.XmUxHExWILJCHJG74Af8TPJljX2aOmUz4UwJXumxkqxW9uDsIrSX_M_j0uRzPOmaBkk2_rQiHIo_OX_qxv45Mg
Content-Type: application/json
X-TIMESTAMP: 2025-01-30T12:38:12+07:00
X-PARTNER-ID: PTR0000003
X-EXTERNAL-ID: 1101167819
X-SIGNATURE: AaE7rxaiIFPQYryj+JxwOi826dQG4e8RbzagEBaAywS4ETa490Cy/3b1/Ljqput67EF+OgE0V1GDw2t/lxqEJw==
CHANNEL-ID: 95221
{
    "originalPartnerReferenceNo": "Mkbk7WbPyEB3PAYDI5ZlunhK02qOG8cPEZ4B",
    "serviceCode": "53",
    "merchantId": "1031964782"
}

Response​

Body​

NoNameTypeLengthRequiredConditionRemarks
1responseCodeStringFixed, 7 maxWajibLihat daftar kode response.
2responseMessageStringVariable, 150 maxWajibLihat daftar kode response.
3originalPartnerReferenceNoStringVariable, 64 maxOptionalPengidentifikasi transaksi asli pada sistem mitra
4originalReferenceNoStringVariable, 64 maxWajibjika berhasil, value akan terisiPengidentifikasi transaksi asli pada sistem PakaiLink
5originalExternalIdStringVariable, 32 maxOptionalID eksternal asli pada pesan header
6serviceCodeStringVariable, 2 maxWajibIndikator jenis transaksi (kode layanan dari request transaksi asli)
7transactionDateStringFixed, 25 maxOptionalWaktu transaksi: ISO8601, dalam format YYYY-MM-DDTHH:mm:ss+07:00. Zona waktu harus GMT+7 (waktu Jakarta)
8latestTransactionStatusStringFixed, 2 maxWajibKode kategori untuk status transaksi. Nilai-nilai tersebut meliputi: Berhasil, pesanan telah dibayar Dimulai, pesanan telah dibuat, tetapi belum dibayar Membayar, pesanan dalam proses pembayaran Dibatalkan, pesanan telah ditutup
9transactionStatusDescStringVariable, 50 maxOptionalDeskripsi status transaksi
10amountMoneyVariableWajibBerisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO
11additionalInfoJSON ObjectVariableOptionalInformasi tambahan
12callback StringVariableWajib URL untuk dapat menerima notifikasi pembayaran setelah pembayaran dilakukan oleh pelanggan.
13customerData String Variable, 50 maxWajib Nama pelanggan.
14rrn StringVariable, 12 max Wajib Nomor referensi dari transaksi QRIS
15mdrMoneyVariableOptional Berisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO
16serviceFeeMoneyVariableOptionalBerisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO
17nominalPaidMoneyVariableOptional Berisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO
18totalPaidMoneyVariableOptional Berisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO
19totalReceiveMoneyVariableOptionalBerisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO


Contoh Response

{
    "responseCode": "2005300",
    "responseMessage": "Successful",
    "originalPartnerReferenceNo": "Mkbk7WbPyEB3PAYDI5ZlunhK02qOG8cPEZ4B",
    "originalReferenceNo": "1741098450422",
    "originalExternalId": "1101167819",
    "serviceCode": "47",
    "transactionDate": "2025-03-04T21:27:31+07:00",
    "latestTransactionStatus": "00",
    "transactionStatusDesc": "Success",
    "paidTime": "2025-03-04T21:34:12+07:00",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "additionalInfo": {
        "callback": "http://localhost:10007/callback/partner",
        "customerData": "Toko Kelontong",
        "rrn": "",
        "mdr": {
            "value": "0.00",
            "currency": "IDR"
        },
        "serviceFee": {
            "value": "3000.00",
            "currency": "IDR"
        },
        "nominalPaid": {
            "value": "10000.00",
            "currency": "IDR"
        },
        "totalPaid": {
            "value": "10000.00",
            "currency": "IDR"
        },
        "totalReceive": {
            "value": "7000.00",
            "currency": "IDR"
        }
    }
}

Kode dan Pesan Response

NoResponse CodeResponse MessageRemarks
12005300SuccessfulRequest telah berhasil diproses tanpa ada masalah.
24005301Invalid Field FormatPanjang informasi tidak boleh melebihi 150 karakter.
34005302Invalid Mandatory FieldKolom atau field yang wajib diisi tidak lengkap atau formatnya tidak sesuai dengan yang diharapkan.
44015300Unauthorized. [reason]Kesalahan umum yang terjadi ketika pengguna atau sistem tidak memiliki izin untuk mengakses tindakan tertentu.
54015301Invalid Token (B2B)Token akses yang digunakan untuk otentikasi tidak sah atau sudah kedaluwarsa.
64045301Transaction Not FoundTransaksi tidak ditemukan
74095300ConflictX-EXTERNAL-ID tidak dapat digunakan lebih dari sekali dalam satu hari yang sama
84095301Duplicate partnerReferenceNoNomor referensi mitra (partnerReferenceNo, trxId) yang digunakan sudah terdaftar atau digunakan sebelumnya dalam sistem
95005302Backend system failureKesalahan yang terjadi di server saat mencoba memproses request