Credit Card - API Checkout

33min

About Credit Card - API Checkout
﻿
There are several things that you must know when using 
﻿ 
﻿ for 
﻿ method so that your 
﻿ 
﻿ will run smoothly with us:
Flow 3Ds/Non-3Ds Process.
Full 
﻿ Feature.
Installment Feature.
Recurring Token Feature.
Pre-Auth Token Feature.
﻿
Process Flow
﻿
﻿
﻿ visit 
﻿ Credit Card Feature﻿ 
﻿ to check 
﻿ explanation about 3Ds.
3Ds
CC Payment Flow - Redirect 3Ds
﻿
Description steps of Redirect 
﻿ 
﻿ flow with 3Ds:
The 
﻿ does 
﻿.
The 
﻿ sends 
﻿ data to 
﻿ 
﻿.
The 
﻿ requests 
﻿ using Registration 
﻿ to 
﻿.
﻿
﻿ registers 
﻿ 
﻿ data.
﻿
﻿ redirects 
﻿ to 
﻿ 
﻿'s 
﻿ 
﻿.
The 
﻿ sends 
﻿ 
﻿'s 
﻿ 
﻿ to 
﻿ 
﻿.
The 
﻿ selects 
﻿ 
﻿.
The 
﻿ inputs 
﻿ card data.
The 
﻿ sends 
﻿ 
﻿ of card data to 
﻿.
﻿
﻿ 
﻿s with 
﻿ FDS calculation.
﻿
﻿ requests 3Ds to 
﻿.
﻿
﻿ validates 
﻿ 3Ds.
﻿
﻿ sends 3Ds URL response to 
﻿.
﻿
﻿ receives 
﻿ verification response.
﻿
﻿ redirects 
﻿ 
﻿ to ACS authentication 
﻿.
﻿
﻿ creates OTP response.
﻿
﻿ sends OTP to 
﻿ 
﻿.
The 
﻿ receives OTP.
The 
﻿ inputs OTP.
The 
﻿ sends OTP to 
﻿.
﻿
﻿ verifies the OTP.
﻿
﻿ sends 3Ds result to 
﻿.
﻿
﻿ receives 
﻿ checking result.
﻿
﻿ requests 
﻿ 
﻿ to 
﻿.
﻿
﻿ 
﻿s 
﻿ 
﻿.
﻿
﻿ sends 
﻿ 
﻿ to 
﻿.
﻿
﻿ performs callbackUrl redirect to 
﻿ 
﻿.
The 
﻿ displays 
﻿ callbackUrl result to 
﻿ 
﻿.
﻿
﻿ sends 
﻿ 
﻿ to 
﻿ 
﻿.
The 
﻿ receives 
﻿ 
﻿.
The 
﻿ requests inquiry 
﻿ to 
﻿.
﻿
﻿ receives 
﻿ request.
﻿
﻿ automatically sends 
﻿ inquiry response to 
﻿ 
﻿.
The 
﻿ receives 
﻿ final 
﻿.
The 
﻿ sends 
﻿ 
﻿ result 
﻿ to 
﻿ 
﻿.
﻿
Non-3Ds
CC Payment Flow - Redirect N 3Ds
﻿
Description steps of Redirect 
﻿ 
﻿ flow with Non-3Ds:
The 
﻿ performs 
﻿.
The 
﻿ requests 
﻿ to 
﻿ 
﻿.
The 
﻿ registers 
﻿ 
﻿ data.
The 
﻿ sends 
﻿ response in 
﻿ form of card data form.
The 
﻿ requests 
﻿ to 
﻿ 
﻿.
The 
﻿ registers 
﻿ 
﻿ using Registration 
﻿ to 
﻿.
﻿
﻿ stores 
﻿ 
﻿ registration.
﻿
﻿ redirects 
﻿s to 
﻿ 
﻿'s 
﻿.
The 
﻿ sends 
﻿'s 
﻿ to 
﻿ 
﻿.
The 
﻿ selects 
﻿ 
﻿.
The 
﻿ inputs card detail.
The 
﻿ requests 
﻿ using 
﻿ 
﻿ to 
﻿.
﻿
﻿ 
﻿s with 
﻿ FDS calculation.
﻿
﻿ requests 
﻿ 
﻿ to 
﻿.
﻿
﻿ verifies 
﻿ request.
﻿
﻿ sends 
﻿ confirmation request to 
﻿ 
﻿.
The 
﻿ requests 
﻿/charge to 
﻿.
﻿
﻿ 
﻿s 
﻿ 
﻿.
﻿
﻿ sends 
﻿ response of 
﻿ to 
﻿.
﻿
﻿ sends 
﻿ notification using callBackUrl and dbProcessUrl to 
﻿ 
﻿.
The 
﻿ receives 
﻿ 
﻿.
The 
﻿ requests 
﻿ checking to 
﻿.
﻿
﻿ sends 
﻿ response of 
﻿ checking.
The 
﻿ receives 
﻿ final 
﻿.
The 
﻿ sends 
﻿ 
﻿ result to 
﻿ 
﻿.
﻿
NICEPAY Secure Payment Page
﻿
﻿
﻿ open 
﻿ Credit Card Payment Guide﻿ 
﻿ to provide your 
﻿ with 
﻿ guide on 
﻿ 
﻿ method.
Secure Payment Page
﻿
The image above is a 
﻿ sample with a 
﻿ using 
﻿ Secure 
﻿ Page.
After 
﻿ 
﻿ selects 
﻿ 
﻿ method, 
﻿ 
﻿ will ask to input their card data. 
﻿ 
﻿ will automatically recognize 
﻿ type of 
﻿'s BIN card like in 
﻿ picture below, such as VISA or Mastercard, American Express, etc, later 
﻿ cards will be different according to 
﻿ card types being used.
After completing 
﻿ card data input, Your 
﻿ can continue 
﻿ 
﻿ 
﻿.
Credit Secure Payment Page
﻿
Then, 
﻿ 
﻿ will run. Once 
﻿ 
﻿ is successful, then 
﻿ display of 
﻿ 
﻿ 
﻿ 
﻿ will appear as 
﻿ image as follows.
Success - NICEPAY Secure Payment Page
﻿
﻿
﻿ visit 
﻿ Payment - API Checkout﻿ 
﻿ to know 
﻿ next step regarding payment handling.
﻿
Full Payment Credit Card
﻿
On 
﻿ Full 
﻿ 
﻿, 
﻿ 
﻿ paid fully 
﻿ nominal billed at once. The following is 
﻿ details 
﻿ used on 
﻿ 
﻿.
Request Parameter Full Payment Credit Card
﻿
Parameter
Type
Size
Description
Remark
paymentURL  
﻿Required﻿
ANS
14
﻿
﻿ URL
﻿
https://dev.nicepay.co.id/nicepay/redirect/v2/payment
tXid 
﻿Required﻿
AN
30
Transaction ID	
﻿
IONPAYTEST00202203211640309389
For 
﻿ 
﻿ 
﻿, 
﻿ 
﻿ with Full 
﻿ and Installment got 
﻿ same response.
﻿
Response Parameters Full Payment Credit Card (CallbackUrl) - Payment
﻿

