Registration - API Virtual Account

11min

Tentang API Virtual Account Registration 
﻿
Virtual Account adalah salah satu ﻿ ﻿ ditawarkan di ﻿. ﻿ memiliki lebih banyak pilihan ﻿ melalui ATM, SMS ﻿ing, Internet ﻿ing, maupun Mobile ﻿ing dengan menggunakan metode ini. Terdapat real-time Notifikasi ﻿ terkirim langsung secara otomatis pada ﻿ sesaat setelah ﻿ menyelesaikan ﻿. 
Jika ﻿ ingin melihat penjelasan umum ﻿ ﻿, ﻿ dapat mengunjungi Panduan Bayar VA﻿.
Untuk pengaturan ﻿ fitur Fix Open dan ﻿, ﻿ dapat mengunjungi ﻿ Virtual Account - Advance API﻿.
﻿
Spesifikasi Panjang Nomor Virtual Account
Seperti ﻿ sudah dijelaskan pada ﻿ Struktur Virtual Account﻿, panjang dari nomor VA ﻿ dapat dibuat berbeda-beda pada setiap ﻿.
Panjang nomor VA dapat ditentukan sendiri sesuai dengan kebutuhan ﻿ selama nomor VA tersebut tidak melebihi kapasitas panjang maksimum ﻿ sudah termasuk dengan angka prefix ﻿ dan prefix ﻿. Berikut adalah tabel persyaratan panjang nomor VA untuk beberapa ﻿.
Bank
NICEPAY + Bank Prefix Length
Max Total VA
BCA
8
23
BRI
8
18
Mandiri
8
19
Maybank
8
16
BNI
7
16
Permata & Syariah
7
16
CIMB
7
19
Danamon
7
16
HANA
7
16
BJB
7
16
BNC
11
19
DKI
9
16
Catatan:
﻿﻿+﻿ Prefix Length merupakan persyaratan panjang angka untuk nomor prefix ﻿ dan ﻿.
Contoh Kasus:
Apabila ﻿ sebagai ﻿ ingin melakukan ﻿ dengan VA ﻿ Mandiri, maka ﻿ wajib untuk memberikan ruang sebesar 8 digit untuk prefix VA ﻿ terdiri dari prefix ﻿ dan prefix ﻿. 
Selanjutnya, angka setelah prefix akan terbagi menjadi 2 tipe sesuai dengan tipe VA ﻿ ingin buat: 
Fixed VA: ﻿ dapat melakukan kustomisasi angka setelah angka prefix VA ﻿ ﻿ sebut sebagai Customer ID atau merFixAcctId dengan catatan bahwa angka tersebut tidak lebih dari 19 digit panjang maksimal untuk nomor VA dari ﻿ Mandiri.
Normal VA: ﻿ tidak dapat melakukan kustomisasi angka setelah angka prefix VA karena angka tersebut akan melalui ﻿ generate secara otomatis dan acak oleh ﻿ dengan catatan bahwa angka tersebut tidak lebih dari 19 digit  panjang maksimal untuk nomor VA dari ﻿ Mandiri.
Panjang nomor VA secara default adalah 16 digit. Kecuali ada skema khusus dari ﻿, ﻿, dan ﻿.

