Payment - API GPN
API Payment on the GPN method used by the Merchant to receive payment from all bank-own cards with the GPN logo.
Payment GPN aims to activate the GPN payment method on Merchants. This step uses to integrate the Merchant system with the NICEPAY system.
API Endpoint | /nicepay/direct/v2/payment |
Request Method | POST |
Description | Performs Transaction Regist to NICEPAY |
Merchant Token | SHA256(timeStamp+iMid+referenceNo+amt+merchantKey) |
Request Format | application/json |
The following is a list of parameters for perform payment integration process for GPN payment method. This parameter used through API testing platform as one of the step so the Merchant sytem able to connect with NICEPAY service.
Parameter | Type | Size | Description | Example/Notes |
timeStamp Required | N | 14 | Request Timestamp (YYYYMMDDHH24MISS) | 20201202110197 |
tXid Required | AN | 30 | Transaction ID | IONPAYTEST01201804191202084760 |
cardNo Required | N | 20 | Credit Card Number | 4222222222222222 |
cardExpYymm Required | A | 4 | Card Expiry (YYMM) | 2406 |
cardCvv Required | N | 4 | Card CVV | 123 |
cardHolderNm Required | A | 50 | Card Holder Name | Thomas Alfa Edison |
merchantToken Required | AN | 255 | Merchant Token | f9d30f6c972e2b5718751bd087b178534673a91bbac845f8a24e60e8e4abbbc5 |
callBackUrl Required | ANS | 255 | Payment Result URL | http://merchant.com/callbackUrl |
After the transaction occurs, You will receive a notification from us compatible with the Callback URL You input on the parameter request on Payment - API GPN.
When Your callback already received callbackUrl, we recommended the Merchant to do the status verification using the Status Inquiry - API GPN.
Callback Handling is very important to minimize the Fraud act, we highly recommend the Merchant to do the verification using CallBack Handling