Full Payment & Installment - Payment API Credit Card

11min

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
cardHolderEmail
Required﻿
ANS
100
Card Holder Email
[email protected]
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("[email protected]");
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
cardHolderEmail Required	ANS	100	Card Holder Email	[email protected]
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

Updated 03 Sep 2024

Did this page help you?

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