Credit Card - API Checkout

33min

Tentang Credit Card - API Checkout
﻿
Terdapat beberapa hal 
﻿ 
﻿ wajib ketahui dalam menggunakan 
﻿ 
﻿ untuk metode 
﻿ agar 
﻿ 
﻿ 
﻿ lancar bersama kami:
Proses Flow 3Ds/Non-3Ds.
Fitur Full 
﻿.
Fitur Installment.
Fitur Recurring Token.
Fitur Pre-Auth Token.
﻿
Alur Proses
﻿
﻿
﻿ kunjungi 
﻿ Fitur Kartu Kredit﻿ untuk memeriksa penjelasan mengenai 3Ds.
3Ds
Alur Pembayaran CC - Redirect 3Ds
﻿
Deskripsi langkah alur 
﻿ 
﻿ Redirect dengan 3Ds: 
﻿
﻿ melakukan checkout.
﻿
﻿ mengirim data 
﻿ kepada 
﻿.
﻿
﻿ mengajukan 
﻿ menggunakan 
﻿ Registration kepada 
﻿ .
﻿
﻿ mendaftarkan data 
﻿.
﻿
﻿ mengalihkan 
﻿ pada 
﻿ milik 
﻿ kepada 
﻿.
﻿
﻿ mengirimkan 
﻿ 
﻿ 
﻿ kepada 
﻿.
﻿
﻿ memilih 
﻿.
﻿
﻿ memasukkan data kartu.
﻿
﻿ mengirimkan 
﻿ data kartu kepada 
﻿.
﻿
﻿ mem
﻿ kalkulasi FDS.
﻿
﻿ mengajukan 3Ds kepada 
﻿.
﻿
﻿ melakukan validasi 3Ds.
﻿
﻿ mengirimkan response URL 3Ds kepada 
﻿.
﻿
﻿ menerima response verifikasi.
﻿
﻿ mengalihkan 
﻿ kepada 
﻿ autentikasi ACS.
﻿
﻿ membuat response OTP.
﻿
﻿ mengirimkan OTP kepada 
﻿.
﻿
﻿ menerima OTP.
﻿
﻿ memasukkan OTP.
﻿
﻿ mengirimkan OTP kepada 
﻿.
﻿
﻿ melakukan verifikasi OTP.
﻿
﻿ mengirimkan hasil 3Ds kepada 
﻿.
﻿
﻿ menerima hasil pemeriksaan.
﻿
﻿ mengajukan 
﻿ kepada 
﻿.
﻿
﻿ melakukan 
﻿ 
﻿.
﻿
﻿ mengirimkan 
﻿ 
﻿ kepada 
﻿.
﻿
﻿ melakukan redirect callbackUrl kepada 
﻿.
﻿
﻿ menampilkan hasil callbackUrl kepada 
﻿.
﻿
﻿ mengirim 
﻿ 
﻿ kepada 
﻿.
﻿
﻿ menerima 
﻿.
﻿
﻿ melakukan pengajuan 
﻿ inquiry ke 
﻿.
﻿
﻿ menerima pengajuan.
﻿
﻿ secara otomatis mengirimkan response 
﻿ inquiry kepada 
﻿.
﻿
﻿ menerima 
﻿ terakhir.
﻿
﻿ mengirim 
﻿ hasil 
﻿ kepada 
﻿.
﻿
Non-3Ds
Alur Pembayaran CC - Redirect Non-3Ds
﻿
Deskripsi langkah alur 
﻿ 
﻿ Redirect dengan Non-3Ds: 
﻿
﻿ melakukan checkout.
﻿
﻿ mengajukan checkout kepada 
﻿.
﻿
﻿ mendaftarkan data checkout.
﻿
﻿ mengirimkan response berupa formulir data kartu.
﻿
﻿ mengajukan checkout kepada 
﻿.
﻿
﻿ mendaftarkan pesanan dengan menggunakan 
﻿ Registration kepada 
﻿.
﻿
﻿ menyimpan order registration.
﻿
﻿ mengalihkan 
﻿ kepada 
﻿ 
﻿.
﻿
﻿ mengirim 
﻿ 
﻿ kepada 
﻿.
﻿
﻿ memilih 
﻿.
﻿
﻿ memasukkan rincian kartu.
﻿
﻿ mengajukan 
﻿ menggunakan 
﻿ 
﻿ kepada 
﻿.
﻿
﻿ melakukan kalkulasi FDS.
﻿
﻿ mengajukan 
﻿ kepada 
﻿.
﻿
﻿ melakukan verifikasi pengajuan.
﻿
﻿ mengirimkan pengajuan konfirmasi 
﻿ kepada 
﻿.
﻿
﻿ mengajukan 
﻿/charge kepada 
﻿.
﻿
﻿ melakukan 
﻿ 
﻿.
﻿
﻿ mengirim response 
﻿ kepada 
﻿.
﻿
﻿ mengirim 
﻿ 
﻿ menggunakan callBackUrl dan dbProcessUrl kepada 
﻿.
﻿
﻿ menerima 
﻿.
﻿
﻿ mengajukan pemeriksaan 
﻿ kepada 
﻿.
﻿
﻿ mengirimkan response pemeriksaan 
﻿.
﻿
﻿ menerima 
﻿ terakhir.
﻿
﻿ mengirimkan hasil pesanan kepada 
﻿.
﻿
﻿NICEPAY Secure Payment Page
﻿
﻿
﻿ membuka 
﻿ Panduan Bayar Kartu Kredit﻿ untuk dapat memberikan panduan 
﻿ kepada 
﻿ 
﻿ dalam metode 
﻿.
Secure Payment Page
﻿
Gambar di atas adalah contoh 
﻿ dengan metode 
﻿ menggunakan 
﻿ Secure 
﻿ Page.
Setelah 
﻿ memilih metode dengan 
﻿ , 
﻿ akan diminta untuk memasukan data kartunya. Sistem 
﻿ akan secara otomatis mengenali jenis kartu BIN 
﻿ seperti gambar di bawah ini, misalnya VISA atau Mastercard, American Express, dan lain-lain 
﻿ nantinya kartunya pun akan berbeda sesuai dengan tipe jenis kartu 
﻿ digunakan.
Setelah selesai memasukkan data kartu, 
﻿ 
﻿ dapat melanjutkan 
﻿ 
﻿.
Credit Card - Secure Payment Page
﻿
Kemudian, 
﻿ 
﻿ akan berjalan. Apabila 
﻿ berhasil maka tampilan 
﻿ 
﻿ 
﻿ akan muncul seperti gambar berikut.
Success -  Secure Payment Page
﻿
﻿
﻿ kunjungi 
﻿ Payment - API Checkout﻿ untuk mengetahui langkah selanjutnya perihal payment handling.
﻿
Full Payment Credit Card
﻿
Pada Full 
﻿ 
﻿, 
﻿ membayar secara penuh nominal 
﻿ ditagihkan dalam sekali bayar. Berikut adalah rincian 
﻿ 
﻿ digunakan pada 
﻿ 
﻿.
Request Parameter Full Payment Credit Card
﻿
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
paymentURL  
﻿Required﻿
ANS
14
﻿
﻿ URL
﻿
https://dev.nicepay.co.id/nicepay/redirect/v2/payment
tXid 
﻿Required﻿
AN
30
Transaction ID	
﻿
IONPAYTEST00202203211640309389
Untuk 
﻿ 
﻿ 
﻿, 
﻿ 
﻿ dengan Full 
﻿ dan Installment mendapatkan response 
﻿ sama.
﻿
Response Parameters Full Payment Credit Card (CallbackUrl) - Payment
﻿
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
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 
﻿, jika 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
﻿
When Success

