NICEPAY API
...
API Versi 2
Checkout API

Notification - API Checkout

9min

Tentang API Checkout Notification



NICEPAY mengirimkan push notification melalui dbProcessUrl Merchant. Merchant harus memastikan tidak melakukan Blacklist IP NICEPAY dan melakukan Whitelist IP NICEPAY untuk mendapatkan push notification yang hanya dikirim dari server NICEPAY.



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

Merchant Token



referenceNo

ANS

40

Merchant Order Number



payMethod

N

2



amt

N

12

Payment 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

Payment Amount Match Flag:



status

A

1

Deposit Status: Notification Status Code

0 : Deposit

1 : Reversal



Ketika notifikasi diterima pada dbProcessUrl Anda, kami sangat menyarankan Merchant untuk melakukan verifikasi notifikasi 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 Bank Name



acquBankCd

A

4



acquBankNm

A

255

Acquiring Bank Name



cardNo

ANS

20

Card Number with Masking



cardExpYymm

N

4

Card Expiration (YYMM)



instmntMon

N

2

Installment Month 1: 1 Month/Full Payment, 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

VAT 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

Bank 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

Payment 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 yang diterima dari Notification, Merchant harus melakukan perbandingan kembali secara internal untuk mencegah notifikasi palsu/tidak berlaku.



Sample for Notification Parameter


Sample POST for Notification