Create Virtual Account

API Name	Create VA
Function	API ini digunakan untuk membuat virtual account dari PakaiLink ke bank, di mana tipe transaksi yang dapat dilakukan meliputi pembuatan VA Statis dan VA Dinamis. Untuk layanan VA Dinamis sistem akan mengembalikan nomor VA yang dapat digunakan hanya satu kali untuk setiap transaksi, sedangkan pada VA Statis sistem akan membuat nomor Virtual Bank yang tidak pernah kedaluwarsa dan nominal transaksi yang fleksibel. Layanan ini akan mengembalikan Nomor Rekening Virtual untuk dibayar. Layanan ini diperuntukkan bagi mitra yang ingin membuat Nomor VA khusus untuk pelanggan mereka (1 VA untuk 1 Pelanggan). Jika Nomor Rekening Virtual dibayar oleh pengguna, dana penyelesaian akan langsung masuk ke Saldo PakaiLink Anda. Harap simpan nomor rekening virtual ini di database Anda. FAQ: Nominal minimum adalah IDR 10.000.00 Nominal maksimal adalah IDR 2.000.000.000.00
Service Code	27
Method	POST
URL	/snap/v1.0/transfer-va/create-va
Content Type	application/json
Related Service	Virtual Account

Request

Header

No	Name	Type	Length	Required	Condition	Remarks
1	Authorization	String	Variable	Wajib	–	Berisikan B2B Bearer JWT Token yang didapatkan dari Access Token B2B
2	Content-Type	String	Variable, 127 max	Wajib	–	Tipe konten, nilai selalu application/json
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	customerNo	String	Variable, 20 max	Wajib	–	Nomor unik (hingga 20 digit). partnerServiceId + CustomerNo atau virtualAccountNo
3	virtualAccountName	String	Variable, 100 max	Optional	–	Nama pengguna yang digunakan saat mendaftarkan VA. (statis) Nama yang terdaftar pada akun virtual yang digunakan untuk transaksi. (dinamis)
4	virtualAccountEmail	String	Variable, 225 max	Optional	–	Data ini wajib ada ketika mengimplementasikan VA Statis.
5	trxId	String	Variable, 225 max	Optional	–	ID unik yang digunakan untuk mengidentifikasi suatu transaksi.
6	virtualAccountTrxType	String	Variable, 1 max	Wajib	–	Digunakan untuk mengidentifikasi tipe kode VA yang dibuat, Untuk saat ini PakaiLink hanya support untuk tipe VA Statis dan VA Dinamis. VA Statis [O] VA Dinamis [C]
7	expiredDate	String	Variable	Optional	y	Waktu kedaluwarsa dari VA dinamis yang dibuat (dalam format ISO). Jika variable ini tidak diisi, maka secara default akan diisi 24 jam oleh sistem.
8	totalAmount	Money	Variable	Wajib	y	Jumlah tagihan yang harus dibayarkan dalam suatu transaksi jika VA dinamis.
9	additionalInfo	String	Variable	Wajib	–	Informasi tambahan yang disertakan dalam suatu transaksi.
10	additionalInfo.callbackUrl	String	text	Wajib	–	URL yang digunakan oleh sistem untuk mengirimkan response atau notifikasi otomatis setelah suatu transaksi atau proses selesai.
11	additionalInfo.bankcode	String	text, 3 max	Wajib	–	Kode bank merepresentasikan institusi bank yang digunakan untuk membuat kode VA.

Contoh Request (VA Dinamis)

POST /snap/v1.0/transfer-va/create-va
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: 1059833850
X-SIGNATURE: 2aRrh2Gm2kMBZjX2wsRTB7ckGZf1pXjBfuJBY1hcBFx4m04eTWTjrxdV3mkcn6+ulN1DIr7SZucHbWnaTssGTQ==
CHANNEL-ID: 95221
 
{
    "partnerServiceId": "   12334",
    "customerNo" : "318574181222",
    "virtualAccountName" : "Setya Wardana",
    "trxId": "W8pVBq2Z8pyRqj7kUEIeALR1enG4pJ1JUpf1",
    "virtualAccountTrxType": "C",
    "expiredDate": "2025-04-23T11:01:34+07:00",
    "totalAmount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "additionalInfo": {
        "callbackUrl": "http://127.0.0.1:10007/callback/partner",
        "bankCode": "008"
    }
}

Contoh Request (VA Statis)

POST /snap/v1.0/transfer-va/create-va
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: 1062011571
X-SIGNATURE: ci+qeDB1b7M6dkDzxk4bBgQ94257b7/cJO1HCpn6gcFIFHzE9CiM/PFmvhLtjr3PJQ+C9xVljWgyv1k5Di5rgA==
CHANNEL-ID: 95221
 