Meskipun setiap ﻿ dapat memiliki panjang nomor VA ﻿ berbeda, ﻿ disarankan untuk dapat mengakomodasi panjang nomor VA dalam satu deret maksimum 30 digit.
﻿
API Virtual Account Registration 
﻿
﻿Registrasi ﻿ bertujuan supaya ﻿ dapat terhubung dengan ﻿ ﻿ ﻿ ﻿ dengan ﻿ dari ﻿. Sehingga ﻿ ﻿ ﻿ sudah disediakan dan di-host dari sisi ﻿ dapat ter﻿ dengan ﻿ dari ﻿. ﻿
API Endpoint
/nicepay/direct/v2/registration
Request Method
﻿POST﻿
Description
Performs Transaction Regist to ﻿
Merchant Token
SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)
Request Format
application/json
﻿
Request Parameter for Registration Virtual Account
﻿
Berikut ini adalah daftar ﻿ untuk melakukan request registrasi ﻿ ﻿. Parameter ini digunakan melalui platform pengujian ﻿ sebagai salah satu tahapan supaya ﻿ milik ﻿ dapat terhubung dengan ﻿ dari ﻿.  
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
timeStamp
﻿Required﻿
N
14
Request Timestamp (YYYYMMDDHH24MISS)
20221214151286
iMid
﻿Required﻿
AN
10
﻿﻿ ID	
﻿
NORMALTEST
payMethod
﻿Required﻿
N
2
﻿Payment Method Code﻿ 
02
currency
﻿Required﻿
A
3
Currency
﻿
IDR
amt 
﻿Required﻿
N
12
Amount
﻿
10000
referenceNo
﻿Required﻿
ANS
40
﻿﻿'s Reference Number
﻿
ordNo20221214151286
goodsNm  ﻿
﻿Required﻿
AN
100
Goods Name	
﻿
Goods For Testing ﻿
billingNm  ﻿
﻿Required﻿
A
100
Buyer Name
John Doe
billingPhone  ﻿
﻿Required﻿
N
15
Buyer Phone Number	
﻿
081288998899
billingEmail  ﻿
﻿Required﻿
ANS
40
Buyer E-mail	
﻿
john.doe@example.com
billingAddr  ﻿
﻿Required﻿
AN
100
Buyer Address	
﻿
Jln. Raya Kasablanka Kav.88
billingCity  ﻿
﻿Required﻿
A
50
Buyer City	
﻿
South Jakarta
billingState  ﻿
﻿Required﻿
A
50
Billing State	
﻿
DKI Jakarta
billingPostCd  ﻿
﻿Required﻿
N
10
Billing Post Number	
﻿
12800
billingCountry ﻿
﻿Required﻿
A
10
Billing Country	
﻿
﻿﻿ 
cartData ﻿
JSONstring
4000
Cart Data
﻿
bankCd ﻿
﻿Required for VA﻿
A
4
﻿Bank Code﻿ 
CENA
vacctValidDt  ﻿
﻿Required﻿
N
8
VA Expiry Date (YYYYMMDD)
20221231
vacctValidTm  ﻿
﻿Required﻿
N
6
VA Expiry Time (HH24MISS)	
235959
merFixAcctId  ﻿
﻿Required ﻿for VA type Fixclose﻿
AN
40
﻿﻿ Reserved VA ID	
-
userIP 
﻿Required for CC, E-Wallet, Payloan,QRIS﻿
AN
15
User IP
﻿
127.0.0.1
dbProcessUrl 
﻿Required﻿
ANS
255
Notification URL	
﻿
https://ptsv2.com/t/merchant/post/
merchantToken  
﻿Required﻿
AN
255
﻿﻿ Token	
﻿
c94d31f554faea1c5f28617dd0a9de70fcb4dc8de55a343bb887d032d95dd60a
deliveryNm  
A
30
Delivery Name	
delivery@example.com
deliveryPhone
N
15
Delivery Phone	
081288998899
deliveryAddr
AN
100
Delivery Address	
Jln. Raya Kasablanka Kav.88
deliveryCity
A
50
Delivery City	
South Jakarta
deliveryState
A
50
Delivery State	
DKI Jakarta
deliveryPostCd
N
10
Delivery Post Code	
12800
deliveryCountry
A
10
Delivery Country	
﻿﻿ 
description
AN
100
Transaction Description	
Testing Registration ﻿
reqDomain
ANS
100
Request Domain	
merchant.com
reqServerIP
ANS
15
Request Server IP	
127.0.0.1
userSessionID
AN
100
User Session ID	
697D6922C961070967D3BA1BA5699C2C
userAgent
ANS
100
User Agent	
Mozilla
userLanguage
A
2
User Language	
en-US
﻿﻿ kunjungi ﻿ Virtual Account (VA)﻿ untuk mempelajari ﻿ umum mengenai ﻿ ﻿. Parameter di bawah berisi ﻿ tambahan mengenai ﻿ Registrasi ﻿.
﻿
Response Parameter for Registration Virtual Account
﻿
Berikut adalah response ﻿ dari hasil request ﻿ untuk mendaftarkan ﻿ ﻿.
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
resultCd 
N
14
﻿Result Code﻿ 
0000
resultMsg 
AN
255
Result Message: Error Code﻿ 
SUCCESS
tXid
AN
30
Transaction ID
NORMALTEST02202212141509411648
referenceNo
ANS
40
﻿﻿ Reference Number
ordNo20221214151286
payMethod 
N
2
﻿Payment Method Code﻿ 
02
amt
N
12
﻿﻿ Amount
1000
transDt ﻿
N
8
Transaction Date (YYYYMMDD)
20221214
transTm 
N
6
Transaction Time (HH24MISS)
150941
description 
AN
100
Description
Testing Registration ﻿﻿
bankCd 
AN
4
﻿Bank Code﻿ 
CENA
vacctNo
N
20
VA Number
9912304000001486
mitraCd
AN
4
﻿Mitra Code﻿ 
null
payNo
N
12
﻿﻿ Number
null
currency
AN
3
Currency
IDR
goodsNm
AN
100
Goods Name
Goods For Testing ﻿﻿
billingNm
A
100
Buyer Name
John Doe
vacctValidDt
N
8
VA Expiry Date (YYYYMMDD)
20221231
vacctValidTm
N
6
VA Expiry Time (HH24MISS)
235959
payValidDt
N
8
Expiry Date (YYYYMMDD)
 null
