Payment - API GPN

8 min

About API GPN Payment
﻿
﻿﻿ ﻿ on ﻿ ﻿ method used by ﻿ ﻿ to receive ﻿ from all ﻿-own cards with ﻿ ﻿ logo.
﻿
API GPN Payment
﻿
﻿﻿ GPN aims to activate ﻿ ﻿ ﻿ on ﻿s. This step uses to integrate ﻿ ﻿ ﻿ with ﻿ ﻿ ﻿.
API Endpoint
/nicepay/direct/v2/payment
Request Method
﻿POST﻿
Description
Performs Transaction Regist to ﻿
Merchant Token
SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)
Request Format
application/json
﻿
Request Parameter for GPN Payment
﻿
The following is a list of ﻿s for perform ﻿ ﻿ ﻿ for ﻿ ﻿. This ﻿ used through ﻿ ﻿ platform as one of ﻿ step so ﻿ ﻿ ﻿ able to connect with ﻿ ﻿. 
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
﻿﻿ 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
﻿﻿ Token
f9d30f6c972e2b5718751bd087b178534673a91bbac845f8a24e60e8e4abbbc5
callBackUrl
Required
﻿
ANS
255
﻿﻿ Result URL
http://merchant.com/callbackUrl
﻿
Sample Request for GPN Payment 
﻿
Form-UrlEncoded
Java Request
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();


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 ﻿ ﻿ occurs, You will receive a ﻿ from us compatible with ﻿ Callback URL You input on ﻿ ﻿ request on Payment - API GPN﻿.
When Your callback already received callbackUrl, we recommended ﻿ ﻿ to do ﻿ ﻿ verification using ﻿ Status Inquiry - API GPN﻿.  
Callback Handling is very important to minimize ﻿ Fraud act, we highly recommend ﻿ ﻿ to do ﻿ verification using CallBack Handling.
UrlCallback
Response Body
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
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
﻿
﻿

API Endpoint	/nicepay/direct/v2/payment
Request Method	POST
Description	Performs Transaction Regist to
Merchant Token	SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)
Request Format	application/json

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	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	Token	f9d30f6c972e2b5718751bd087b178534673a91bbac845f8a24e60e8e4abbbc5
callBackUrl Required	ANS	255	Result URL	http://merchant.com/callbackUrl

Registration - API GPN

Status Inquiry - API GPN

Payment - API GPN

About API GPN Payment

API GPN Payment

Request Parameter for GPN Payment

Sample Request for GPN Payment

CallBack Handling for GPN Payment

Welcome to NICEPAY DOCS