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 .