payValidTm 
N
6
Expiry Time (HH24MISS)
null
requestURL
ANS
360
Request URL
null
paymentExpDt
N
8
QR ﻿ Expiry Date (YYYYMMDD)
null
paymentExpTm
N
6
QR ﻿ Expiry Time (HH24MISS)
null
qrContent
ANS
360
QR String in Plain Text	
null
qrUrl
ANS
360
URL for QR Image, Valid for 5 minutes	
null
Setelah ﻿ mendapatkan nomor VA untuk ﻿ ﻿ dari ﻿ vacctNo di response tersebut, ﻿ pun dapat langsung memberikan nomor VA-nya kepada ﻿ ﻿ untuk dibayarkan. 
﻿

Sample JSON Registrasi Virtual Account
﻿
JSON Request
JSON Response
Java Request
{
    "timeStamp" : "20221214151286",
    "iMid" : "NORMALTEST",
    "payMethod" : "02",
    "currency" : "IDR",
    "bankCd" : "CENA",
    "amt" : "10000",
    "referenceNo" : "ordNo20221214151286",
    "merchantToken" : "c94d31f554faea1c5f28617dd0a9de70fcb4dc8de55a343bb887d032d95dd60a",
    "vacctValidDt" : "20221231",
    "vacctValidTm" : "235959",
    "merFixAcctId" : "",
    "dbProcessUrl" : "https://ptsv2.com/t/merchant/post/",
    "mitraCd" : "",
    "goodsNm" : "Goods For Testing Virtual Account",
    "cartData" : "{}",
    "billingNm":"John Doe",
    "billingPhone":"081288998899",
    "billingEmail":"john.doe@example.com",
    "billingAddr":"Jln. Raya Kasablanka Kav.88",
    "billingCity":"South Jakarta",
    "billingState":"DKI Jakarta",
    "billingPostCd":"12800",
    "billingCountry":"Indonesia",
    "deliveryNm":"delivery@example.com",
    "deliveryPhone":"081288998899",
    "deliveryAddr":"Jln. Raya Kasablanka Kav.88",
    "deliveryCity":"South Jakarta",
    "deliveryState":"DKI Jakarta",
    "deliveryPostCd":"12800",
    "deliveryCountry":"Indonesia",
    "description":"Testing Registration Virtual Account",
    "reqDomain":"merchant.com",
    "reqServerIP":"127.0.0.1",
    "userIP":"127.0.0.1",
    "userSessionID":"697D6922C961070967D3BA1BA5699C2C",
    "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/60.0.3112.101 Safari/537.36",
    "userLanguage":"ko-KR,en-US;q=0.8,ko;q=0.6,en;q=0.4"
}
{
    "timeStamp" : "20221214151286",
    "iMid" : "NORMALTEST",
    "payMethod" : "02",
    "currency" : "IDR",
    "bankCd" : "CENA",
    "amt" : "10000",
    "referenceNo" : "ordNo20221214151286",
    "merchantToken" : "c94d31f554faea1c5f28617dd0a9de70fcb4dc8de55a343bb887d032d95dd60a",
    "vacctValidDt" : "20221231",
    "vacctValidTm" : "235959",
    "merFixAcctId" : "",
    "dbProcessUrl" : "https://ptsv2.com/t/merchant/post/",
    "mitraCd" : "",
    "goodsNm" : "Goods For Testing Virtual Account",
    "cartData" : "{}",
    "billingNm":"John Doe",
    "billingPhone":"081288998899",
    "billingEmail":"john.doe@example.com",
    "billingAddr":"Jln. Raya Kasablanka Kav.88",
    "billingCity":"South Jakarta",
    "billingState":"DKI Jakarta",
    "billingPostCd":"12800",
    "billingCountry":"Indonesia",
    "deliveryNm":"delivery@example.com",
    "deliveryPhone":"081288998899",
    "deliveryAddr":"Jln. Raya Kasablanka Kav.88",
    "deliveryCity":"South Jakarta",
    "deliveryState":"DKI Jakarta",
    "deliveryPostCd":"12800",
    "deliveryCountry":"Indonesia",
    "description":"Testing Registration Virtual Account",
    "reqDomain":"merchant.com",
    "reqServerIP":"127.0.0.1",
    "userIP":"127.0.0.1",
    "userSessionID":"697D6922C961070967D3BA1BA5699C2C",
    "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/60.0.3112.101 Safari/537.36",
    "userLanguage":"ko-KR,en-US;q=0.8,ko;q=0.6,en;q=0.4"
}
﻿

Bank	NICEPAY + Bank Prefix Length	Max Total VA
BCA	8	23
BRI	8	18
Mandiri	8	19
Maybank	8	16
BNI	7	16
Permata & Syariah	7	16
CIMB	7	19
Danamon	7	16
HANA	7	16
BJB	7	16
BNC	11	19
DKI	9	16

