Full Payment & Installment - Payment API Credit Card
ini digunakan setelah menyelesaikan Full Payment & Installment - Registration API Credit Card. digunakan pada tahap ini sama dengan untuk tipe Recurring Token dan Pre-auth & Capture. Namun, terdapat perbedaan pada request dikirimkan.
API Endpoint | /nicepay/direct/v2/payment |
|---|---|
Request Method | POST |
Description | Full & Installment - |
Merchant Token | SHA256(timeStamp+iMid+referenceNo+amt+merchantKey) |
Request Format | application/x-www-form-urlencoded |
Pada , jika autentikasi 3Ds diperlukan, akan diarahkan ke 3Ds Card Issuer memerlukan untuk input kode OTP (One Time Password) untuk menyelesaikan nya.
Berikut ini adalah daftar request untuk mem pada Full Payment & Installment. Request dilakukan melalui Form-Url dengan rincian 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 | ordNo20221202141217 |
cardNo Required for CC | N | 20 | 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 | Token | c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae |
callBackUrl Required | ANS | 255 | Result URL | https://merchant.com/callBackUrl |
Parameter dibutuhkan untuk adalah data /Debit dari , yaitu berupa cardNo, cardExpYymm, cardCvv, cardHolderNm & cardHolderEmail.
Jadi, untuk dapat melakukan , kami sarankan agar untuk memperoleh data kartu tersebut dari terlebih dahulu sebelum melakukan .
Mencantumkan cardCVV pada setiap bergantung dari MID tipe CVV atau Non-CVV.
Setelah melakukan request, akan mendapatkan response dari Callback URL dengan rincian response 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 | Order Number | When success |
payMethod | N | 2 | When success | |
amt | N | 12 | 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 Number 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 terjadi, akan mendapatkan dari kami sesuai dengan Callback URL masukkan dalam request pada Payment - API Credit Card.
Saat Callback telah diterima callbackUrl , kami sangat menganjurkan untuk melakukan verifikasi Status menggunakan Status Inquiry - API Credit Card.
CallBack Handling sangat penting untuk membantu meminimalisir tindakan Fraud, kami sangat merekomendasikan untuk melakukan verifikasi menggunakan CallBack Handling.