Recurring - Payment API Credit Card

17min

Tentang Recurring - Payment API Credit Card
﻿
Pembayaran tipe Recurring adalah fitur lain dari 
﻿ 
﻿ dapat melakukan 
﻿ suatu tagihan dari 
﻿ 
﻿ secara berkala dengan nominal 
﻿ sama seperti 
﻿ ditagihkan pada awal 
﻿. 
﻿
﻿ 
﻿ digunakan pada tahap 
﻿ ini sama dengan 
﻿ untuk 
﻿ tipe Full 
﻿ & Installment dan Pre-Auth & Capture. Namun, terdapat perbedaan pada request 
﻿ 
﻿ dikirimkan.
﻿
﻿ akan memberikan sebuah recurringToken sebagai 
﻿ 
﻿ 
﻿ response 
﻿ disebut sebagai recurring token making. 
﻿ dapat menggunakan recurringToken pada 
﻿ 
﻿ request selanjutnya tanpa menggunakan cardNo dan cardExpYymm. 
﻿
Recurring - Payment API Credit Card (First Payment)
﻿
Untuk dapat mengaktifkan 
﻿ 
﻿ dengan jenis Recurring, 
﻿ wajib membayarkan 
﻿ 
﻿ sudah dibuat untuk mendapatkan recurringToken terlebih dahulu. 

API Endpoint
/nicepay/direct/v2/payment
Method
﻿application/x-www-form-urlencoded﻿
﻿POST﻿
Description
Recurring 
﻿ 
﻿ 
Merchant Token
SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)
Spesifikasi 
﻿ 
﻿ digunakan sama dengan API Recurring Token Credit Card﻿.
﻿
Request Payment for Credit Card Recurring (First Payment)
﻿
Berikut adalah request payment pada Recurring untuk mendapatkan recurringToken 
﻿ di mana 
﻿ diperlukan untuk menyelesaikan Recurring - Registration API Credit Card﻿ terlebih dahulu. 
﻿
﻿ masih membutuhkan cardNo, cardExpYymm, cardCvv, cardHolderNm& cardHolderEmail dari 
﻿ pada 
﻿ pertama dalam skema Recurring ini.
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
timeStamp
﻿Required﻿
N
14
Request Timestamp (YYYYMMDDHH24MISS)
20230522080502
tXid
﻿Required﻿
AN
30

