NICEPAY API V1 Notification

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
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 No.
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 No. 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
Vat 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 No.
﻿
﻿ Token 
﻿ diterima oleh Endpoint Notifikasi 
﻿ harus melalui validasi secara internal untuk mencegah Notifikasi palsu.
﻿

Bank Indonesia telah menerbitkan Standar API terkait Pembayaran yang tercantum dalam Peraturan Anggota Dewan Gubernur No 23/15/PADG/2021 tentang Implementasi Standar Nasional Open Application Interface Pembayaran (SNAP).

Sebagai bentuk dukungan dan kepatuhan terhadap Peraturan Bank Indonesia, NICEPAY mendorong seluruh merchant untuk melakukan migrasi ke API SNAP BI.

Seluruh Merchant ditargetkan untuk dapat menyelesaikan migrasi API SNAP BI pada Juni 2024.

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 No.
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

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