Parameter
Type
Size
Description
Remark
status
N
1
﻿Transaction Status﻿﻿
0
tXid
AN
30
Transaction ID
IONPAYTEST00202212201540174369
﻿
When Success
referenceNo
AN
40
﻿
﻿ Order Number
ordNo20221220151243
﻿
When Success
payMethod
N
2
﻿Payment Method Code﻿﻿
01
﻿
When Success
amt
N
12
Transaction Amount
1000
﻿
When Success
notaxAmt
N
12
Tax Fee Amount
0
﻿
When Success
vat
N
12
Value Added Tax (
﻿)
0
﻿
When Success
fee
N
12
Service Fee
0
﻿
When Success
currency
A
3
Currency
IDR
﻿
When Success
goodsNm
AN
100
Goods Name
Goods+For+Testing+Credit+Card
﻿
When Success
billingNm
A
100
Billing Name
John+Doe
﻿
When Success
transDt
N
8
Transaction Date (YYYYMMDD)	
20221220
﻿
When Success
transTm
N
6
Transaction Time (HH24MISS)	
154017
﻿
When Success
authNo
N
10
Approval Number
174300
﻿
When Success (Additional)
issuBankCd
A
4
﻿Issuing Bank Code﻿﻿
BMRI
﻿
When Success
acquBankCd
A
4
﻿Acquiring Bank Code﻿﻿
BMRI
﻿
When Success
issuBankNm
A
255
Issuing 
﻿ Name
Mandiri
﻿
When Success
acquBankNm
A
255
Acquiring 
﻿ Name
Mandiri
﻿
When Success
ccTransType
AN
﻿
2
﻿Credit Card Transaction Type:﻿﻿
1: Normal
2: Recurring
3: Pre-Auth
4: Capture
1
﻿
When Success
cardNo
ANS
20
Card Number with Masking
46161111****1111
﻿
When Success
cardExpYymm
N
4
Card Expiration (YYMM)
2707
﻿
When Success
instmntType
N
2
﻿Installment Type Code﻿﻿
1
﻿
When Success
instmntMon
N
2
Installment Month 
1: 1 Month/Full 
﻿, if instmntType: null/1
3: 3 Months
6: 6 Months
12: 12 Months
1
﻿
When Success
recurringToken
AN
255
Recurring Token
null
﻿
When Success
preauthToken
AN
255
Pre-Auth Token
null
﻿
When Success
matchCl
N
1
﻿Notification Match Amount Indicator﻿﻿
1
﻿
When Success
merchantToken
AN
255
﻿
﻿ Token
8f5b330a549c167b53b4b9fd5f2d2eba897a64235c1610524074ec59f8884e8a
﻿