Transaction ID	
IONPAYTEST01202305220041509298
referenceNo
﻿Required﻿
ANS
40
﻿
﻿ Order Number
MerchantReferenceNumber001
merchantToken
﻿Required﻿
AN
255
﻿
﻿ Token
ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae
cardNo
﻿Required﻿
N
20
﻿
﻿ Number
51234500****0000
cardExpYymm
﻿Required﻿
A
4
Card Expiry (YYMM)	
3901
cardCvv
﻿Required﻿
N
4
Card CVV
100
cardHolderNm
﻿Required﻿
AN
45
Card Holder Name
John Doe
cardHolderEmail
﻿Required﻿
ANS
100
Card Holder Email
[email protected]
callBackUrl
﻿Required﻿
ANS
255
﻿
﻿ Result URL
https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp
﻿
Response Parameter for Credit Card Recurring (First Payment)
﻿
Berikut adalah rincian response 
﻿ 
﻿ dapatkan. Mohon untuk melakukan save & store recurringToken 
﻿ sudah didapat demi menjalankan 
﻿ fitur Recurring pada 
﻿ selanjutnya dengan 
﻿ 
﻿ 
﻿ sama.
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
timeStamp
N
14
Response Date
(YYYYMMDDHH24MISS)
20230520135959
resultCd
N
4
﻿Result Code﻿﻿
0000
resultMsg
AN
255
﻿Result Message﻿﻿
SUCCESS
tXid
AN
30
Transaction ID
IONPAYTEST01202305161007570327
referenceNo
ANS
40
﻿
﻿ Order Number
MerchantReferenceNumber001
payMethod
N
2
﻿Payment Method Code﻿﻿
01
﻿
When Success
amount
N
12
﻿
﻿ Amount
10000
﻿
When Success
currency
AN
3
Currency
IDR
﻿
When Success
goodsNm
AN
100
Goods Name
﻿
﻿ Goods 1
﻿
When Success
billingNm
AN
100
Buyer Name
John Doe
﻿
When Success
transDt
N
8
Transaction Date
(YYYYMMDD)
20230516
﻿
When Success
transTm
N
6
Transaction Time
(HH24MISS)
135959
﻿
When Success
description
AN
100
Transaction Description
This Is The Description Of The 
﻿ 
﻿
When Success
authNo
N
10
Approval Number
123456
﻿
When Success
issuBankCd
A
4
﻿Issuing Bank Code﻿﻿
CENA (Refer 
﻿ Code)
﻿
When Success
acquBankCd
A
4
﻿Acquiring Bank Code﻿﻿
BNIA (Refer 
﻿ Code)
﻿
When Success
cardNo
AN
20
Card Number (Masked)
51234500****0008
﻿
When Success
cardExpYymm
N
4
Card Expiry
(YYMM)
3901
﻿
When Success
instmntMon
N
1
Installment Month
1
﻿
When Success
instmntType
N
2
﻿Installment Type Code﻿﻿
﻿
1
﻿
When Success
ccTransType
AN
2
﻿Credit Card Transaction Type﻿﻿
1 Normal
2 Recurring
3 Pre-Auth
4 Capture
2
﻿
When Success
vat
N
12
Value Added Tax ( 
﻿)
0
﻿
When Success
fee
N
12
Service Fee
0
﻿
When Success
notaxAmt
N
12
Tax Free Amount
0
﻿
When Success
recurringToken
AN
64
Token That Using Recurring 
﻿ 
f19e3128784d0b33c189d5df21321c781b5bd107b185587fd8a54781aa845c84
acquBankNm
A
255
Acquiring 
﻿ Name
CIMB
issuBankNm
A
255
Issuing 
﻿ Name
BCA

﻿
Sample for Credit Card Recurring (First Payment)
Sample Request Recurring Payment
Sample Response Recurring Payment
Java Request
//Credit Card Recurring Issue

//Initialize Parameters
nicePay.setTimeStamp("20221202141217");
nicePay.settXid("IONPAYTEST01202212021455054652");
nicePay.setReferenceNo("MerchantReferenceNumber001");
nicePay.setMerchantToken("ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae");
nicePay.setCardNo("512345*****0008");
nicePay.setCardExpYymm("3901");
nicePay.setCardCvv("100");
nicePay.setCardholderNm("John Doe");
nicePay.setCardHolderEmail("[email protected]");
nicePay.setCallbackUrl("https://www.merchant.com/callbackUrl/");

//Request Credit Card Recurring Issue
nicePay.ccRecurringIssue();

//Response Credit Card Recurring Issue
System.out.println("Response : " + nicePay.getResponseString());
String resultCd = nicePay.get("resultCd");
String resultMsg = nicePay.get("resultMsg");
String authNo = nicePay.get("authNo");
String tXid = nicePay.get("tXid");
String referenceNo = nicePay.get("referenceNo");
String transDt = nicePay.get("transDt");
String transTm = nicePay.get("transTm");
String amount = nicePay.get("amount");
String recurringToken = nicePay.get("recurringToken");
String cardNo = nicePay.get("cardNo");
String acquBankCd = nicePay.get("acquBankCd");
String issuBankCd = nicePay.get("issuBankCd");
String acquBankNm = nicePay.get("acquBankNm");
String issuBankNm = nicePay.get("issuBankNm");

//Credit Card Recurring Issue

