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