Sample Parameter for CallbackUrl API Checkout Payment
﻿
URL Request
URL Callback
Response Callback
https://dev.nicepay.co.id/nicepay/redirect/v2/payment?tXid=IONPAYTEST00202203211640309389
https://dev.nicepay.co.id/nicepay/redirect/v2/payment?tXid=IONPAYTEST00202203211640309389
﻿
Note: Response 
﻿ will be sent through callBackurl with Content-type: application/json and method: POST Parameter.
For 
﻿ 
﻿ 
﻿ 
﻿ on 
﻿ 
﻿, 
﻿ Response from Request received after performing Call Request 
﻿ is a callback URL.
﻿
API Checkout Transaction Payment
﻿
API URL
/nicepay/redirect/v2/payment
Request Method 
Redirect-GET
Header
﻿Content-Type: application/Form-UrlEncoded﻿
The endpoint above can use for 
﻿ 
﻿s with Full 
﻿, Recurring, and PAC (Pre-Auth Capture) types.
﻿
Recurring Token
﻿
After 
﻿ 
﻿ completes Registration - API Checkout﻿  and Payment - API Checkout﻿, then 
﻿ will provide recurringToken for 
﻿ gain Payment - API Checkout﻿ response.
On 
﻿ next 
﻿ with 
﻿ same 
﻿, 
﻿ can use that recurringToken by using on 
﻿ Recurring - Payment API Credit Card﻿.
﻿
Request Parameter Recurring Token

﻿
Parameter
Type
Size
Description
Remark
paymentURL  
﻿Required﻿
ANS
14
﻿
﻿ URL
﻿
https://dev.nicepay.co.id/nicepay/redirect/v2/payment
tXid 
﻿Required﻿
AN
30
Transaction ID	
﻿
RECURRTEST00202212221422115631
﻿
Response Parameter Recurring Token
﻿