//Initialize Parameters
nicePay.setTimeStamp("20221202141217");
nicePay.settXid("IONPAYTEST01202212021455054652");
nicePay.setReferenceNo("MerchantReferenceNumber001");
nicePay.setMerchantToken("ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae");
nicePay.setCardNo("512345*****0008");
nicePay.setCardExpYymm("3901");
nicePay.setCardCvv("100");
nicePay.setCardholderNm("John Doe");
nicePay.setCardHolderEmail("johndoe@gmail.com");
nicePay.setCallbackUrl("https://www.merchant.com/callbackUrl/");

//Request Credit Card Recurring Issue
nicePay.ccRecurringIssue();

//Response Credit Card Recurring Issue
System.out.println("Response : " + nicePay.getResponseString());
String resultCd = nicePay.get("resultCd");
String resultMsg = nicePay.get("resultMsg");
String authNo = nicePay.get("authNo");
String tXid = nicePay.get("tXid");
String referenceNo = nicePay.get("referenceNo");
String transDt = nicePay.get("transDt");
String transTm = nicePay.get("transTm");
String amount = nicePay.get("amount");
String recurringToken = nicePay.get("recurringToken");
String cardNo = nicePay.get("cardNo");
String acquBankCd = nicePay.get("acquBankCd");
String issuBankCd = nicePay.get("issuBankCd");
String acquBankNm = nicePay.get("acquBankNm");
String issuBankNm = nicePay.get("issuBankNm");
﻿
﻿
Continual Recurring - Payment API Credit Card 
﻿
Setelah melakukan 
﻿ pertama dan telah mendapatkan recurringToken pada Recurring - Payment API Credit Card (First Payment)﻿. 
﻿
﻿ dapat menggunakan recurringToken tersebut untuk melakukan 
﻿ tagihan lain menggunakan kredensial 
﻿ 
﻿ 
﻿ sama demi menerapkan mekanisme 
﻿ secara berkala atau Recurring (subscription). Namun, untuk menjalankan 
﻿ payment continual recurring ini, 
﻿ tetap diperlukan untuk melakukan registrasi 
﻿ terlebih dahulu pada Recurring - Registration API Credit Card﻿.
Berikut adalah rincian request dan response 
﻿ digunakan pada 
﻿ berikutnya menggunakan recurring token 
﻿ sama.

API Endpoint
/nicepay/direct/v2/payment
Method
﻿application/x-www-form-urlencoded﻿
﻿POST﻿
Description
Recurring Continual 
﻿ 
﻿ 
Merchant Token
SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)
Spesifikasi 
﻿ 
﻿ digunakan sama dengan API Recurring Token Credit Card﻿.
﻿
Request Payment for Credit Card Recurring
﻿
﻿
﻿ hanya perlu menggunakan recurringToken pada 
﻿ 
﻿ Recurring untuk request selanjutnya ini tanpa menggunakan 
﻿ cardNo dan cardExpYymm. 
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
timeStamp
﻿Required﻿
N
14
Request Timestamp (YYYYMMDDHH24MISS)
20230522080502
tXid
﻿Required﻿
AN
30

Transaction ID	
IONPAYTEST01202305220041509298
referenceNo
﻿Required﻿
ANS
40
﻿
﻿ Order Number
MerchantReferenceNumber001
merchantToken
﻿Required﻿
AN
255
﻿
﻿ Token
ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae
recurringToken
﻿Required﻿
AN
64
Token That Using Recurring Payment
When Success

