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

Payment - 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