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(iMid+customerId+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(iMid+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(iMid+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(iMid+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 .