f19e3128784d0b33c189d5df21321c781b5bd107b185587fd8a54781aa845c84
cardCvv
﻿Required﻿
N
4
Card CVV
100
cardHolderNm
﻿Required﻿
AN
45
Card Holder Name
John Doe
cardHolderEmail
﻿Required﻿
ANS
100
Card Holder Email
[email protected]
callBackUrl
﻿Required﻿
ANS
255
﻿
﻿ Result URL
https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp
Mencantumkan cardCVV pada setiap 
﻿ bergantung dari MID tipe CVV atau Non-CVV.
﻿
Response Payment for Credit Card Recurring
﻿
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
timeStamp
N
14
Response Date
(YYYYMMDDHH24MISS)
20230520135959
resultCd
N
4
﻿Result Code﻿﻿
0000
resultMsg
AN
255
﻿Result Message﻿﻿
SUCCESS
tXid
AN
30
Transaction ID
IONPAYTEST202206230959067259
referenceNo
ANS
40
﻿
﻿ Order Number
MerchantReferenceNumber001
payMethod
N
2
﻿Payment Method Code﻿﻿
01
﻿
When Success
amt
N
12
Payment Amount
10000
﻿
When Success
currency
AN
3
Currency
IDR
﻿
When Success
goodsNm
AN
100
Goods Name
Merchant Goods 1
﻿
When Success
billingNm
AN
100
Buyer Name
John Doe
﻿
When Success
transDt
N
8
Transaction Date
(YYYYMMDD)
20230516
﻿
When Success
transTm
N
6
Transaction Time
(HH24MISS)
135959
﻿
When Success
description
AN
100
Transaction Description
This Is The Description Of The 
﻿ 
﻿
When Success
authNo
N
10
Approval Number
123456
﻿
When Success
issuBankCd
A
4
﻿Issuing Bank Code﻿﻿
CENA (Refer 
﻿ Code)
﻿
When Success
acquBankCd
A
4
﻿Acquiring Bank Code﻿﻿
CENA (Refer 
﻿ Code)
﻿
When Success
cardNo
AN
20
Card Number (Masked)
51234500****0008
﻿
When Success
cardExpYymm
N
4
Card Expiry
(YYMM)
3901
﻿
When Success
instmntMon
N
1
Installment Month
1
﻿
When Success
instmntType
N
2
﻿Installment Type Code﻿﻿
1
﻿
When Success
ccTransType
AN
2
﻿Credit Card Transaction Type﻿﻿
1 Normal
2 Recurring
3 Pre-Auth
4 Capture
2
﻿
When Success
vat
N
12
Value Added Tax (
﻿)
0
﻿
When Success
fee
N
12
Service Fee
0
﻿
When Success
notaxAmt
N
12
Tax Free Amount
0
﻿
When Success
acquBankNm
A
255
Acquiring 
﻿ Name
CIMB
issuBankNm
A
255
Issuing 
﻿ Name
BCA
﻿
Sample JSON for Credit Card Recurring Payment
﻿
Sample Request Continual Payment
Sample Response Continual Payment
Sample Java Request Continual
//Credit Card Recurring Continual

//Initialize Parameters
nicePay.setTimeStamp("20221202141217");
nicePay.settXid("IONPAYTEST01202212021455054652");
nicePay.setReferenceNo("MerchantReferenceNumber001");
nicePay.setMerchantToken("ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae");
nicePay.setRecurringToken("f19e3128784d0b33c189d5df21321c781b5bd107b185587fd8a54781aa845c84");
nicePay.setCardCvv("100");
nicePay.setCallbackUrl("https://www.merchant.com/callbackUrl/");

//Request Credit Card Recurring Issue
nicePay.ccRecurringIssue();

//Response Credit Card Recurring Issue
System.out.println("Response : " + nicePay.getResponseString());
String resultCd = nicePay.get("resultCd");
String resultMsg = nicePay.get("resultMsg");
String authNo = nicePay.get("authNo");
String tXid = nicePay.get("tXid");
String referenceNo = nicePay.get("referenceNo");
String transDt = nicePay.get("transDt");
String transTm = nicePay.get("transTm");
String amount = nicePay.get("amount");
String recurringToken = nicePay.get("recurringToken");
String cardNo = nicePay.get("cardNo");
String acquBankCd = nicePay.get("acquBankCd");
String issuBankCd = nicePay.get("issuBankCd");
String acquBankNm = nicePay.get("acquBankNm");
String issuBankNm = nicePay.get("issuBankNm");
//Credit Card Recurring Continual