Parameter
Type
Size
Description
Remark
status
N
1
﻿Transaction Status﻿﻿
0
tXid
AN
30
Transaction ID
RECURRTEST00202212221422115631
﻿
When Success
referenceNo
AN
40
﻿
﻿ Order Number
ordNo20221222141245
﻿
When Success
payMethod
N
2
﻿Payment Method Code﻿﻿
01
﻿
When Success
amt
N
12
Transaction Amount
1000
﻿
When Success
notaxAmt
N
12
Tax Fee Amount
0
﻿
When Success
vat
N
12
Value Added Tax ( 
﻿)
0
﻿
When Success
fee
N
12
Service Fee
0
﻿
When Success
currency
A
3
Currency
IDR
﻿
When Success
goodsNm
AN
100
Goods Name
Goods+For+Testing+Recurring+Token
﻿
When Success
billingNm
A
100
Billing Name
John+Doe
﻿
When Success
transDt
N
8
Transaction Date (YYYYMMDD)	
20221220
﻿
When Success
transTm
N
6
Transaction Time (HH24MISS)	
142211
﻿
When Success
authNo
N
10
Approval Number
115631
﻿
When Success (Additional)
issuBankCd
A
4
﻿Issuing Bank Code﻿﻿
OTHR
﻿
When Success
acquBankCd
A
4
﻿Acquiring Bank Code﻿﻿
﻿
BMRI
﻿
When Success
issuBankNm
A
255
Issuing 
﻿ Name
(empty)
﻿
When Success
acquBankNm
A
255
Acquiring 
﻿ Name
Mandiri
﻿
When Success
ccTransType
AN
﻿
2
﻿Credit Card Transaction Type:﻿﻿
1: Normal
2: Recurring
3: Pre-Auth
4: Capture
1
﻿
When Success
cardNo
ANS
20
Card Number with Masking
45321111****1111
﻿
When Success
cardExpYymm
N
4
Card Expiry (YYMM)
2712
﻿
When Success
instmntType
N
2
﻿Installment Type Code﻿﻿
1
﻿
When Success
instmntMon
N
2
Installment Month 
1: 1 Month/Full 
﻿, if instmntType: null/1
3: 3 Months
6: 6 Months
12: 12 Months
1
﻿
When Success
recurringToken
AN
255
Recurring Token
083333e129dea0535119b71813b1dc67b565e2704958411d2ee2ec2f430d745
﻿
When Success
preauthToken
AN
255
Pre-Auth Token
null
﻿
When Success
matchCl
N
1
﻿
﻿ Amount Match Flag: Notification Status Code﻿﻿
1
﻿
When Success
merchantToken
AN
255
﻿
﻿ Token
f083333e129dea0535119b71813b1dc67b565e2704958411d2ee2ec2f430d745
﻿
Sample Parameter Recurring Token Payment
﻿
URL Request
URL Callback
Response Callback
status=0
tXid=RECURRTEST00202212221422115631
referenceNo=ordNo20221222141245
payMethod=01
amt=1000
notaxAmt=0
vat=0
fee=0
currency=IDR
goodsNm=Goods+For+Testing+Recurring+Token
billingNm=John+Doe
transDt=20221220
transTm=142211
authNo=115631
issuBankCd=OTHR
acquBankCd=BMRI
issuBankNm=(empty)
acquBankNm=Mandiri
ccTransType=1
cardNo=45321111****1111
cardExpYymm=2712
instmntType=1
instmntMon=1
recurringToken=083333e129dea0535119b71813b1dc67b565e2704958411d2ee2ec2f430d745
preauthToken=null
matchCl=1
merchantToken=f083333e129dea0535119b71813b1dc67b565e2704958411d2ee2ec2f430d745
status=0
tXid=RECURRTEST00202212221422115631
referenceNo=ordNo20221222141245
payMethod=01
amt=1000
notaxAmt=0
vat=0
fee=0
currency=IDR
goodsNm=Goods+For+Testing+Recurring+Token
billingNm=John+Doe
transDt=20221220
transTm=142211
authNo=115631
issuBankCd=OTHR
acquBankCd=BMRI
issuBankNm=(empty)
acquBankNm=Mandiri
ccTransType=1
cardNo=45321111****1111
cardExpYymm=2712
instmntType=1
instmntMon=1
recurringToken=083333e129dea0535119b71813b1dc67b565e2704958411d2ee2ec2f430d745
preauthToken=null
matchCl=1
merchantToken=f083333e129dea0535119b71813b1dc67b565e2704958411d2ee2ec2f430d745
﻿
After 
﻿ing with 
﻿ registration (Registration - API Checkout﻿) and 
﻿ 
﻿ 
﻿ (Payment - API Checkout﻿) using 
﻿ 
﻿,
If you want to 
﻿ with 
﻿ 
﻿ Recurring using 
﻿ same Recurring Token, please do 
﻿ registration again on 
﻿ Registration - API Checkout﻿.
Then 
﻿s 
﻿ by adding 
﻿ Recurring Token also CVV on 
﻿ recurringToken 
﻿.
﻿
Pre-Auth Token
﻿
When 
﻿s sign a contract as PAC 
﻿ (Pre-Auth/Capture), 
﻿ provides a preauthToken for Payment - API Checkout﻿ response. That token will later use on capture amount 
﻿ to complete 
﻿ 
﻿ on Pre-Auth & Capture - Payment API Credit Card﻿.
﻿
Request Parameter Pre-Auth Token
﻿


