Payment - API GPN

8 min

About API GPN Payment

API Payment on the GPN method used by the Merchant to receive payment from all Bank-own cards with the GPN logo.

API GPN Payment

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

Request Parameter for GPN Payment

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

Sample Request for GPN Payment

nicePay.setTimeStamp("20201202110197");
nicePay.settXid("IONPAYTEST01201804191202084760");
nicePay.setMerchantToken(nicePay.getMerchantToken());
nicePay.setCardNo("4222222222222222");
nicePay.setCardExpYymm("2406");
nicePay.setCardCvv("123");
nicePay.setCardHolderNm("Thomas Alfa Edison");
nicePay.setCallBackUrl("http://merchant.com/callbackUrl");

// Payment Request
nicePay.payment();

CallBack Handling for GPN Payment

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.

https://merchat.co.id/nicepay-callback?resultCd=0000&resultMsg=SUCCESS&tXid=IONPAYTEST01202212141112221428&referenceNo=815123412341&payMethod=09&amt=10000&transDt=20221214&transTm=111222&description=test+gpn&authNo=221428&issuBankCd=OTHR&acquBankCd=BNIN&cardNo=62210082****0590&receiptCode=&mitraCd=&recurringToken=&preauthToken=&currency=IDR&goodsNm=Test+Transaction+Nicepay&billingNm=John+Doe&ccTransType=1&mRefNo=&instmntType=1&instmntMon=1&cardExpYymm=2612&issuBankNm=&acquBankNm=BNI&timeStamp=20221214111238&merchantToken=e1e78e6636ca06834b1bd0ed7d21d4ebae7a1de07b22f5fc22d2ac2dd198b989