//Initialize Parameters
nicePay.setTimeStamp("20221202141217");
nicePay.settXid("IONPAYTEST01202212021455054652");
nicePay.setReferenceNo("MerchantReferenceNumber001");
nicePay.setMerchantToken("ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae");
nicePay.setRecurringToken("f19e3128784d0b33c189d5df21321c781b5bd107b185587fd8a54781aa845c84");
nicePay.setCardCvv("100");
nicePay.setCallbackUrl("https://www.merchant.com/callbackUrl/");

//Request Credit Card Recurring Issue
nicePay.ccRecurringIssue();

//Response Credit Card Recurring Issue
System.out.println("Response : " + nicePay.getResponseString());
String resultCd = nicePay.get("resultCd");
String resultMsg = nicePay.get("resultMsg");
String authNo = nicePay.get("authNo");
String tXid = nicePay.get("tXid");
String referenceNo = nicePay.get("referenceNo");
String transDt = nicePay.get("transDt");
String transTm = nicePay.get("transTm");
String amount = nicePay.get("amount");
String recurringToken = nicePay.get("recurringToken");
String cardNo = nicePay.get("cardNo");
String acquBankCd = nicePay.get("acquBankCd");
String issuBankCd = nicePay.get("issuBankCd");
String acquBankNm = nicePay.get("acquBankNm");
String issuBankNm = nicePay.get("issuBankNm");
﻿
﻿
CallBack Handling for Credit Card Payment
﻿
tXid tidak akan sama dengan request hold. Proses Capture akan memastikan bahwa nilai amount 
﻿ di-capture tidak melebihi dana 
﻿ dimiliki
Saat Callback telah diterima callbackUrl 
﻿, kami sangat menganjurkan 
﻿ untuk melakukan verifikasi 
﻿ menggunakan Status Inquiry - API Credit Card﻿.
CallBack Handling dapat sangat membantu untuk meminimalisir terjadinya Fraud, kami sangat merekomendasikan {{merc}} untuk melakukan verifikasi 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"
}
﻿
﻿

Bank Indonesia telah menerbitkan Standar API terkait Pembayaran yang tercantum dalam Peraturan Anggota Dewan Gubernur No 23/15/PADG/2021 tentang Implementasi Standar Nasional Open Application Interface Pembayaran (SNAP).

Sebagai bentuk dukungan dan kepatuhan terhadap Peraturan Bank Indonesia, NICEPAY mendorong seluruh merchant untuk melakukan migrasi ke API SNAP BI.

Seluruh Merchant ditargetkan untuk dapat menyelesaikan migrasi API SNAP BI pada Juni 2024.

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

API Endpoint	/nicepay/direct/v2/payment
Method application/x-www-form-urlencoded	POST
Description	Recurring Continual
Merchant Token	SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
timeStamp Required	N	14	Request Timestamp (YYYYMMDDHH24MISS)	20230522080502
tXid Required	AN	30	Transaction ID	IONPAYTEST01202305220041509298
referenceNo Required	ANS	40	Order Number	MerchantReferenceNumber001
merchantToken Required	AN	255	Token	ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae
cardNo Required	N	20	Number	51234500****0000
cardExpYymm Required	A	4	Card Expiry (YYMM)	3901
cardCvv Required	N	4	Card CVV	100
cardHolderNm Required	AN	45	Card Holder Name	John Doe
cardHolderEmail Required	ANS	100	Card Holder Email	[email protected]
callBackUrl Required	ANS	255	Result URL	https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp

Recurring - Payment API Credit Card

Tentang Recurring - Payment API Credit Card

Recurring - Payment API Credit Card (First Payment)

Request Payment for Credit Card Recurring (First Payment)

Response Parameter for Credit Card Recurring (First Payment)

Sample for Credit Card Recurring (First Payment)

Continual Recurring - Payment API Credit Card

Request Payment for Credit Card Recurring

Response Payment for Credit Card Recurring

Sample JSON for Credit Card Recurring Payment

CallBack Handling for Credit Card Payment

Selamat Datang di NICEPAY DOCS