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.
kunjungi Fitur Kartu Kredit untuk memeriksa penjelasan mengenai 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 .

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 .
membuka Panduan Bayar Kartu Kredit untuk dapat memberikan panduan kepada dalam metode .

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 .

Kemudian, akan berjalan. Apabila berhasil maka tampilan akan muncul seperti gambar berikut.

kunjungi Payment - API Checkout untuk mengetahui langkah selanjutnya perihal payment handling.
Pada Full , membayar secara penuh nominal ditagihkan dalam sekali bayar. Berikut adalah rincian digunakan pada .
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.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
---|---|---|---|---|
status | N | 1 | 0 | |
tXid | AN | 30 | Transaction ID | IONPAYTEST00202212201540174369 When Success |
referenceNo | AN | 40 | Order Number | ordNo20221220151243 When Success |
payMethod | N | 2 | 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 | BMRI When Success | |
acquBankCd | A | 4 | 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 | 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 | 1 When Success | |
merchantToken | AN | 255 | Token | 8f5b330a549c167b53b4b9fd5f2d2eba897a64235c1610524074ec59f8884e8a When Success |
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 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).
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.
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 | 0 | |
tXid | AN | 30 | Transaction ID | RECURRTEST00202212221422115631 When Success |
referenceNo | AN | 40 | Order Number | ordNo20221222141245 When Success |
payMethod | N | 2 | 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 | OTHR When Success | |
acquBankCd | A | 4 | 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 | 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 |
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.
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.
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 |
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
---|---|---|---|---|
status | N | 1 | 5 | |
tXid | AN | 30 | Transaction ID | PACTEST00100202212221548525731 When Success |
referenceNo | AN | 40 | Order Number | ordNo20221222151220 When Success |
payMethod | N | 2 | 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 | CENA When Success | |
acquBankCd | A | 44 | 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 | 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: | 1 When Success |
merchantToken | AN | 255 | Token | 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.
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.