The following are 
﻿ lists to perform requests with 
﻿ Pre-Auth Token 
﻿. This 
﻿ uses in 
﻿ 
﻿ 
﻿ platform as one of 
﻿ steps to connect 
﻿ 
﻿'s 
﻿s with 
﻿ 
﻿s.
Parameter
Type
Size
Description
Remark
paymentURL  
﻿Required﻿
ANS
14
﻿
﻿ URL
﻿
https://dev.nicepay.co.id/nicepay/redirect/v2/payment
tXid 
﻿Required﻿
AN
30
Transaction ID	
PACTEST00100202212221548525731
﻿
Response Parameter Pre-Auth Token
﻿
Parameter
Type
Size
Description
Remark
status
N
1
﻿Transaction Status﻿﻿
5
tXid
AN
30
Transaction ID
PACTEST00100202212221548525731
﻿
When Success
referenceNo
AN
40
﻿
﻿ Order Number
ordNo20221222151220
﻿
When Success
payMethod
N
2
﻿Payment Method Code﻿﻿
01
﻿
When Success
amt
N
12
Transaction Amount
1000
﻿
When Success
notaxAmt
N
12
Tax Fee Amount
0
﻿
When Success
vat
N
12
Value Added Tax (
﻿)
0
﻿
When Success
fee
N
12
Service Fee
0
﻿
When Success
currency
A
3
Currency
IDR
﻿
When Success
goodsNm
AN
100
Goods Name
Goods+For+Testing+Pre+-+Auth+Token
﻿
When Success
billingNm
A
100
Billing Name
John+Doe
﻿
When Success
transDt
N
8
Transaction Date (YYYYMMDD)	
20221222
﻿
When Success
transTm
N
6
Transaction Time (HH24MISS)	
154852
﻿
When Success
authNo
N
10
Approval Number
525731
﻿
When Success (Additional)
issuBankCd
A
4
﻿Issuing Bank Code﻿﻿
CENA
﻿
When Success
acquBankCd
A
44
﻿Acquiring Bank Code﻿﻿
BMRI
﻿
When Success
issuBankNm
A
255
Issuing 
﻿ Name
BCA
﻿
When Success
acquBankNm
A
255
Acquiring 
﻿ Name
Mandiri
﻿
When Success
ccTransType
AN
2
﻿Credit Card Transaction Type﻿﻿
1: Normal
2: Recurring
3: Pre-Auth
4: Capture
1
﻿
When Success
cardNo
ANS
20
Card Number with Masking
53079511****1111
﻿
When Success
cardExpYymm
N
4
Card Expiry (YYMM)
2712
﻿
When Success
instmntType
N
2
﻿Installment Type Code﻿﻿
1
﻿
When Success
instmntMon
N
2
Installment Month 
1: 1 Month/Full Payment, if instmntType: null/1
3: 3 Months
6: 6 Months
12: 12 Months
1
﻿
When Success
recurringToken
AN
255
Recurring Token
null
﻿
When Success
preauthToken
AN
255
Pre-Auth Token
edc46eb30a81ac9753e34003d2d1e910d5aaf0dea620889dffcfcc18621864eb
﻿
When Success
matchCl
N
1
﻿
﻿ Amount Match Flag: Notification Match Amount Indicator﻿﻿
1
﻿
When Success
merchantToken
AN
255
﻿
﻿ Token
1bee4b7c84cfb4e04d9d26cd47285bf49a77f252f39a48370094f5e3250b9524
Sample Parameter for Pre-Auth Token Payment
﻿
URL Request
URL Callback
Response Callback
status=5
tXid=PACTEST00100202212221548525731
referenceNo=ordNo20221222151220
payMethod=01
amt=1000
notaxAmt=0
vat=0
fee=0
currency=IDR
goodsNm=Goods+For+Testing+Pre+-+Auth+Token
billingNm=John+Doe
transDt=20221222
transTm=154852
authNo=525731
issuBankCd=CENA
acquBankCd=BMRI
issuBankNm=BCA
acquBankNm=Mandiri
ccTransType=1
cardNo=53079511****1111
cardExpYymm=2712
instmntType=1
instmntMon=1
recurringToken=null
preauthToken=edc46eb30a81ac9753e34003d2d1e910d5aaf0dea620889dffcfcc18621864eb
matchCl=1
merchantToken=1bee4b7c84cfb4e04d9d26cd47285bf49a77f252f39a48370094f5e3250b9524
status=5
tXid=PACTEST00100202212221548525731
referenceNo=ordNo20221222151220
payMethod=01
amt=1000
notaxAmt=0
vat=0
fee=0
currency=IDR
goodsNm=Goods+For+Testing+Pre+-+Auth+Token
billingNm=John+Doe
transDt=20221222
transTm=154852
authNo=525731
issuBankCd=CENA
acquBankCd=BMRI
issuBankNm=BCA
acquBankNm=Mandiri
ccTransType=1
cardNo=53079511****1111
cardExpYymm=2712
instmntType=1
instmntMon=1
recurringToken=null
preauthToken=edc46eb30a81ac9753e34003d2d1e910d5aaf0dea620889dffcfcc18621864eb
matchCl=1
merchantToken=1bee4b7c84cfb4e04d9d26cd47285bf49a77f252f39a48370094f5e3250b9524
﻿
After 
﻿s registration and 
﻿ using 
﻿ 
﻿, 
If you wants to 
﻿ with multiple-capture by using 
﻿ same Pre-Auth Token, please do 
﻿ registration again.
Then captures on 
﻿ Payment V2 Credit Card by adding 
﻿ Pre-Auth Token also 
﻿ CVV on 
﻿ preauthToken 
﻿.
﻿
CallBack Handling API Checkout Payment
﻿
The tXid won't be 
﻿ same as 
﻿ request hold. The capture 
﻿ will reassure that 
﻿ captured amount  value doesn't exceed 
﻿ funds owned.
When Your callback already received callbackUrl, we recommended 
﻿ 
﻿ to do 
﻿ 
﻿ verification using 
﻿ Status Inquiry - API Checkout﻿.
CallBack Handling is very important to minimize 
﻿ Fraud act, we highly recommend 
﻿ 
﻿ to do 
﻿ verification using callBack parameter. 
Callback Handling Flow
﻿
Callback Handling Flow
﻿
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"
}
﻿
﻿