API Endpoint	/nicepay/direct/v2/registration
Request Method	POST
Description	Performs Transaction Regist to
Merchant Token	SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)
Request Format	application/json

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
timeStamp Required	N	14	Request Timestamp (YYYYMMDDHH24MISS)	20221214151286
iMid Required	AN	10	ID	NORMALTEST
payMethod Required	N	2	Payment Method Code	02
currency Required	A	3	Currency	IDR
amt Required	N	12	Amount	10000
referenceNo Required	ANS	40	's Reference Number	ordNo20221214151286
goodsNm Required	AN	100	Goods Name	Goods For Testing
billingNm Required	A	100	Buyer Name	John Doe
billingPhone Required	N	15	Buyer Phone Number	081288998899
billingEmail Required	ANS	40	Buyer E-mail	john.doe@example.com
billingAddr Required	AN	100	Buyer Address	Jln. Raya Kasablanka Kav.88
billingCity Required	A	50	Buyer City	South Jakarta
billingState Required	A	50	Billing State	DKI Jakarta
billingPostCd Required	N	10	Billing Post Number	12800
billingCountry Required	A	10	Billing Country
cartData	JSONstring	4000	Cart Data
bankCd Required for VA	A	4	Bank Code	CENA
vacctValidDt Required	N	8	VA Expiry Date (YYYYMMDD)	20221231
vacctValidTm Required	N	6	VA Expiry Time (HH24MISS)	235959
merFixAcctId Required for VA type Fixclose	AN	40	Reserved VA ID	-
userIP Required for CC, E-Wallet, Payloan,QRIS	AN	15	User IP	127.0.0.1
dbProcessUrl Required	ANS	255	Notification URL	https://ptsv2.com/t/merchant/post/
merchantToken Required	AN	255	Token	c94d31f554faea1c5f28617dd0a9de70fcb4dc8de55a343bb887d032d95dd60a
deliveryNm	A	30	Delivery Name	delivery@example.com
deliveryPhone	N	15	Delivery Phone	081288998899
deliveryAddr	AN	100	Delivery Address	Jln. Raya Kasablanka Kav.88
deliveryCity	A	50	Delivery City	South Jakarta
deliveryState	A	50	Delivery State	DKI Jakarta
deliveryPostCd	N	10	Delivery Post Code	12800
deliveryCountry	A	10	Delivery Country
description	AN	100	Transaction Description	Testing Registration
reqDomain	ANS	100	Request Domain	merchant.com
reqServerIP	ANS	15	Request Server IP	127.0.0.1
userSessionID	AN	100	User Session ID	697D6922C961070967D3BA1BA5699C2C
userAgent	ANS	100	User Agent	Mozilla
userLanguage	A	2	User Language	en-US

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
resultCd	N	14	Result Code	0000
resultMsg	AN	255	Result Message: Error Code	SUCCESS
tXid	AN	30	Transaction ID	NORMALTEST02202212141509411648
referenceNo	ANS	40	Reference Number	ordNo20221214151286
payMethod	N	2	Payment Method Code	02
amt	N	12	Amount	1000
transDt	N	8	Transaction Date (YYYYMMDD)	20221214
transTm	N	6	Transaction Time (HH24MISS)	150941
description	AN	100	Description	Testing Registration
bankCd	AN	4	Bank Code	CENA
vacctNo	N	20	VA Number	9912304000001486
mitraCd	AN	4	Mitra Code	null
payNo	N	12	Number	null
currency	AN	3	Currency	IDR
goodsNm	AN	100	Goods Name	Goods For Testing
billingNm	A	100	Buyer Name	John Doe
vacctValidDt	N	8	VA Expiry Date (YYYYMMDD)	20221231
vacctValidTm	N	6	VA Expiry Time (HH24MISS)	235959
payValidDt	N	8	Expiry Date (YYYYMMDD)	null
payValidTm	N	6	Expiry Time (HH24MISS)	null
requestURL	ANS	360	Request URL	null
paymentExpDt	N	8	QR Expiry Date (YYYYMMDD)	null
paymentExpTm	N	6	QR Expiry Time (HH24MISS)	null
qrContent	ANS	360	QR String in Plain Text	null
qrUrl	ANS	360	URL for QR Image, Valid for 5 minutes	null

API Virtual Account

Cancel - API Virtual Account

Registration - API Virtual Account

Tentang API Virtual Account Registration

Spesifikasi Panjang Nomor Virtual Account

API Virtual Account Registration

Request Parameter for Registration Virtual Account

Response Parameter for Registration Virtual Account

Sample JSON Registrasi Virtual Account

Selamat Datang di NICEPAY DOCS