NICEPAY API V2 Notification - API Checkout

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
﻿Payment Method Code﻿ 
﻿
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:
﻿Notification Match Amount Indicator﻿﻿
﻿
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
﻿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 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
﻿Installment Type Code﻿﻿
﻿
preauthToken
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
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
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}
depositDt = {depositDt}
depositTm = {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}
depositDt = {depositDt}
depositTm = {depositTm}
payNo={payNo}
﻿
﻿

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

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

Notification - API Checkout

Tentang API Checkout Notification

API Checkout Notification

Notification Parameter

Additional Parameter for Credit Card Notification

Additional Parameter for Virtual Account Notification

Additional Parameter for Others Payment Method Notification

Sample for Notification Parameter

Selamat Datang di NICEPAY DOCS