NICEPAY API
...
API Versi 2
Checkout API

Notification - API Checkout

9min

Tentang API Checkout Notification





 mengirimkan push notification melalui dbProcessUrl

.

harus memastikan tidak melakukan Blacklist IP

dan melakukan Whitelist IP

untuk mendapatkan push notification

hanya dikirim dari server

.



API Checkout Notification



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

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

tXid

N

30

Transaction ID



merchantToken

AN

255



 Token



referenceNo

ANS

40



 Order Number



payMethod

N

2



amt

N

12



 Amount



transDt

N

8

Transaction Date



transTm

N

6

Transaction Time



currency

A

3

Currency



goodsNm

AN

100

Goods Name



billingNm

A

100

Billing Name



matchCl

N

1



 Amount Match Flag:



status

A

1

Deposit Status: Notification Status Code

0 : Deposit

1 : Reversal



Ketika

 diterima pada dbProcessUrl

, kami sangat menyarankan

untuk melakukan verifikasi

kembali dengan menggunakan Status Inquiry - API Checkout.



Additional Parameter for Credit Card Notification

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

authNo

N

10

Approval Number



IssueBankCd

A

4



IssueBankNm

A

255

Issuing

 Name



acquBankCd

A

4



acquBankNm

A

255

Acquiring

 Name



cardNo

ANS

20

Card Number with Masking



cardExpYymm

N

4

Card Expiration (YYMM)



instmntMon

N

2

Installment Month 1: 1 Month/Full

, jika instmntType: null/1 3: 3 Months 6: 6 Months 12: 12 Months



instmntType

N

2



preauthToken

AN

255

Pre-Auth Token



recurringToken

AN

255

Recurring token



ccTransType

A

2

1 : Normal

2 : Recurring

3 : Pre-Auth

4 : Captured



vat

N

12



 Number



fee

N

12

Service Fee



notaxAmt

N

12

Tax Free Amount



Additional Parameter for Virtual Account Notification

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

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)



Additional Parameter for Others Payment Method Notification

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

mitraCd

A

4

Mitra Code



payNo

N

12



 Number



payValidDt

N

8

Expiry Date (YYYYMMDD)



payValidTm

N

6

Expiry Time (HH24MISS)



receiptCode

ANS

20

Authorization Number



mRefNo

AN

18

Reference Number



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.



Sample for Notification Parameter


Sample POST for Notification