NICEPAY API
...
Payment API
API Virtual Account

Notification - API Virtual Account

8min

Tentang API Virtual Account Notification



 mengirimkan push notification  dikirim melalui dbProcessUrl .  harus memastikan tidak melakukan Blacklist IP  dan melakukan Whitelist IP  untuk mendapatkan push notification  hanya dikirim dari 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



Ketika  diterima pada dbProcessUrl , kami sangat menyarankan  untuk melakukan verifikasi  kembali dengan menggunakan Status Inquiry - API Virtual Account.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

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

Tipe

Ukuran

Deskripsi

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)

Merchant Token  diterima dari Notification,  harus melakukan perbandingan kembali secara internal untuk mencegah  palsu/tidak berlaku.

💡Contoh Kasus:

Misalnya,  memiliki merchantKey  digunakan untuk melakukan generate token, yaitu 1234. Ketika merchantToken  di-generate  diketahui adalah abcd, sementara merchantToken  didapatkan pada  adalah abdd, maka  tersebut dianggap palsu/tidak berlaku.

⚠️ Perhatikan mengenai reversal process  dapat terjadi pada . Untuk  reversal pada ,  akan otomatis terkirim dari  ke  sebagai gagal .  akan meneruskan  mengenai reversal process ke  untuk ditangani lebih lanjut oleh  sebagai update  menjadi failed/cancel.  pelajari lebih lanjut mengenai Penyelesaian Transaksi Pada VA.



Sample for VA Notification


Sample POST for VA Notification