﻿

Sample Parameter for CallbackUrl API Checkout Payment﻿
﻿
URL Request
URL Callback
Response Callback
status=0
tXid=IONPAYTEST00202212201540174369
referenceNo=ordNo20221220151243
payMethod=01
amt=1000
notaxAmt=0
vat=0
fee=0
currency=IDR
goodsNm=Goods+For+Testing+Credit+Card
billingNm=John+Doe
transDt=20221220
transTm=154017
authNo=174300
issuBankCd=BMRI
acquBankCd=BMRI
issuBankNm=Mandiri
acquBankNm=Mandiri
ccTransType=1
cardNo=46161111****1111
cardExpYymm=2707
instmntType=1
instmntMon=1
recurringToken=null
preauthToken=null
matchCl=1
merchantToken=8f5b330a549c167b53b4b9fd5f2d2eba897a64235c1610524074ec59f8884e8a
status=0
tXid=IONPAYTEST00202212201540174369
referenceNo=ordNo20221220151243
payMethod=01
amt=1000
notaxAmt=0
vat=0
fee=0
currency=IDR
goodsNm=Goods+For+Testing+Credit+Card
billingNm=John+Doe
transDt=20221220
transTm=154017
authNo=174300
issuBankCd=BMRI
acquBankCd=BMRI
issuBankNm=Mandiri
acquBankNm=Mandiri
ccTransType=1
cardNo=46161111****1111
cardExpYymm=2707
instmntType=1
instmntMon=1
recurringToken=null
preauthToken=null
matchCl=1
merchantToken=8f5b330a549c167b53b4b9fd5f2d2eba897a64235c1610524074ec59f8884e8a
﻿
Catatan: Response 
﻿ akan dikirimkan melalui callBackurl dengan Content-type: application/json dan metode: POST Parameter.
Untuk 
﻿ 
﻿ 
﻿ pada 
﻿ 
﻿, response dari request 
﻿ didapat setelah melakukan 
﻿ Call Request adalah Callback URL.
﻿
API Checkout Transaction Payment
﻿
API URL
/nicepay/redirect/v2/payment
Request Method 
Redirect-GET
Header
﻿Content-Type: application/Form-UrlEncoded﻿
Endpoint di atas dapat digunakan untuk 
﻿ 
﻿ dengan tipe Full 
﻿, Recurring, dan PAC (Pre-Auth Capture).
﻿
Recurring Token
﻿
Setelah 
﻿ menyelesaikan Registration - API Checkout﻿  dan Payment - API Checkout﻿, maka selanjutnya 
﻿ akan memberikan recurringToken pada response Payment - API Checkout﻿ 
﻿ didapatkan. 
Pada 
﻿ selanjutnya dengan 
﻿ 
﻿ sama, 
﻿ dapat menggunakan recurringToken tersebut dengan menggunakan 
﻿ pada Recurring - Payment API Credit Card﻿. 
﻿
Request Parameter Recurring Token

