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

Virtual Account Static

34min

About API Virtual Account Static (Fix Open)



In

 Static


(fix open),


can use

same

number continuously for multiple

s. Static VA

uses for

VA Fix Open

.



Merchant Registration




Credential

Description

iMid



 ID

encodeKey



 API Key

To support setup needs, please



following file from


library.



NICEPAY API Registration



NICEPAY API Registration aims to enable

s to register



for

in



and integrate it with


from

. This step is done first so


knows that

related

has been officially registered and can be connected to

s from

.

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



The following is a list of

s for submitting

registration for a static-type (fix open)


. This

is used through



platform as one of

stages so that


's

can connect to

s from

.

Parameter

Tipe

Size

Description

Example / Notes

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 for Registration VA Static



The following are

 response

s from

results of

request

to register

Virtual Account statistics payment method.

Parameter

Type

Size

Description

Example / Notes

resultCd

Required

N

4

Result Code: Result Code

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

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



Sample JSON Registration Virtual Account Static


Form-urlencoded Request
JSON Response
Java Request


Vacct Info List

Parameter

Type

Size

Description

Example/Notes

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 aims to obtain



and also

numbers to

with monitoring for further development purposes.

The settings for



Inquiry aim to collect

on a list of

s registered from any

based on merFixId .

Target Url

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

Method

POST, GET

Description

To perform VA checking on customerId

Merchant Token

SHA256(Merchant ID+customerId+merchantKey)

Request Format

application/x-www-form-urlencoded



Request Parameter for Virtual Account Inquiry



The following is a list of

s for requesting a

inquiry. This

is used through



platform as one of

steps so that


's

can connect to


from

.

Parameter

Type

Size

Description

Example / Notes

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



The following is

 response

s from

results of

request

to register


Static

.

Parameter

Type

Size

Description

Example / Notes

resultCd

Required

N

4

Result Code: Result Code

0000

resultMsg

Required

AN

255

Result Message: Error Code

SUCCESS

customerID

Required

N

Max 8 (Depend on

 Prefix)





ID

10021198

customerNm

Required

AN

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

Type

Size

Description

Example / Notes

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 in



aims to check


of a fixed open

and to display how much amt (amount) is paid with a certain tXid (

ID) and at a certain time.

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



The following is a list of

s for requesting a

check deposit

. This

uses through



platform as one of

steps so that


's

can connect to


from

.

Parameter

Type

Size

Description

Example / Notes

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



The following are

 response

s from

request

result for


check

.

Parameter

Type

Size

Description

Example / Notes

resultCd

Required

N

4

SUCCESS

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 on



aims to update


's

profile

.

s can make modifications to


to update or delete via 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



The following is a list of

s for requesting updates from

s made on static-type (fix open)


s. This

uses in



platform as one of

stages so that


's

can connect to


s from

.

Parameter

Type

Size

Description

Example / Notes

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



The following is

 response

s from

results of

request

s for


update.

Parameter

Type

Size

Description

Example / Notes

resultCd

Required

N

4

0000

resultMsg

Required

AN

255

Result Message: Error Code

SUCCESS

customerNm

Required

A

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 Response VA Update


Form-Urlencode Request
JSON Response
Java Request




See Also





Status Inquiry - API Checkout

to find out

to check

inquiry specific for

.





Cancel - API Checkout

to find out

to cancel

specific for

.





Status Inquiry - API Virtual Account

to find out



to check

inquiry on

specific for

.





Cancel - API Virtual Account

to find out


to cancel


on

specific for

.