NICEPAY API
...
Advance API
Virtual Account - Advance API

Virtual Account Static

34min

Tentang API Virtual Account Static (Fix Open)



Pada



Static (fix open),

dapat menggunakan nomor


sama untuk melakukan

secara berulang. Integrasi VA statis digunakan untuk

Fix Open VA.



Merchant Registration




Kredensial

Deskripsi

iMid



 ID

encodeKey



 API Key

Untuk mendukung kebutuhan setup, silakan

 file berikut sebagai

library.



NICEPAY API Registration



NICEPAY API Registration bertujuan agar

 dapat mendaftarkan


pada

di


dan terintegrasi dengan

dari

. Tahapan ini dilakukan paling dahulu supaya

mengetahui bahwa


bersangkutan sudah terdaftar secara resmi dan dapat terhubung dengan

dari

.

API URL

https://www.nicepay.co.id/nicepay/api/vacctCustomerRegist.do

Request Method

POST

Merchant Token

SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)

Request Format

application/x-www-form-urlencoded



Request Parameter for Registration VA Static



Berikut ini adalah daftar

 untuk melakukan pengajuan pendaftaran


tipe static (fix open). Parameter ini digunakan melalui platform pengujian

sebagai salah satu tahapan supaya

milik

dapat terhubung dengan

dari

.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

iMid

Required

AN

10



 ID

FIXOPEN001

customerId

Required

N

Max 8 (Depend on

 Prefix)





ID

10021198

customerNm

Required

AN

20 - 30



 Name

Jack

merchantToken

Required

AN

255



 Token

c31fec3c0e66c9d8703f9f8221f7c450950d7d26822abe037ce33c12f462c785



Response Parameter untuk Registration VA Static



Berikut adalah response

 dari hasil request

untuk meregistrasikan


Statistic.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

resultCd

Required

N

4

0000

resultMsg

Required

AN

255

Result message: Error Code

SUCCESS

customerID

Required

N

Max 8 (Depend on

 Prefix)





ID

10021198

customerNm

AN

20 - 30





Name

Jack

vacctInfoList

Required

Array of object







List





List

[ { "bankCd": "BDIN", "vacctNo": "7917019110021198" },...]



Sample JSON Registration Virtual Account Static


Form-urlencoded Request
JSON Response
Java Request


Vacct Info List

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

bankCd

Required

AN

4

Bank Code

BDIN

vacctNo

Required

N

16



 Number

7917019110021198

Sample JSON Vacct Account

JSON Vacct Account Response




NICEPAY Virtual Account Inquiry



NICEPAY Virtual Account Inquiry bertujuan untuk mendapatkan



serta nomor

agar dapat dilakukan pemantauan untuk pengembangan berikutnya.

Pengaturan pada



Inquiry bertujuan untuk mengumpulkan

daftar


terdaftar dari

mana saja berdasarkan merFixId.

Target Url

https://www.nicepay.co.id/nicepay/api/vacctCustomerInquiry.do

Method

POST, GET

Description

Untuk melakukan pengecekan VA pada customerId

Merchant Token

SHA256(Merchant ID+customerId+merchantKey)

Request Format

application/x-www-form-urlencoded



Request Parameter for Virtual Account Inquiry



Berikut ini adalah daftar

 untuk melakukan request

inquiry. Parameter ini digunakan melalui platform pengujian

sebagai salah satu tahapan supaya

milik

dapat terhubung dengan

dari

.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

iMid

Required

AN

10



 ID

FIXOPEN001

customerId

Required

N

Max 8 (Depend on

 Prefix)





ID

10021198

merchantToken

Required

AN

255



 Token

c31fec3c0e66c9d8703f9f8221f7c450950d7d26822abe037ce33c12f462c785



Response Parameter for Inquiry



Berikut adalah response

 dari hasil request

untuk mendaftarkan


Static.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

resultCd

Required

N

4

0000

resultMsg

Required

AN

255

Result Message: Error Code

SUCCESS

customerID

Required

N

Max 8 (Depend on

 Prefix)





ID

10021198

customerNm

Required

A

20 - 30





Name

Jack

vacctInfoList

Required

Array of object







List

[

        {

            "bankCd": "BDIN",

            "vacctNo": "7917019110021198"

        },

        {

            "bankCd": "BNIA",

            "vacctNo": "11695109010021198"

        },

...

]



Sample JSON NICEPAY Virtual Account Inquiry