﻿
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
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
Tipe
Ukuran
Deskripsi
Contoh / Catatan
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 
﻿, jika 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 Match Amount Indicator﻿﻿
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
﻿
Setelah melakukan registrasi 
﻿ (Registration - API Checkout﻿) dan integrasi 
﻿ 
﻿ (Payment - API Checkout﻿) menggunakan 
﻿ 
﻿,
Jika 
﻿ ingin melakukan 
﻿ 
﻿ Recurring menggunakan Recurring Token 
﻿ sama, silakan melakukan Registrasi kembali pada Registration - API Checkout﻿ .
Kemudian melakukan 
﻿ dengan menambahkan Recurring Token pada 
﻿ recurringToken dan juga CVV.
﻿
Pre-Auth Token
﻿
Ketika 
﻿ menandatangani kontrak sebagai 
﻿ PAC (Pre-Auth/Capture), 
﻿ memberikan sebuah preauthToken kepada response Payment - API Checkout﻿. Token tersebut akan digunakan pada 
﻿ capture amount untuk menyelesaikan 
﻿ pada Pre-Auth & Capture - Payment API Credit Card﻿.
﻿
Request Parameter Pre-Auth Token
﻿


Berikut ini adalah daftar 
﻿ untuk melakukan request Pre-Auth Token 
﻿. Parameter ini digunakan melalui platform pengujian 
﻿ sebagai salah satu tahapan supaya 
﻿ milik 
﻿ dapat terhubung dengan 
﻿ dari 
﻿.  
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
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
Tipe
Ukuran
Deskripsi
Contoh / Catatan
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 
﻿, jika 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
﻿
Setelah melakukan registrasi dan 
﻿ menggunakan 
﻿ 
﻿,
Jika ingin melakukan multiple capture dengan menggunakan Pre-Auth Token 
﻿ sama, silakan melakukan registrasi kembali.
Kemudian melakukan Capture pada Payment V2 Credit Card dengan menambahkan Pre-Auth Token pada 
﻿ preauthToken beserta memasukkan CVV.
﻿
CallBack Handling API Checkout Payment
﻿
tXid tidak akan sama dengan request hold. Proses Capture akan memastikan bahwa nilai amount 
﻿ di-capture tidak melebihi dana 
﻿ dimiliki.
Saat Callback diterima callbackUrl Anda, kami merekomendasikan 
﻿  untuk melakukan verifikasi Status dengan menggunakan Status Inquiry - API Checkout﻿.
CallBack Handling sangat penting untuk membantu meminimalisir tindakan Fraud. Kami sangat merekomendasikan 
﻿ untuk melakukan verifikasi menggunakan CallBack parameter.
Alur 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"
}
﻿
﻿

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
paymentURL Required	ANS	14	URL	https://dev.nicepay.co.id/nicepay/redirect/v2/payment
tXid Required	AN	30	Transaction ID	IONPAYTEST00202203211640309389

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
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 , jika 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 When Success

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

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
paymentURL Required	ANS	14	URL	https://dev.nicepay.co.id/nicepay/redirect/v2/payment
tXid Required	AN	30	Transaction ID	RECURRTEST00202212221422115631

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
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 , jika 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 Match Amount Indicator	1 When Success
merchantToken	AN	255	Token	f083333e129dea0535119b71813b1dc67b565e2704958411d2ee2ec2f430d745

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
paymentURL Required	ANS	14	URL	https://dev.nicepay.co.id/nicepay/redirect/v2/payment
tXid Required	AN	30	Transaction ID	PACTEST00100202212221548525731

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
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 , jika 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

Tentang Credit Card - API Checkout

Alur Proses

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

Selamat Datang di NICEPAY DOCS

NICEPAY Secure Payment Page

Sample Parameter for CallbackUrl API Checkout Payment