Inquiry Customer Top-up
API Name Account Inquiry – Customer Topup Function API ini digunakan oleh merchant untuk melakukan pengecekan informasi nomor rekening virtual account melalui PakaiLink Bisnis. Hasil yang didapatkan adalah Nama pemilik nomor rekening virtual account. FAQ : Jumlah minimum adalah IDR 20.000.00 untuk dana Jumlah minimum adalah IDR 10.000.00 untuk metode lainnya Jumlah maksimum mengacu pada regulasi yang berlaku untuk setiap e-money atau e-wallet. Service Code 37 Method POST URL /snap/v1.0/emoney/account-inquiry Content Type application/json Related Service Customer Topup
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 – Berisi B2B Bearer JWT Token, yang telah Anda peroleh dari Access Token B2B 3 X-TIMESTAMP String Fixed, 25 max Wajib – Tanggal dan waktu transaksi, dalam format. YYYY-MM-DDTHH:mm:ss+07:00. Waktu harus dalam format GMT+7 (Jakarta time) 4 X-PARTNER-ID String Variable, 36 max Wajib – ID untuk mitra yang dihasilkan oleh PakaiLink. ID unik untuk setiap mitra. 5 X-EXTERNAL-ID String Variable, 36 max Wajib – ID referensi pesan unik yang dihasilkan oleh merchant. String numerik. Nomor referensi yang harus unik dalam satu hari yang sama. 6 CHANNEL-ID String Variable, 5 max Wajib – Identifikasi perangkat tempat layanan API diakses oleh pengguna akhir (pelanggan) saat ini. 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 parnerReferenceNo String Variable, 225 max Wajib – Nomor unik (hingga 36 digit). 2 customerNumber String Variable, 25 max Wajib – Nomor identifikasi unik yang digunakan untuk mengenali akun pelanggan. 3 amount money Variable Wajib – Jumlah uang yang terlibat dalam suatu transaksi 4 additionalInfo String Variable Optional – Informasi tambahan yang disertakan dalam suatu transaksi 5 additionalInfo.productCode String Variable Wajib – Produk e-money yang digunakan untuk transaksi top up.
Contoh Request
POST /snap/v1.0/emoney/account-inquiry
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: 1160854306
X-SIGNATURE: AaE7rxaiIFPQYryj+JxwOi826dQG4e8RbzagEBaAywS4ETa490Cy/3b1/Ljqput67EF+OgE0V1GDw2t/lxqEJw==
CHANNEL-ID: 95221
{
"partnerReferenceNo": "Glv9yFZIb5iwcc2PUviXG9M5r4UnjdffaCjI",
"customerNumber" : "08113338390",
"amount": {
"value": "10000.00",
"currency": "IDR"
},
"additionalInfo": {
"productCode":"DANA"
}
}Response
Body
No Name Type Length Required Condition Remarks 1 responseCode String Fixed, 7 max Wajib – Lihat daftar kode response. 2 responseMessage String Variable, 150 max Wajib – Lihat daftar kode response. 3 sessionId String Variable, 50 max Wajib – Identifikasi transaksi yang sedang berlangsung 4 partnerReferenceNo String Variable, 50 max Wajib – Nomor referensi yang unik yang digunakan oleh mitra untuk mengidentifikasi transaksi 5 customerNumber String Variable, 25 max Wajib – Nomor identifikasi unik yang digunakan untuk mengenali akun pelanggan. 6 customerName String Variable, 50 max Wajib – Nama pelanggan yang terdaftar dalam sistem. 7 amount money Variable Wajib – Jumlah uang yang terlibat dalam suatu transaksi 8 feeAmount money Variable Wajib – Jumlah biaya yang dikenakan dalam suatu transaksi 9 additionalInfo JSON Object Variable Wajib – Informasi tambahan yang disertakan dalam suatu transaksi 10 additionalInfo.balance money Variable Wajib – Jumlah uang yang tersedia dalam suatu akun
Contoh Response
{
"responseCode": "2003700",
"responseMessage": "Successful",
"sessionId": "INQ0000032",
"partnerReferenceNo": "Glv9yFZIb5iwcc2PUviXG9M5r4UnjdffaCjI",
"customerNumber": "08113338390",
"customerName": "Henda Sujiadi",
"amount": {
"value": "10000.00",
"currency": "IDR"
},
"feeAmount": {
"value": "3000.00",
"currency": "IDR"
},
"additionalInfo": {}
}Kode dan Pesan Response
No Response Kode Response Pesan Keterangan 1 2003700 Successful Request telah berhasil diproses tanpa ada masalah 2 4003701 Invalid Field Format Panjang informasi tidak boleh melebihi 150 karakter 3 4003702 Invalid Wajib Field Kolom atau field yang wajib diisi tidak lengkap atau formatnya tidak sesuai dengan yang diharapkan 4 4013700 Unauthorized. [reason] Kesalahan umum yang terjadi ketika pengguna atau sistem tidak memiliki izin untuk mengakses tindakan tertentu 5 4013701 Invalid Token (B2B) Token akses yang digunakan untuk otentikasi tidak sah atau sudah kedaluwarsa 6 4033701 Feature Not Allowed Fitur yang diminta tidak diizinkan atau tidak tersedia 7 4033702 Exceeds Transaction Amount Limit Jumlah uang terkecil atau terbesar yang dapat diproses dalam transaksi 8 4043703 Bank Not Supported By Switch Bank yang digunakan tidak didukung oleh sistem 9 4093700 Conflict X-EXTERNAL-ID tidak dapat digunakan lebih dari sekali dalam satu hari yang sama 10 4093701 Duplicate partnerReferenceNo Nomor referensi mitra (partnerReferenceNo, trxId) yang digunakan sudah terdaftar atau digunakan sebelumnya dalam sistem 11 5003702 Backend system failure Kesalahan yang terjadi di server saat mencoba memproses request