Parameter	Type	Size	Description	Remark
paymentURL Required	ANS	14	URL	https://dev.nicepay.co.id/nicepay/redirect/v2/payment
tXid Required	AN	30	Transaction ID	IONPAYTEST00202203211640309389

Parameter	Type	Size	Description	Remark
status	N	1	Transaction Status	0
tXid	AN	30	Transaction ID	IONPAYTEST00202212201540174369 When Success
referenceNo	AN	40	Order Number	ordNo20221220151243 When Success
payMethod	N	2	Payment Method Code	01 When Success
amt	N	12	Transaction Amount	1000 When Success
notaxAmt	N	12	Tax Fee Amount	0 When Success
vat	N	12	Value Added Tax ( )	0 When Success
fee	N	12	Service Fee	0 When Success
currency	A	3	Currency	IDR When Success
goodsNm	AN	100	Goods Name	Goods+For+Testing+Credit+Card When Success
billingNm	A	100	Billing Name	John+Doe When Success
transDt	N	8	Transaction Date (YYYYMMDD)	20221220 When Success
transTm	N	6	Transaction Time (HH24MISS)	154017 When Success
authNo	N	10	Approval Number	174300 When Success (Additional)
issuBankCd	A	4	Issuing Bank Code	BMRI When Success
acquBankCd	A	4	Acquiring Bank Code	BMRI When Success
issuBankNm	A	255	Issuing Name	Mandiri When Success
acquBankNm	A	255	Acquiring Name	Mandiri When Success
ccTransType	AN	2	Credit Card Transaction Type: 1: Normal 2: Recurring 3: Pre-Auth 4: Capture	1 When Success
cardNo	ANS	20	Card Number with Masking	46161111****1111 When Success
cardExpYymm	N	4	Card Expiration (YYMM)	2707 When Success
instmntType	N	2	Installment Type Code	1 When Success
instmntMon	N	2	Installment Month 1: 1 Month/Full , if instmntType: null/1 3: 3 Months 6: 6 Months 12: 12 Months	1 When Success
recurringToken	AN	255	Recurring Token	null When Success
preauthToken	AN	255	Pre-Auth Token	null When Success
matchCl	N	1	Notification Match Amount Indicator	1 When Success
merchantToken	AN	255	Token	8f5b330a549c167b53b4b9fd5f2d2eba897a64235c1610524074ec59f8884e8a

