NICEPAY API
API Versi 1

V1 Notification

9min

Tentang Notification





 memberikan

push notification secara real-time melalui dbProcessUrl 

diberikan

. Untuk menghindari terjadinya Notifikasi

terblokir oleh firewall

, silakan menambahkan Server

ke dalam Whitelist:

Method

Merchant Token

IP

User Agent

POST application/x-www-form-urlencoded

SHA256(iMid+tXid+amt+merchantKey)

103.20.51.0/24

103.117.8.0/24

User-Agent: Jakarta Commons-HttpClient/3.1

POST Notifikasi dari NICEPAY




API Notification



Ketika Notifikasi sudah diterima dbProcessUrl, sangat disarankan bagi

 untuk melakukan verifikasi menggunakan V1 Check Transaction Status.

Parameter

Tipe

Ukuran

Deskripsi

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

30

Billing Name

matchCl

N

1

status

A

1

Deposit Status: 0: Deposit 1: Reversal

Additional Parameter for Credit Card Notification

Parameter

Tipe

Ukuran

Deskripsi

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 Expiry (YYMM)

instmntMon

N

2

Installment Month

instmntType

N

2

reauthToken

AN

255

Pre-Auth Token

recurringToken

AN

255

Recurring token

ccTransType

A

2

Credit Card Trans type: 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

bankCd

A

4

Bank Code

vacctNo

N

16



 VA Number

vacctValidDt

N

8

VA Expired Date (YYYYMMDD)

vacctValidTm

N

6

VA Expired Time (HH24MISS)

Additional Parameter for QRIS Notification

Parameter

Tipe

Ukuran

Deskripsi

paymentTrxSn

AN

32

Nomor Pembayaran Transaksi

userId

AN

128

Hash ID Pengguna



shopId

AN

32

Shop ID

Additional Parameter for Others Payment Method Notification

Parameter

Tipe

Ukuran

Deskripsi

mitraCd

A

4

Mitra Code

payNo

N

12

Nomor Pembayaran CVS

payValidDt

N

8

Batas Tanggal CVS (YYYYMMDD)

payValidTm

N

6

Batas Waktu CVS (HH24MISS)

receiptCode

ANS

20

Authorization Number

mRefNo

AN

18

Reference Number



 Token

diterima oleh Endpoint Notifikasi

harus melalui validasi secara internal untuk mencegah Notifikasi palsu.