Notification - API Credit Card
NICEPAY sent push notifications through Merchant's dbProcessUrl. The Merchant needs to reassure there is no Blacklist NICEPAY IP and should Whitelist NICEPAY IP to get the push notification only from NICEPAY's server.
Request 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 |
When your dbProcessUrl received a notification, NICEPAY strongly recommend Merchant to verify the notification using the Status Inquiry - API Credit Card.
Parameter | Type | Size | Description | Example / Notes |
tXid | N | 30 | Transaction ID | |
merchantToken | AN | 255 | Merchant Token | |
referenceNo | ANS | 40 | Merchant Order No | |
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 Flag: Notification Match Amount Indicator | |
status | A | 1 | | |
cpGuaranteeableStatus | N | 2 | Cp Guaranteeable Status | |
Parameter | Type | Size | Description | Example / Notes |
authNo | N | 10 | Approval number | |
IssueBankCd | A | 4 | | |
IssueBankNm | A | 100 | Issuing bank name | |
acquBankCd | A | 4 | | |
acquBankNm | A | 4 | Acquiring bank name | |
cardNo | ANS | 20 | Card no with masking | |
cardExpYymm | N | 4 | Card expiry (YYMM) | |
instmntMon | N | 2 | Installment month | |
instmntType | N | 2 | | |
preauthToken | AN | 255 | Preauth Token | |
recurringToken | AN | 255 | Recurring token | |
ccTransType | A | 2 | | |
vat | N | 12 | Vat number | |
fee | N | 12 | Service fee | |
notaxAmt | N | 12 | Tax free amount | |
Merchant Tokens that received from the Notification, Merchant must have an internal comparison to prevent fake/invalid notifications.