API URL	/nicepay/redirect/v2/payment
Request Method	Redirect-GET
Header	Content-Type: application/Form-UrlEncoded

Parameter	Type	Size	Description	Remark
paymentURL Required	ANS	14	URL	https://dev.nicepay.co.id/nicepay/redirect/v2/payment
tXid Required	AN	30	Transaction ID	RECURRTEST00202212221422115631

Parameter	Type	Size	Description	Remark
status	N	1	Transaction Status	0
tXid	AN	30	Transaction ID	RECURRTEST00202212221422115631 When Success
referenceNo	AN	40	Order Number	ordNo20221222141245 When Success
payMethod	N	2	Payment Method Code	01 When Success
amt	N	12	Transaction Amount	1000 When Success
notaxAmt	N	12	Tax Fee Amount	0 When Success
vat	N	12	Value Added Tax ( )	0 When Success
fee	N	12	Service Fee	0 When Success
currency	A	3	Currency	IDR When Success
goodsNm	AN	100	Goods Name	Goods+For+Testing+Recurring+Token When Success
billingNm	A	100	Billing Name	John+Doe When Success
transDt	N	8	Transaction Date (YYYYMMDD)	20221220 When Success
transTm	N	6	Transaction Time (HH24MISS)	142211 When Success
authNo	N	10	Approval Number	115631 When Success (Additional)
issuBankCd	A	4	Issuing Bank Code	OTHR When Success
acquBankCd	A	4	Acquiring Bank Code	BMRI When Success
issuBankNm	A	255	Issuing Name	(empty) When Success
acquBankNm	A	255	Acquiring Name	Mandiri When Success
ccTransType	AN	2	Credit Card Transaction Type: 1: Normal 2: Recurring 3: Pre-Auth 4: Capture	1 When Success
cardNo	ANS	20	Card Number with Masking	45321111****1111 When Success
cardExpYymm	N	4	Card Expiry (YYMM)	2712 When Success
instmntType	N	2	Installment Type Code	1 When Success
instmntMon	N	2	Installment Month 1: 1 Month/Full , if instmntType: null/1 3: 3 Months 6: 6 Months 12: 12 Months	1 When Success
recurringToken	AN	255	Recurring Token	083333e129dea0535119b71813b1dc67b565e2704958411d2ee2ec2f430d745 When Success
preauthToken	AN	255	Pre-Auth Token	null When Success
matchCl	N	1	Amount Match Flag: Notification Status Code	1 When Success
merchantToken	AN	255	Token	f083333e129dea0535119b71813b1dc67b565e2704958411d2ee2ec2f430d745