Form-Urlencode Request
JSON Response
Java Request


Vacct Info List

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

bankCd

Required

AN

4

Bank Code

BDIN

vacctNo

Required

N

16



 Number

7917019110021198

Sample JSON Vacct Account

JSON Vacct Account




NICEPAY Virtual Account Deposit



NICEPAY Virtual Account Deposit dalam

 bertujuan untuk memeriksa


fix open dan untuk menampilkan seberapa banyak amt (amount)

dibayarkan dengan tXid (ID

) tertentu dan dalam waktu tertentu.

Target Url

https://www.nicepay.co.id/nicepay/api/vacctInquiry.do

Method

POST

Description

API Check Status For VA Fixopen

Merchant Token

SHA256(Merchant ID+customerId+merchantKey)

Request Format

application/x-www-form-urlencoded



Request Parameter for Virtual Account Check Status



Berikut ini adalah daftar

 untuk melakukan mengajukan pemeriksaan

deposit

. Parameter ini digunakan melalui platform pengujian

sebagai salah satu tahapan supaya

milik

dapat terhubung dengan

dari

.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

iMid

Required

AN

10



 ID

FIXOPEN001

vacctNo

Required

N

16



 Number

8804910910021197

merchantToken

Required

AN

255



 Token

20221215

startDt

Required

N

8

Request Start Date (YYYYMMDD)

20221222

endDt

Required

N

8

Request Start Date (YYYYMMDD)

75d137e8823108e47d04dadc3290cb36dc305d573323123f410c6f61acf1db63



Response Parameter for Virtual Account Check Status



Berikut adalah response

 dari hasil request

untuk pemeriksaan


.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

resultCd

Required

N

4

0000

resultMsg

Required

AN

255

Result Message: Error Code

SUCCESS

vacctNo

Required

N

16



 Number

8804910910021197

depositInfo

Required

Array of object







List

[ { "bankCd": "BMRI", "date": "20221220", "time": "100733", "amt": "1600000", "tXid": "FIXOPEN00102202212201007334066", "status": "0", "referenceNo": "10021197" },...]



Sample JSON Virtual Account Deposit


Form-Urlencode Request
JSON Response
Java Request




NICEPAY Virtual Account Update



NICEPAY Virtual Account Update dalam

 bertujuan untuk memperbarui

mengenai profil

milik

.

dapat melakukan modifikasi pada

untuk perbaharui atau hapus melalui updateType.

Target Url

https://www.nicepay.co.id/nicepay/api/vacctCustomerUpdate.do

Method

POST

Description

merficAcctNm

 for

Update

Merchant Token

SHA256(Merchant ID+customerId+merchantKey)

Request format

application/x-www-form-urlencoded



Request Parameter for Virtual Account Update



Berikut ini adalah daftar

 untuk melakukan request update dari


dilakukan pada


tipe Static (fix open). Parameter ini digunakan melalui platform pengujian

sebagai salah satu tahapan supaya

milik

dapat terhubung dengan

dari

.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

iMid

Required

AN

10



 ID

FIXOPEN001

customerId

Required

N

Max 8 (Depend on

 Prefix)



 ID

10021197

merchantToken

Required

AN

255



 Token

c92a4372a8417d96407becec2c3221033358c16e1c29b5ccf7fe0cec211ecbf4

customerNm

Required

AN

20 - 30



 Name

Howard

updateType

Required

N

2

1: Create

2: Update

3: Delete

2



Response Parameter for Virtual Account Update



Berikut adalah response

 dari hasil request

untuk

update.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

resultCd

Required

N

4

0000

resultMsg

Required

AN

255

Result Message: Error Code

SUCCESS

customerNm

Required

AN

20 - 30





Name

Howard

customerId

Required

N

Max 8 (Depend on

 Prefix)





ID

10021197

vacctInfoList

Required

Array of Object







List

[ { "bankCd": "BDIN", "vacctNo": "7917019110021197" },...]



Sample JSON for VA Update


Form-Urlencode Request
JSON Response
Java Request




See Also





Status Inquiry - API Checkout untuk mengetahui

untuk memeriksa

inquiry khusus

.





Cancel - API Checkout untuk mengetahui

untuk membatalkan

khusus

.





Status Inquiry - API Virtual Account untuk mengetahui


untuk memeriksa

inquiry pada

khusus

.





Cancel - API Virtual Account untuk mengetahui


untuk membatalkan

pada

khusus

.