Full Payment & Installment - Payment API Credit Card

11 min

About Full Payment & Installment - Payment API Credit Card
﻿
This ﻿ uses after finishing ﻿ ﻿ Full Payment & Installment - Registration API Credit Card﻿. ﻿ used in this stage is similar to ﻿ ﻿ for ﻿ Recurring Token and Pre-Auth & Capture ﻿ type. However, there are several differences in ﻿ sent request ﻿.
﻿
Full Payment & Installment - Payment API Credit Card
﻿


API Endpoint
/nicepay/direct/v2/payment
Request Method
﻿POST﻿
Description
Full ﻿ & Installment - ﻿ ﻿ ﻿
Merchant Token
SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)
Request Format
application/x-www-form-urlencoded
On ﻿ ﻿ ﻿, if 3Ds authentication is needed, your ﻿ will direct to ﻿ 3Ds card Issuer ﻿ ﻿ to input ﻿ OTP (One Time Password) code to finish ﻿ ﻿ ﻿.
﻿
Request Parameter for Credit Card Payment
﻿
The following is ﻿ list of request ﻿s to ﻿ ﻿ ﻿ ﻿ on ﻿ ﻿ Full ﻿ & Installment ﻿. Request Parameter ﻿s through Form-Url with ﻿ following detailed ﻿.
Parameter
Type
Size
Description
Example / Notes
timeStamp
﻿Required﻿
N
14
Request Timestamp (YYYYMMDDHH24MISS)
20221202141217
tXid
﻿Required﻿
AN
30
Transaction ID	
IONPAYTEST01202212021455054652
referenceNo
N
40
Reference Number for ﻿ 
ordNo20221202141217
cardNo
Required for CC 
﻿
N
20
﻿﻿ Number
4434260000000008
cardExpYymm
Required for CC ﻿
﻿
A
4
Card Expiry (YYMM)	
3901
cardCvv
Required for CC﻿
N
4
Card CVV
101
cardHolderNm
Required 
﻿
AN
45
Card Holder Name
John Doe
﻿
Only alphabet allowed

cardHolderEmail
Required﻿
ANS
100
Card Holder Email
johndoe@gmail.com
merchantToken
Required
﻿
AN
255
﻿﻿ Token
c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae
callBackUrl
Required
﻿
ANS
255
﻿﻿ Result URL
https://merchant.com/callBackUrl
Parameter needed in ﻿ ﻿ ﻿ is ﻿ Your ﻿ Credit/Debit card data such as  cardNo, cardExpYymm, cardCvv, cardHolderNm & cardHolderEmail.
So, to do ﻿ ﻿ ﻿, we suggest You get ﻿ card data from Your ﻿ beforehand before doing ﻿ ﻿ ﻿ ﻿.
Include cardCVV on every ﻿ depending on ﻿ MID type of CVV or Non-CVV.
﻿
Response Parameter for Credit Card Payment
﻿
After you request, you will get a response from URL Callback with ﻿ following detailed response ﻿.
Parameter
Type
Size
Description
Example / Notes
resultCd
N
14
﻿Result Code﻿﻿
﻿
resultMsg
AN
255
Result message: Error Code﻿﻿
﻿
tXid
AN
30
Transaction ID	
When success
referenceNo
ANS
40
﻿﻿ Order Number
When success
payMethod
N
2
﻿Payment Method Code﻿﻿
When success
amt
N
12
﻿﻿ Amount	
When success
currency
AN
3
Currency
When success
goodsNm
A
100
Goods Name	
When success
billingNm
A
100
Buyer Name	
When success
transDt
N
8
Transaction Date (YYYYMMDD)
When success
transTm
N
6
Transaction Time (HH24MISS)	
When success
description
AN
100
Transaction Description	
When success
authNo
N
10
Approval Number	
When success, CC
issuBankCd
A
4
﻿Issuing Bank Code﻿﻿
When success, CC
acquBankCd
A
4
﻿Acquiring Bank Code﻿﻿
When success, CC
cardNo
ANS
20
Masked Card No	
When success, CC
cardExpYymm
N
4
Card Expiry (YYMM)	
When success, CC
instmntMon
N
2
Installment Month	
When success, CC
instmntType
N
2
﻿Installment Type Code﻿﻿
When success, CC
ccTransType
N
2
﻿Credit Card Transaction Type﻿﻿
1: Normal
2: Recurring
3: Pre-Auth
4: Capture
When Success, CC

