Full Payment & Installment - Payment API Credit Card
API ini digunakan setelah menyelesaikan API Full Payment & Installment - Registration API Credit Card. API yang digunakan pada tahap pembayaran ini sama dengan API untuk pembayaran tipe Recurring Token dan Pre-auth & Capture. Namun, terdapat perbedaan pada request parameter yang dikirimkan.
API Endpoint | /nicepay/direct/v2/payment |
Request Method | POST |
Description | Full Payment & Installment - Payment API Credit Card |
Merchant Token | SHA256(timeStamp+iMid+referenceNo+amt+merchantKey) |
Request Format | application/x-www-form-urlencoded |
Pada pembayaran Kartu Kredit, jika autentikasi 3Ds diperlukan, Pelanggan Anda akan diarahkan ke halaman 3Ds Bank Card Issuer yang memerlukan untuk input kode OTP (One Time Password) untuk menyelesaikan proses transaksinya.
Berikut ini adalah daftar request parameter untuk memproses pembayaran transaksi pada metode pembayaran Kartu Kredit Full Payment & Installment. Request parameter dilakukan melalui Form-Url dengan rincian parameter sebagai berikut:
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
timeStamp Required | N | 14 | Request Timestamp (YYYYMMDDHH24MISS) | 20221202141217 |
tXid Required | AN | 30 | Transaction ID | IONPAYTEST01202212021455054652 |
referenceNo | N | 40 | Reference Number for Payment | ordNo20221202141217 |
cardNo Required for CC | N | 20 | Credit Card Number | 4434260000000008 |
cardExpYymm Required for CC | A | 4 | Card Expiry (YYMM) | 3901 |
cardCvv Required for CC | N | 4 | Card CVV | 101 |
cardHolderNm Required | AN | 45 | Card Holder Name | John Doe |
cardHolderEmail Required | ANS | 100 | Card Holder Email | |
merchantToken Required | AN | 255 | Merchant Token | c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae |
callBackUrl Required | ANS | 255 | Payment Result URL | https://merchant.com/callBackUrl |
Parameter yang dibutuhkan untuk proses transaksi adalah data Kartu Kredit/Debit dari pelanggan Anda, yaitu berupa cardNo, cardExpYymm, cardCvv, cardHolderNm & cardHolderEmail.
Jadi, untuk dapat melakukan proses transaksi, kami sarankan agar Anda untuk memperoleh data kartu tersebut dari Pelanggan Anda terlebih dahulu sebelum melakukan proses Payment API.
Mencantumkan cardCVV pada setiap transaksi bergantung dari MID tipe CVV atau Non-CVV.
Setelah Anda melakukan request, Anda akan mendapatkan response dari Callback URL dengan rincian response parameter sebagai berikut:
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
resultCd | N | 14 | | |
resultMsg | AN | 255 | Result message: Error Code | |
tXid | AN | 30 | Transaction ID | When success |
referenceNo | ANS | 40 | Merchant Order No. | When success |
payMethod | N | 2 | When success | |
amt | N | 12 | Payment Amount | When success |
currency | AN | 3 | Currency | When success |
goodsNm | A | 100 | Goods Name | When success |
billingNm | A | 100 | Buyer Name | When success |
transDt | N | 8 | Transaction Date (YYYYMMDD) | When success |
transTm | N | 6 | Transaction Time (HH24MISS) | When success |
description | AN | 100 | Transaction Description | When success |
authNo | N | 10 | Approval Number | When success, CC |
issuBankCd | A | 4 | When success, CC | |
acquBankCd | A | 4 | When success, CC | |
cardNo | ANS | 20 | Card No. with Masking | When success, CC |
cardExpYymm | N | 4 | Card Expiry (YYMM) | When success, CC |
instmntMon | N | 2 | Installment Month | When success, CC |
instmntType | N | 2 | When success, CC | |
ccTransType | N | 2 | 1: Normal 2: Recurring 3: Pre-auth 4: Capture | When Success, CC |
Setelah transaksi terjadi, Anda akan mendapatkan notifikasi dari kami sesuai dengan Callback URL yang Anda masukkan dalam request parameter pada Payment - API Credit Card.
Saat Callback telah diterima callbackUrl Anda, kami sangat menganjurkan Merchant untuk melakukan verifikasi Status menggunakan Status Inquiry - API Credit Card.
CallBack Handling sangat penting untuk membantu meminimalisir tindakan Fraud, kami sangat merekomendasikan Merchant untuk melakukan verifikasi menggunakan CallBack Handling.