V1 Notification

9 min

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
tXid={tXid}  
referenceNo={referenceNo}  
amt={amt}  
merchantToken={merchantToken}  
matchCl={matchCl}
status={status}
bankCd={bankCd}
vacctNo={vacctNo}
authNo={authNo}
cardNo={cardNo}
issuBankCd = {issuBankCd}
issuBankNm = {issuBankNm}
acquBankCd = {acquBankCd}
acquBankNm = {acquBankNm}
transDt = {depositDt}
transTm = {depositTm}
payNo={payNo}
tXid={tXid}  
referenceNo={referenceNo}  
amt={amt}  
merchantToken={merchantToken}  
matchCl={matchCl}
status={status}
bankCd={bankCd}
vacctNo={vacctNo}
authNo={authNo}
cardNo={cardNo}
issuBankCd = {issuBankCd}
issuBankNm = {issuBankNm}
acquBankCd = {acquBankCd}
acquBankNm = {acquBankNm}
transDt = {depositDt}
transTm = {depositTm}
payNo={payNo}
﻿
﻿
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
﻿Payment Method﻿﻿
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
﻿Payment Flag﻿
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
﻿Issuing Bank Code﻿﻿
IssueBankNm
A
255
Issuing ﻿ Name
acquBankCd
A
4
﻿Acquiring Bank Code﻿﻿
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
﻿Installment Type﻿﻿
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.
﻿

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

Parameter	Tipe	Ukuran	Deskripsi
tXid	N	30	Transaction ID
merchantToken	AN	255	Token
referenceNo	ANS	40	Order Number
payMethod	N	2	Payment Method
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	Payment Flag
status	A	1	Deposit Status: 0: Deposit 1: Reversal

Parameter	Tipe	Ukuran	Deskripsi
authNo	N	10	Approval Number
IssueBankCd	A	4	Issuing Bank Code
IssueBankNm	A	255	Issuing Name
acquBankCd	A	4	Acquiring Bank Code
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	Installment Type
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

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)

Parameter	Tipe	Ukuran	Deskripsi
paymentTrxSn	AN	32	Nomor Pembayaran Transaksi
userId	AN	128	Hash ID Pengguna
shopId	AN	32	Shop ID

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

V1 Cancel Transaction

V1 NICEPAY Code

V1 Notification

Tentang Notification

API Notification

Additional Parameter for Credit Card Notification

Additional Parameter for Virtual Account Notification

Additional Parameter for QRIS Notification

Additional Parameter for Others Payment Method Notification

Selamat Datang di NICEPAY DOCS