﻿

Sample Request JSON for Credit Card Payment
﻿
Form-UrlEncoded
Java Request
//Credit Card Payment//
nicePay.setTimeStamp("20221202141217");
nicePay.settXid("IONPAYTEST01202212021455054652");
nicePay.setReferenceNo("ordNo20221202141217");
nicePay.setMerchantToken(nicePay.makeToken(nicePay.getMerchantToken());
nicePay.setCardNo("4434260000000008");
nicePay.setCardExpYymm("3901");
nicePay.setCardCvv("101");
nicePay.setCardHolderNm("John Doe");
nicePay.setCardHolderEmail("johndoe@gmail.com");
nicePay.setCallBackUrl("https://www.merchant.com/callbackUrl/");

// Request Credit Card Payment
nicePay.ccPayment();

// Response String //
System.out.println("Final Response String : " + nicePay.getResponseString());

String resultCd = nicePay.get("resultCd");
String resultMsg = nicePay.get("resultMsg");
String timeStamp = nicePay.get("timeStamp");
String tXid = nicePay.get("tXid");
String referenceNo = nicePay.get("referenceNo");
String payMethod = nicePay.get("payMethod");
String amt = nicePay.get("amt");
String merchantToken = nicePay.get("merchantToken");
String transDt = nicePay.get("transDt");
String transTm = nicePay.get("transTm");
String authNo = nicePay.get("authNo");
String acquBankCd = nicePay.get("acquBankCd");
String issuBankCd = nicePay.get("issuBankCd");
String acquBankNm = nicePay.get("acquBankNm");
String issuBankNm = nicePay.get("issuBankNm");
String cardNo = nicePay.get("cardNo");
String cardExpYymm = nicePay.get("cardExpYymm");
String currency = nicePay.get("currency");
String goodsNm = nicePay.get("goodsNm");
String billingNm = nicePay.get("billingNm");
String ccTransType = nicePay.get("ccTransType");
String instmntType = nicePay.get("instmntType");
//Credit Card Payment//
nicePay.setTimeStamp("20221202141217");
nicePay.settXid("IONPAYTEST01202212021455054652");
nicePay.setReferenceNo("ordNo20221202141217");
nicePay.setMerchantToken(nicePay.makeToken(nicePay.getMerchantToken());
nicePay.setCardNo("4434260000000008");
nicePay.setCardExpYymm("3901");
nicePay.setCardCvv("101");
nicePay.setCardHolderNm("John Doe");
nicePay.setCardHolderEmail("johndoe@gmail.com");
nicePay.setCallBackUrl("https://www.merchant.com/callbackUrl/");

// Request Credit Card Payment
nicePay.ccPayment();

// Response String //
System.out.println("Final Response String : " + nicePay.getResponseString());

String resultCd = nicePay.get("resultCd");
String resultMsg = nicePay.get("resultMsg");
String timeStamp = nicePay.get("timeStamp");
String tXid = nicePay.get("tXid");
String referenceNo = nicePay.get("referenceNo");
String payMethod = nicePay.get("payMethod");
String amt = nicePay.get("amt");
String merchantToken = nicePay.get("merchantToken");
String transDt = nicePay.get("transDt");
String transTm = nicePay.get("transTm");
String authNo = nicePay.get("authNo");
String acquBankCd = nicePay.get("acquBankCd");
String issuBankCd = nicePay.get("issuBankCd");
String acquBankNm = nicePay.get("acquBankNm");
String issuBankNm = nicePay.get("issuBankNm");
String cardNo = nicePay.get("cardNo");
String cardExpYymm = nicePay.get("cardExpYymm");
String currency = nicePay.get("currency");
String goodsNm = nicePay.get("goodsNm");
String billingNm = nicePay.get("billingNm");
String ccTransType = nicePay.get("ccTransType");
String instmntType = nicePay.get("instmntType");
﻿
﻿
CallBack Handling for Credit Card Payment
﻿
After ﻿ ﻿ occurs, You will get a ﻿ from us based on ﻿ inputted Callback URL in ﻿ request ﻿ on Payment - API Credit Card﻿.
When Your callback already received callbackUrl, we recommended ﻿ ﻿ to do ﻿ ﻿ verification using ﻿ Status Inquiry - API Credit Card﻿.
CallBack Handling is very important to minimize ﻿ Fraud act, we highly recommend ﻿ ﻿ to do ﻿ verification using callBack Handling.
URL CallBack
Response CallBack
{
    "resultCd":"0000",
    "resultMsg":"SUCCESS",
    "tXid":"IONPAYTEST01202212141112221428",
    "referenceNo":"",
    "payMethod":"01",
    "amt":"10000",
    "transDt":"20221212",
    "transTm":"121212",
    "description":"Testing Credit Card Transaction",
    "authNo":"080623",
    "issuBankCd":"OTHR"
    "acquBankCd":"BMRI",
    "cardNo":"453211*****1111",
    "goodsNm":"Test Transaction Nicepay"
    "billingNm":"John Doe",
    "currency":"IDR",
    "timeStamp":"20221212121212",
    "merchantToken":"2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6",
    "cardExpYymm":"2712",
    "instmntMon":"1",
    "instmntType":"1",
    "ccTransType":"1"
}
{
    "resultCd":"0000",
    "resultMsg":"SUCCESS",
    "tXid":"IONPAYTEST01202212141112221428",
    "referenceNo":"",
    "payMethod":"01",
    "amt":"10000",
    "transDt":"20221212",
    "transTm":"121212",
    "description":"Testing Credit Card Transaction",
    "authNo":"080623",
    "issuBankCd":"OTHR"
    "acquBankCd":"BMRI",
    "cardNo":"453211*****1111",
    "goodsNm":"Test Transaction Nicepay"
    "billingNm":"John Doe",
    "currency":"IDR",
    "timeStamp":"20221212121212",
    "merchantToken":"2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6",
    "cardExpYymm":"2712",
    "instmntMon":"1",
    "instmntType":"1",
    "ccTransType":"1"
}
﻿
﻿

API Endpoint	/nicepay/direct/v2/payment
Request Method	POST
Description	Full & Installment -
Merchant Token	SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)
Request Format	application/x-www-form-urlencoded

Parameter	Type	Size	Description	Example / Notes
timeStamp Required	N	14	Request Timestamp (YYYYMMDDHH24MISS)	20221202141217
tXid Required	AN	30	Transaction ID	IONPAYTEST01202212021455054652
referenceNo	N	40	Reference Number for	ordNo20221202141217
cardNo Required for CC	N	20	Number	4434260000000008
cardExpYymm Required for CC	A	4	Card Expiry (YYMM)	3901
cardCvv Required for CC	N	4	Card CVV	101
cardHolderNm Required	AN	45	Card Holder Name	John Doe Only alphabet allowed
cardHolderEmail Required	ANS	100	Card Holder Email	johndoe@gmail.com
merchantToken Required	AN	255	Token	c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae
callBackUrl Required	ANS	255	Result URL	https://merchant.com/callBackUrl

Parameter	Type	Size	Description	Example / Notes
resultCd	N	14	Result Code
resultMsg	AN	255	Result message: Error Code
tXid	AN	30	Transaction ID	When success
referenceNo	ANS	40	Order Number	When success
payMethod	N	2	Payment Method Code	When success
amt	N	12	Amount	When success
currency	AN	3	Currency	When success
goodsNm	A	100	Goods Name	When success
billingNm	A	100	Buyer Name	When success
transDt	N	8	Transaction Date (YYYYMMDD)	When success
transTm	N	6	Transaction Time (HH24MISS)	When success
description	AN	100	Transaction Description	When success
authNo	N	10	Approval Number	When success, CC
issuBankCd	A	4	Issuing Bank Code	When success, CC
acquBankCd	A	4	Acquiring Bank Code	When success, CC
cardNo	ANS	20	Masked Card No	When success, CC
cardExpYymm	N	4	Card Expiry (YYMM)	When success, CC
instmntMon	N	2	Installment Month	When success, CC
instmntType	N	2	Installment Type Code	When success, CC
ccTransType	N	2	Credit Card Transaction Type 1: Normal 2: Recurring 3: Pre-Auth 4: Capture	When Success, CC

Payment - API Credit Card

Recurring - Payment API Credit Card

Full Payment & Installment - Payment API Credit Card

About Full Payment & Installment - Payment API Credit Card

Full Payment & Installment - Payment API Credit Card

Request Parameter for Credit Card Payment

Response Parameter for Credit Card Payment

Sample Request JSON for Credit Card Payment

CallBack Handling for Credit Card Payment

Welcome to NICEPAY DOCS