{
    "partnerServiceId": "    1222",
    "customerNo" : "131857418122353",
    "virtualAccountName" : "Setya Wardana",
    "virtualAccountEmail" : "test@gmail.com",
    "trxId": "1Mfo8gsQa43Sd2zJ3CJzDHYjGkeG3ErDD6tu",
    "virtualAccountTrxType": "O",
    "additionalInfo": {
        "callbackUrl": "http://localhost:10007/callback/partner",
        "bankCode": "013"
    }
}

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	virtualAccountData	String	Variable	Wajib	–	Berisi data virtual account
4	partnerServiceId	String	Variable	Wajib	–
5	customerNo	String	Variable	Wajib	–
6	virtualAccountNo	String	Variable, 28 max	Wajib	–	Informasi nomor virtual account yang menggabungkan partnerServiceId dan customerNo
7	trxId	String	Variable, 225 max	Optional	–
8	virtualAccountTrxType	String	Variable, 1 max	Wajib	–	Digunakan untuk mengidentifikasi tipe kode VA yang dibuat, Untuk saat ini PakaiLink hanya support untuk tipe VA Statis dan VA Dinamis. VA Statis [O] VA Dinamis [C]
9	totalAmount	JSON Object	Variable	–	y	Jumlah tagihan yang harus dibayarkan dalam suatu transaksi jika VA dinamis.
10	totalAmount.value	String	Variable	–	–	Total Amount, termasuk pecahan
11	totalAmount.currency	String	Variable	–	–	Kode mata uang berdasarkan ISO
12	feeAmount	JSON Object	Variable	–	–	Jumlah biaya layanan yang dikenakan dalam suatu transaksi
13	feeAmount.value	String	Variable	–	–	Transaction paidAmount, termasuk pecahan
14	feeAmount.currency	String	Variable	–	–	Kode mata uang berdasarkan ISO
15	additionalInfo	JSON Object	Variable	Wajib	–	Informasi tambahan.
16	additionalInfo.callbackUrl	String	Variable	Wajib	–	URL untuk dapat menerima notifikasi pembayaran setelah pembayaran dilakukan oleh pelanggan.
17	additionalInfo.bankCode	String	text	–	–	Kode bank merepresentasikan institusi bank yang digunakan untuk membuat kode VA.
18	additionalInfo.referenceNo	String	Variable	–	–	Identifikasi transaksi yang sedang berlangsung

Contoh Response (VA Dinamis)

{
   "responseCode": "2002700",
   "responseMessage": "Successful",
   "virtualAccountData": {
       "partnerServiceId": "   12334",
       "customerNo": "318574181222",
       "virtualAccountNo": "1450010000048727",
       "trxId": "W8pVBq2Z8pyRqj7kUEIeALR1enG4pJ1JUpf1",
       "virtualAccountTrxType": "C",
       "totalAmount": {
           "value": "10000.00",
           "currency": "IDR"
       },
       "feeAmount": {
           "value": "3000.00",
           "currency": "IDR"
       },
       "additionalInfo": {
           "callbackUrl": "http://127.0.0.1:10007/callback/partner",
           "bankCode": "008",
           "referenceNo": "VAI000003F"
       }
   }
}

Contoh Response (VA Statis)

{
   "responseCode": "2002700",
   "responseMessage": "Successful",
   "virtualAccountData": {
       "partnerServiceId": "    1222",
       "customerNo": "131857418122353",
       "virtualAccountNo": "7137010000000885",
       "trxId": "1Mfo8gsQa43Sd2zJ3CJzDHYjGkeG3ErDD6tu",
       "virtualAccountTrxType": "O",
       "feeAmount": {
           "value": "3000.00",
           "currency": "IDR"
       },
       "additionalInfo": {
           "callbackUrl": "http://localhost:10007/callback/partner",
           "bankCode": "013",
           "referenceNo": "VAI000003H"
       }
   }
}

Kode dan Pesan Response

No	Response Code	Response Message	Keterangan
1	2002700	Successful	Request telah berhasil diproses tanpa ada masalah.
2	4002701	Invalid Field Format	Panjang informasi tidak boleh melebihi 150 karakter.
3	4002702	Invalid Wajib Field	Kolom atau field yang wajib diisi, tidak lengkap atau formatnya tidak sesuai dengan yang diharapkan.
4	4012700	Unauthorized. [reason]	Kesalahan umum yang terjadi ketika pengguna atau sistem tidak memiliki izin untuk akses tindakan tertentu
5	4012701	Invalid Token (B2B)	Token akses yang digunakan untuk otentikasi tidak sah atau sudah kedaluwarsa.
6	4032701	Feature Not Allowed	Fitur yang diminta tidak diizinkan atau tidak tersedia.
7	4032702	Exceeds Transaction Amount Limit	Jumlah uang terkecil atau terbesar yang dapat diproses dalam transaksi.
8	4042703	Bank Not Supported By Switch	Bank yang digunakan tidak didukung oleh sistem.
9	4042711	invalid account	Akun tidak valid atau tidak dapat ditemukan dalam sistem.
10	4092700	Conflict	X-EXTERNAL-ID tidak dapat digunakan lebih dari sekali dalam satu hari yang sama.
11	4092701	Duplicate partnerReferenceNo	Nomor referensi mitra (partnerReferenceNo,trxId) yang digunakan sudah terdaftar atau digunakan sebelumnya dalam sistem.
12	5002702	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

Create Virtual Account

Request

Header

Body

Contoh Request (VA Dinamis)

Contoh Request (VA Statis)

Response

Body

Contoh Response (VA Dinamis)

Contoh Response (VA Statis)

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

Create Virtual Account

Request​

Header

Body

Contoh Request​ (VA Dinamis)

Contoh Request​ (VA Statis)

​Response​

Body

Contoh Response (VA Dinamis)

Contoh Response (VA Statis)

Kode dan Pesan Response

Request

Contoh Request (VA Dinamis)

Contoh Request (VA Statis)

Response