Payment - API GPN

8min

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

Updated 18 Sep 2024

Did this page help you?

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