NICEPAY API
...
Payment API
API Virtual Account

Notification - API Virtual Account

8min

About API Virtual Account Notification





 provides push

s via dbProcessUrl

. The

needs to reassure there is no Blacklist

IP and should Whitelist

IP to get

push

only from

's server.

Request Method

POST

Merchant Token

SHA256 ( iMid+ tXid + amt+ merchantKey)

IP

103.20.51.0/24

103.117.8.0/24

User-Agent

User-Agent: Jakarta Commons-HttpClient/3.1



Notification Parameter Virtual Account



When your dbProcessUrl received a

,

strongly recommend

to verify


using

Status Inquiry - API Virtual Account.

Parameter

Type

Size

Description

Example / Notes

tXid

N

30

Transaction ID

IONPAYTEST02202212141423372834

merchantToken

AN

255



 Token

76a7ea699351eef2ffd1ade233547ed7f3b44aea5859aee7c2250bff1bae7dc9

referenceNo

ANS

40



 Order Number

order123

payMethod

N

2



amt

N

12



 amount

10000

vacctNo

N

20

VA Number

70014000091423372834

transTm

N

6

Transaction time

142527

transDt

N

8

Transaction date

20221214

instmntType

N

2

1

instmntMon

N

2

Installment Month

null

vacctValidTm

N

6

VA Expiry Time (HH24MISS)

142337

vacctValidDt

N

8

VA Expiry Date (YYYYMMDD)

20221216

currency

A

3

Currency



goodsNm

AN

100

Goods name

Test+Transaction+Nicepay

billingNm

A

100

Billing name



 Name

status

A

1

Deposit Status: Notification Status Code

0 : Deposit

1 : Reversal

0

matchCl

N

1

1



Additional Parameter for Virtual Account Notification



Parameter

Type

Size

Descriprion

bankCd

A

4

Bank Code

vacctNo

N

16



 VA Number

vacctValidDt

N

8

VA Expiry Date (YYYYMMDD)

vacctValidTm

N

6

VA Expiry Time (HH24MISS)

depositDt

N

8

Deposit Date (YYYYMMDD)

depositTm

N

6

Deposit Time (HH24MISS)

The

 Token received by

Notification Endpoint must compare internally to prevent fake/invalid

s.

💡Example Case:

For example, you have a merchantKey that is used to generate a token, which is 1234. When

 merchantToken generated by


is known, it is abcd, while

merchantToken obtained in


is abdd. Then


is considered fake/invalid.

⚠️ Pay attention to

 reversal

that can occur in a

. For reversal

on

s,

s will automatically be sent from


to


as a failed

.

will forward


regarding

reversal

to


to be handled further by


as a

update to failed/cancel.

learn more about VA Transaction Settlement.



Sample for VA Notification


Sample POST for VA Notification