Website logo
Navigate through spaces
⌘K
Mulai Segera
NICEPAY API
Payment
Checkout
Payout
Messaging
Payment Link
Operasi Bisnis
NICEHub
Magento
OpenCart
PrestaShop
WHMCS
WooCommerce
FAQ NICEHub & General
Merchant Back Office
Keamanan
Release Information
Docs powered by Archbee
NICEPAY API
...
Payment API
API Virtual Account

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:

  1. 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.
  2. 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



[email protected]

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

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

[email protected]

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
1{ 2 "timeStamp" : "20221214151286", 3 "iMid" : "NORMALTEST", 4 "payMethod" : "02", 5 "currency" : "IDR", 6 "bankCd" : "CENA", 7 "amt" : "10000", 8 "referenceNo" : "ordNo20221214151286", 9 "merchantToken" : "c94d31f554faea1c5f28617dd0a9de70fcb4dc8de55a343bb887d032d95dd60a", 10 "vacctValidDt" : "20221231", 11 "vacctValidTm" : "235959", 12 "merFixAcctId" : "", 13 "dbProcessUrl" : "https://ptsv2.com/t/merchant/post/", 14 "mitraCd" : "", 15 "goodsNm" : "Goods For Testing Virtual Account", 16 "cartData" : "{}", 17 "billingNm":"John Doe", 18 "billingPhone":"081288998899", 19 "billingEmail":"[email protected]", 20 "billingAddr":"Jln. Raya Kasablanka Kav.88", 21 "billingCity":"South Jakarta", 22 "billingState":"DKI Jakarta", 23 "billingPostCd":"12800", 24 "billingCountry":"Indonesia", 25 "deliveryNm":"[email protected]", 26 "deliveryPhone":"081288998899", 27 "deliveryAddr":"Jln. Raya Kasablanka Kav.88", 28 "deliveryCity":"South Jakarta", 29 "deliveryState":"DKI Jakarta", 30 "deliveryPostCd":"12800", 31 "deliveryCountry":"Indonesia", 32 "description":"Testing Registration Virtual Account", 33 "reqDomain":"merchant.com", 34 "reqServerIP":"127.0.0.1", 35 "userIP":"127.0.0.1", 36 "userSessionID":"697D6922C961070967D3BA1BA5699C2C", 37 "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/60.0.3112.101 Safari/537.36", 38 "userLanguage":"ko-KR,en-US;q=0.8,ko;q=0.6,en;q=0.4" 39}




Updated 04 Sep 2024
Did this page help you?
PREVIOUS
API Virtual Account
NEXT
Cancel - API Virtual Account
Docs powered by Archbee
TABLE OF CONTENTS
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
Docs powered by Archbee
Copyright © NICEPAY Indonesia All Right Reserved.
Syarat dan Ketentuan

Selamat Datang di NICEPAY DOCS

Dengan mengakses situs ini, maka Anda telah setuju dengan syarat dan ketentuan yang berlaku.

English Version

  Bank Indonesia telah menerbitkan Standar API terkait Pembayaran yang tercantum dalam Peraturan Anggota Dewan Gubernur No 23/15/PADG/2021 tentang Implementasi Standar Nasional Open Application Interface Pembayaran (SNAP).

  Sebagai bentuk dukungan dan kepatuhan terhadap Peraturan Bank Indonesia, NICEPAY mendorong seluruh merchant untuk melakukan migrasi ke API SNAP BI.

  Seluruh Merchant ditargetkan untuk dapat menyelesaikan migrasi API SNAP BI pada Juni 2024.