Inquiry Status
API Name Inquiry Status – Virtual Account Function API yang digunakan untuk melakukan pengecekan status terakhir dari transaksi transfer bank yang dilakukan. Service Code 49 Method POST URL /snap/v1.0/transfer-va/inquiry-status Content Type application/json Related Service Transfer Virtual Account
Request
Header
No Name Type Length Required Condition Remarks 1 Content-Type String Variable, 127 max Wajib – Tipe konten, nilai selalu application/json 2 Authorization String Variable Wajib – Berisikan B2B Bearer JWT Token, yang didapatkan dari Access Token B2B 3 X-TIMESTAMP String Fixed, 25 max Wajib – Waktu transaksi, dalam format YYYY-MM-DDTHH:mm:ss+07:00. Zona waktu harus GMT+7 (Jakarta time) 4 X-PARTNER-ID String Variable, 36 max Wajib – ID untuk mitra yang dihasilkan oleh PakaiLink. Unique ID untuk mitra 5 X-EXTERNAL-ID String Variable, 36 max Wajib – Messaging reference ID unik yang dihasilkan oleh merchant. Numeric String. Nomor referensi harus unik di hari yang sama. 6 CHANNEL-ID String Variable, 5 max Wajib – Identifikasi perangkat dimana API Service ini sedang diakses oleh pengguna. Daftar Channel ID dapat dilihat di sini . 7 X-SIGNATURE String Variable Wajib – Signature harus dihasilkan dengan metode Symmetric Signature
Body
No Name Type Length Required Condition Remarks 1 partnerServiceId String Variable, 8 max Wajib – Turunan dari X-PARTNER-ID, mirip dengan kode perusahaan, spasi kiri 8 digit. partnerServiceId + customerNo atau virtualAccountNo 2 inquiryRequestId String Variable, 25 max Wajib – Kode unik yang merepresentasikan proses inquiry sebelumnya. 3 virtualAccountNo String Variable, 20 max Wajib – Nomor rekening VA yang akan dilakukan pengecekan. 4 originalReferenceNo String Variable, 10 max Wajib – ID transaksi yang dibuat oleh PakaiLink, merepresentasikan transaksi VA sebelumnya. 5 serviceCode String Variable Wajib – Indikator jenis transaksi transfer VA (46).
Contoh Request
POST /snap/v1.0/transfer-va/inquiry-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: 1159034104
X-SIGNATURE: AaE7rxaiIFPQYryj+JxwOi826dQG4e8RbzagEBaAywS4ETa490Cy/3b1/Ljqput67EF+OgE0V1GDw2t/lxqEJw==
CHANNEL-ID: 95221
{
"partnerServiceId": " 34737",
"inquiryRequestId" : "DNqGRh5wcH1b0E4",
"virtualAccountNo" : "8870800187732330",
"orginalReferenceNo": "VAO000002U",
"serviceCode" : "46"
}Response
Body
No Name Type Length Required Condition Remarks 1 responseCode String Variable, 7 max Wajib – Merujuk pada daftar kode respons. 2 responseMessage String Variable, 150 max Wajib – Merujuk pada daftar kode respons. 3 virtualAccountData JSON Object Variable Wajib – Berisi data transaksi virtual account. 4 partnerServiceId String Tetap, 7 max Wajib – Turunan dari X-PARTNER-ID, mirip dengan kode perusahaan, spasi kiri 8 digit. partnerServiceId + customerNo atau virtualAccountNo 5 inquiryRequestId String Variable, 32 max Wajib – Kode unik yang merepresentasikan proses inquiry sebelumnya. 6 virtualAccountNo String Variable, 2 max Wajib – Nomor rekening VA yang akan dilakukan pengecekan. 7 sourceBankCode String Variable, 25 max Wajib – Kode untuk mengidentifikasi bank yang mengeluarkan VA. 8 serviceCode Money Variable Wajib – Indikator jenis transaksi transfer VA (46). 9 transactionDate String Variable Wajib – Tanggal transaksi, dengan format YYYY-MM-DDTHH:mm:ss+07:00. Waktu harus dalam GMT+7 (waktu Jakarta). 10 amount Money Variable Wajib – Berisi nominal yang berhasil dibayarkan, berisi dua sub-bidang: Nilai: Transaction paidAmount, termasuk pecahan Mata Uang: Kode mata uang berdasarkan ISO 11 latestTransactionStatus String Variable, 2 max Wajib – Deskripsi status transaksi dalam bahasa Indonesia: 00: Sukses 03: Tertunda 06: Gagal 12 latestTransactionStatusDesc String Variable, 32 max Wajib – Deskripsi status transaksi dalam bahasa Indonesia: 00: Sukses 03: Tertunda 06: Gagal
Contoh Response
{
"responseCode": "2004900",
"responseMessage": "Successful",
"virtualAccountData": {
"partnerServiceId": " 34737",
"inquiryRequestId": "zkFNhdRuQ8ZAMMq",
"virtualAccountNo": "8870800187732330",
"sourceBankCode": "013",
"serviceCode": "46",
"transactionDate": "2025-04-23T14:41:39+07:00",
"amount": {
"value": "32000.00",
"currency": "IDR"
},
"latestTransactionStatus": "00",
"latestTransactionStatusDesc": {
"english": "Success",
"indonesia": "Sukses"
}
}
}Kode dan Pesan Response
No Response Kode Response Pesan Keterangan 1 2004900 Successful Request telah berhasil diproses tanpa ada masalah 2 4004901 Invalid Field Format Panjang informasi tidak boleh melebihi 150 karakter 3 4004902 Invalid Wajib Field Kolom atau field yang wajib diisi tidak lengkap atau formatnya tidak sesuai dengan yang diharapkan 4 4014900 Unauthorized. [reason] Kesalahan umum yang terjadi ketika pengguna atau sistem tidak memiliki izin untuk mengakses tindakan tertentu 5 4014901 Invalid Token (B2B) Token akses yang digunakan untuk otentikasi tidak sah atau sudah kedaluwarsa 6 4034901 Transaction Not Found Transaksi tidak ditemukan 7 5004902 Backend system failure Kesalahan yang terjadi di server saat mencoba memproses request
