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	Wajib	–	Informasi tambahan yang disertakan dalam suatu transaksi
5	additionalInfo.productCode	String	Variable, 20 max	Wajib	–	Kode unik yang digunakan untuk mengidentifikasi suatu produk atau layanan dalam sistem.

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": "OVO"
    }
}

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": {
       "balance": {
           "value": "914000.00",
           "currency": "IDR"
       }
   }
}

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

Dokumentasi API

Daftar Isi

SNAP Signature

SNAP Services

SNAP API

Virtual Account

Emoney

QR MPM

Payment Retail

Transfer ke Bank

Transfer Virtual Account

Customer Topup

Apendiks

Inquiry Customer Top-up

Request

Header

Body

Contoh Request

Response

Body

Contoh Response

Kode dan Pesan Response

Dokumentasi API

Daftar Isi

SNAP Signature

SNAP Services

SNAP API

Virtual Account

Emoney

QR MPM

Payment Retail

Transfer ke Bank

Transfer Virtual Account

Customer Topup

Apendiks

Inquiry Customer Top-up

Request​

Header

Body

Contoh Request​

​Response​

Body

Contoh Response

Kode dan Pesan Response

Request

Contoh Request

Response