Parameter	Type	Size	Description	Remark
paymentURL Required	ANS	14	URL	https://dev.nicepay.co.id/nicepay/redirect/v2/payment
tXid Required	AN	30	Transaction ID	PACTEST00100202212221548525731

Parameter	Type	Size	Description	Remark
status	N	1	Transaction Status	5
tXid	AN	30	Transaction ID	PACTEST00100202212221548525731 When Success
referenceNo	AN	40	Order Number	ordNo20221222151220 When Success
payMethod	N	2	Payment Method Code	01 When Success
amt	N	12	Transaction Amount	1000 When Success
notaxAmt	N	12	Tax Fee Amount	0 When Success
vat	N	12	Value Added Tax ( )	0 When Success
fee	N	12	Service Fee	0 When Success
currency	A	3	Currency	IDR When Success
goodsNm	AN	100	Goods Name	Goods+For+Testing+Pre+-+Auth+Token When Success
billingNm	A	100	Billing Name	John+Doe When Success
transDt	N	8	Transaction Date (YYYYMMDD)	20221222 When Success
transTm	N	6	Transaction Time (HH24MISS)	154852 When Success
authNo	N	10	Approval Number	525731 When Success (Additional)
issuBankCd	A	4	Issuing Bank Code	CENA When Success
acquBankCd	A	44	Acquiring Bank Code	BMRI When Success
issuBankNm	A	255	Issuing Name	BCA When Success
acquBankNm	A	255	Acquiring Name	Mandiri When Success
ccTransType	AN	2	Credit Card Transaction Type 1: Normal 2: Recurring 3: Pre-Auth 4: Capture	1 When Success
cardNo	ANS	20	Card Number with Masking	53079511****1111 When Success
cardExpYymm	N	4	Card Expiry (YYMM)	2712 When Success
instmntType	N	2	Installment Type Code	1 When Success
instmntMon	N	2	Installment Month 1: 1 Month/Full Payment, if instmntType: null/1 3: 3 Months 6: 6 Months 12: 12 Months	1 When Success
recurringToken	AN	255	Recurring Token	null When Success
preauthToken	AN	255	Pre-Auth Token	edc46eb30a81ac9753e34003d2d1e910d5aaf0dea620889dffcfcc18621864eb When Success
matchCl	N	1	Amount Match Flag: Notification Match Amount Indicator	1 When Success
merchantToken	AN	255	Token	1bee4b7c84cfb4e04d9d26cd47285bf49a77f252f39a48370094f5e3250b9524

Updated 23 Aug 2024

Did this page help you?

Registration - API Checkout

Virtual Account - API Checkout

Credit Card - API Checkout

About Credit Card - API Checkout

Process Flow

3Ds

Non-3Ds

NICEPAY Secure Payment Page

Full Payment Credit Card

Request Parameter Full Payment Credit Card

Response Parameters Full Payment Credit Card (CallbackUrl) - Payment

Sample Parameter for CallbackUrl API Checkout Payment

API Checkout Transaction Payment

Recurring Token

Request Parameter Recurring Token

Response Parameter Recurring Token

Sample Parameter Recurring Token Payment

Pre-Auth Token

Request Parameter Pre-Auth Token

Response Parameter Pre-Auth Token

Sample Parameter for Pre-Auth Token Payment

CallBack Handling API Checkout Payment

Welcome to NICEPAY DOCS