Credit Card - API Checkout
Tentang Credit Card - API Checkout
Terdapat beberapa hal yang Anda wajib ketahui dalam menggunakan API Checkout untuk metode Kartu Kredit agar proses integrasi Anda lancar bersama kami:
- Proses Flow 3Ds/Non-3Ds.
- Fitur Full Payment.
- Fitur Installment.
Alur Proses
Silakan kunjungi halaman Fitur Kartu Kredit untuk memeriksa penjelasan mengenai 3Ds.
3Ds
Deskripsi langkah alur pembayaran Kartu Kredit Redirect dengan 3Ds:
- Pelanggan melakukan checkout.
- Pelanggan mengirim data checkout kepada Merchant.
- Merchant mengajukan checkout menggunakan API Registration kepada NICEPAY .
- NICEPAY mendaftarkan data checkout.
- NICEPAY mengalihkan pembayaran pada halaman milik NICEPAY kepada Merchant.
- Merchant mengirimkan halaman pembayaran NICEPAY kepada Pelanggan.
- Pelanggan memilih metode pembayaran.
- Pelanggan memasukkan data kartu.
- Pelanggan mengirimkan informasi data kartu kepada NICEPAY.
- NICEPAY memproses kalkulasi FDS.
- NICEPAY mengajukan 3Ds kepada Bank.
- Bank melakukan validasi 3Ds.
- Bank mengirimkan response URL 3Ds kepada NICEPAY.
- NICEPAY menerima response verifikasi.
- NICEPAY mengalihkan Pelanggan kepada halaman autentikasi ACS.
- Bank membuat response OTP.
- Bank mengirimkan OTP kepada Pelanggan.
- Pelanggan menerima OTP.
- Pelanggan memasukkan OTP.
- Pelanggan mengirimkan OTP kepada Bank.
- Bank melakukan verifikasi OTP.
- Bank mengirimkan hasil 3Ds kepada NICEPAY.
- NICEPAY menerima hasil pemeriksaan.
- NICEPAY mengajukan pembayaran kepada Bank.
- Bank melakukan proses pembayaran.
- Bank mengirimkan notifikasi pembayaran kepada NICEPAY.
- NICEPAY melakukan redirect callbackUrl kepada Merchant.
- Merchant menampilkan hasil callbackUrl kepada Pelanggan.
- NICEPAY mengirim notifikasi pembayaran kepada Merchant.
- Merchant menerima notifikasi.
- Merchant melakukan pengajuan status inquiry ke NICEPAY.
- NICEPAY menerima pengajuan.
- NICEPAY secara otomatis mengirimkan response status inquiry kepada Merchant.
- Merchant menerima status terakhir.
- Merchant mengirim halaman hasil transaksi kepada Pelanggan.
Non-3Ds
Deskripsi langkah alur pembayaran Kartu Kredit Redirect dengan Non-3Ds:
- Pelanggan melakukan checkout.
- Pelanggan mengajukan checkout kepada Merchant.
- Merchant mendaftarkan data checkout.
- Merchant mengirimkan response berupa formulir data kartu.
- Pelanggan mengajukan checkout kepada Merchant.
- Merchant mendaftarkan pesanan dengan menggunakan API Registration kepada NICEPAY.
- NICEPAY menyimpan order registration.
- NICEPAY mengalihkan Merchant kepada halaman NICEPAY.
- Merchant mengirim halaman NICEPAY kepada Pelanggan.
- Pelanggan memilih metode pembayaran.
- Pelanggan memasukkan rincian kartu.
- Pelanggan mengajukan pembayaran menggunakan API Payment kepada NICEPAY.
- NICEPAY melakukan kalkulasi FDS.
- NICEPAY mengajukan pembayaran kepada Bank.
- Bank melakukan verifikasi pengajuan.
- Bank mengirimkan pengajuan konfirmasi pembayaran kepada Pelanggan.
- Pelanggan mengajukan pembayaran/charge kepada Bank.
- Bank melakukan proses pembayaran.
- Bank mengirim response pembayaran kepada NICEPAY.
- NICEPAY mengirim notifikasi pembayaran menggunakan callBackUrl dan dbProcessUrl kepada Merchant.
- Merchant menerima notifikasi.
- Merchant mengajukan pemeriksaan status kepada NICEPAY.
- NICEPAY mengirimkan response pemeriksaan status.
- Merchant menerima status terakhir.
- Merchant mengirimkan hasil pesanan kepada Pelanggan.
NICEPAY Secure Payment Page
Silakan membuka halaman Panduan Bayar Kartu Kredit untuk dapat memberikan panduan pembayaran kepada Pelanggan Anda dalam metode Kartu Kredit.
Gambar di atas adalah contoh pembayaran dengan metode Kartu Kredit menggunakan NICEPAY Secure Payment Page.
Setelah Pelanggan memilih metode dengan Kartu Kredit , Pelanggan akan diminta untuk memasukan data kartunya. Sistem NICEPAY akan secara otomatis mengenali jenis kartu BIN Pelanggan seperti gambar di bawah ini, misalnya VISA atau Mastercard, American Express, dan lain-lain yang nantinya kartunya pun akan berbeda sesuai dengan tipe jenis kartu yang digunakan.
Setelah selesai memasukkan data kartu, Pelanggan Anda dapat melanjutkan proses pembayaran.
Kemudian, proses transaksi akan berjalan. Apabila transaksi berhasil maka tampilan halaman pembayaran NICEPAY akan muncul seperti gambar berikut.
Silakan kunjungi halaman Payment - API Checkout untuk mengetahui langkah selanjutnya perihal payment handling.
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 metode pembayaran Kartu Kredit dengan tipe Full Payment.
Full Payment Credit Card - API Checkout (CallbackUrl)
Pada Full Payment Kartu Kredit, Pelanggan membayar secara penuh nominal yang ditagihkan dalam sekali bayar. Berikut adalah rincian API yang digunakan pada pembayaran Kartu Kredit.
Request Parameter for Full Payment Credit Card - API Checkout (CallbackUrl)
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
|---|---|---|---|---|
paymentURL Required | ANS | 14 | Payment URL | https://dev.nicepay.co.id/nicepay/redirect/v2/payment |
tXid Required | AN | 30 | Transaction ID | IONPAYTEST00202203211640309389 |
Untuk API Payment Checkout, metode pembayaran Kartu Kredit dengan Full Payment dan Installment mendapatkan response yang sama.
Response Parameter for Full Payment Credit Card - API Checkout (CallbackUrl)
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
|---|---|---|---|---|
status | N | 1 | 0 | |
tXid | AN | 30 | Transaction ID | IONPAYTEST00202212201540174369 When Success |
referenceNo | AN | 40 | Merchant 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 (VAT) | 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 Bank Name | Mandiri When Success |
acquBankNm | A | 255 | Acquiring Bank 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 Payment, 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 | Merchant Token | 8f5b330a549c167b53b4b9fd5f2d2eba897a64235c1610524074ec59f8884e8a When Success |
Sample Parameter for Full Payment Credit Card - API Checkout (CallbackUrl)
Request Parameter
curl -X GET "https://www.merchant.com/callbackUrl?ccTransType=1&fee=0&tXid=IONPAYTEST00202212201540174369&amt=1000¬axAmt=0&cardNo=46161111****1111&issuBankCd=BMRI&matchCl=1&preauthToken=null&cardExpYymm=2603&acquBankNm=Mandiri&payMethod=01¤cy=IDR&instmntMon=1&cc_trans_type=1&issuBankNm=Mandiri&merchantToken=dc1dd9e57ff6c4db341654ae31e623cab4d4d8057b2d0b58bef43ccb0da3b494&goodsNm=Goods+For+Testing+Credit+Card&referenceNo=ordNo20221220151243&authNo=174300&transTm=154017&cpGuaranteeableStatus=null&recurringToken=null&vat=0&instmntType=1&billingNm=John+Doe&acquBankCd=BMRI&transDt=20221220&status=0"Callback Parameter
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=8f5b330a549c167b53b4b9fd5f2d2eba897a64235c1610524074ec59f8884e8aCatatan: Response parameter akan dikirimkan melalui callBackurl dengan Content-type: application/json dan metode: POST Parameter.
Untuk proses integrasi Payment pada Checkout API, response dari request yang didapat setelah melakukan API Call Request adalah Callback URL.
Callback Handling API Checkout Transaction Payment
tXid tidak akan sama dengan request hold. Proses Capture akan memastikan bahwa nilai amount yang di-capture tidak melebihi dana yang dimiliki.
Saat Callback diterima callbackUrl Anda, kami merekomendasikan Merchant untuk melakukan verifikasi Status dengan menggunakan Status Inquiry - API Checkout.
Callback Handling sangat penting untuk membantu meminimalisir tindakan Fraud. Kami sangat merekomendasikan Merchant untuk melakukan verifikasi menggunakan Callback parameter.
"callbackUrl" : "https://www.merchant.com/callbackUrl/"