Inquiry Virtual Account

API Name	Virtual Account Inquiry
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 10.000,00 Jumlah maksimum adalah IDR 50.000.000,00
Service Code	45
Method	POST
URL	/snap/v1.0/transfer-bank-va/account-inquiry
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	–	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	beneficiaryAccountNumber	String	Variable, 25 max	Wajib	–	Nomor Rekening Penerima.
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.beneficiaryBankCode	String	Variable, 20 max	Wajib	–	Kode bank yang digunakan untuk transfer virtual account.

Contoh Request

POST /snap/v1.0.0/transfer-bank/account-inquiry
X-TIMESTAMP: 2025-01-30T12:38:12+07:00
X-PARTNER-ID: PTR0000001
X-SIGNATURE: AaE7rxaiIFPQYryj+JxwOi826dQG4e8RbzagEBaAywS4ETa490Cy/3b1/Ljqput67EF+OgE0V1GDw2t/lxqEJw==
X-EXTERNAL-ID: 9244456650
CHANNEL-ID: 21273
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJQQUtBSUxJTksiLCJqdGkiOiIzY2ZiNDhlOTZkNjZiMjc1M2QxNTZhOWE1Y2RjMGFmNiIsImV4cCI6MTE3MzkxODExMDIsImFzIjoicGFydG5lciIsImlkIjoiUFRSMDAwMDAwMSJ9.DNF2zZfEwNnQHO7oOhJKIc3lot_PpFNMxRzaF50SZXt1bb_NZM2ptzdJt4f30b05vBaU9V5JHLkx249aTOv2YQ
{
    "partnerReferenceNo": "7TQw1AV0ZmHtUetIKdvObrGUZJbSLmsxA4ay",
    "beneficiaryAccountNumber" : "31857418",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "additionalInfo": {
        "beneficiaryBankCode": "013"
    }
}

Response

Body

No	Name	Type	Length	Required	Condition	Remarks
1	responseCode	String	Fixed, 7 max	Wajib	–	Lihat daftar kode respons.
2	responseMessage	String	Variable, 150 max	Wajib	–	Lihat daftar kode respons.
3	referenceNo	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	beneficiaryAccountNumber	String	Variable, 25 max	Wajib	–	Nomor rekening penerima yang digunakan untuk mengidentifikasi rekening tujuan
6	beneficiaryAccountName	String	Variable, 50 max	Wajib	–	Nama pemilik rekening penerima yang terdaftar pada bank
7	beneficiaryBankName	String	Variable, 100 max	Wajib	–	Nama bank tempat rekening penerima terdaftar
8	amount	money	Variable	Wajib	–	Jumlah uang yang terlibat dalam suatu transaksi
9	feeAmount	money	Variable	Wajib	–	Jumlah biaya yang dikenakan dalam suatu transaksi
10	additionalInfo	JSON Object	Variable	Wajib	–	Informasi tambahan yang disertakan dalam suatu transaksi
11	additionalInfo.balance	money	Variable	Wajib	–	Jumlah uang yang tersedia dalam suatu akun

Contoh Response

{
    "responseCode": "2004500",
    "responseMessage": "Successful",
    "referenceNo": "INQ0000002",
    "partnerReferenceNo": "KJcaa9XaP6erRaDfB6LsImilXOWAvFePZeFb",
    "beneficiaryAccountNumber": "31857418",
    "beneficiaryAccountName": "Henda Sujiadi",
    "beneficiaryBankName": "BANK PERMATA",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "feeAmount": {
        "value": "4000.00",
        "currency": "IDR"
    },
    "additionalInfo": {
        "balance": {
            "value": "1000000.00",
            "currency": "IDR"
        }
    }
}

Kode dan Pesan Response

No	Response Kode	Response Pesan	Keterangan
1	2004500	Successful	Request telah berhasil diproses tanpa ada masalah
2	4004501	Invalid Field Format	Panjang informasi tidak boleh melebihi 150 karakter
3	4004502	Invalid Wajib Field	Kolom atau field yang wajib diisi tidak lengkap atau formatnya tidak sesuai dengan yang diharapkan
4	4014500	Unauthorized. [reason]	Kesalahan umum yang terjadi ketika pengguna atau sistem tidak memiliki izin untuk mengakses tindakan tertentu
5	4014501	Invalid Token (B2B)	Token akses yang digunakan untuk otentikasi tidak sah atau sudah kedaluwarsa
6	4034501	Feature Not Allowed	Fitur yang diminta tidak diizinkan atau tidak tersedia
7	4034502	Exceeds Transaction Amount Limit	Jumlah uang terkecil atau terbesar yang dapat diproses dalam transaksi
8	4044503	Bank Not Supported By Switch	Bank yang digunakan tidak didukung oleh sistem
9	4094500	Conflict	X-EXTERNAL-ID tidak dapat digunakan lebih dari sekali dalam satu hari yang sama
10	4094501	Duplicate partnerReferenceNo	Nomor referensi mitra (partnerReferenceNo, trxId) yang digunakan sudah terdaftar atau digunakan sebelumnya dalam sistem
11	5004502	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 Virtual Account

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 Virtual Account

Request​

Header

Body

Contoh Request​

​Response​

Body

Contoh Response

Kode dan Pesan Response

Request

Contoh Request

Response