Pre-Auth & Capture - Registration API Credit Card
Pre-Auth & Capture merupakan fitur lainnya dari Kartu Kredit di mana Merchant dapat menahan (hold) atau melakukan proses Pre-Auth terlebih dahulu dari dana yang sudah dibayarkan oleh Pelanggan Anda.
Kemudian, Anda perlu melakukan validasi atas jumlah dana transaksi tersebut atau yang disebut dengan Capture agar dana tersebut masuk ke dalam rekening Bank Anda. Jika Anda melakukan proses Capture setelah masa kedaluwarsa Pre-Auth berakhir maka transaksi tersebut akan dianggap Void dan dana transaksi tersebut akan dikembalikan kepada Pelanggan Anda.
Maka, kami sarankan untuk segera melakukan proses Capture sebelum masa kedaluwarsa transaksi Pre-Auth tersebut habis.
Pelajari mengenai fitur Credit Card Payment dengan Pre-Auth & Capture di Pre-Authorization & Capture pada Kartu Kredit.
API Endpoint | /nicepay/direct/v2/registration |
Request Method | POST |
Description | Pre-Auth & Capture |
Merchant Token | SHA256(timeStamp+iMid+referenceNo+amt+merchantKey) |
Request Format | application/json |
Langkah pertama yang perlu lakukan untuk mengaktifkan fitur Pre-Auth & Capture adalah melakukan registrasi transaksi Kartu Kredit terlebih dahulu pada API Registrasi ini.
Proses ini dilakukan agar Anda mendapatkan tXid yang dapat dipakai untuk melakukan proses Pre-Auth nantinya.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
timeStamp Required | N | 14 | Request Timestamp (YYYYMMDDHH24MISS) | 20221202141217 |
iMid Required | AN | 10 | Merchant ID | IONPAYTEST |
payMethod Required | N | 2 | 01 | |
currency Required | A | 3 | Currency | IDR |
amt Required | N | 12 | Amount (number not in float format) | 10000 (Jumlah total amount goods dari cartData) |
referenceNo Required | ANS | 40 | Merchant's Ref. No. | ordNo20221202141217 |
goodsNm Required | AN | 100 | Goods Name | Testing Transaction |
billingNm Required | A | 100 | Buyer Name | John Doe |
billingPhone Required | N | 15 | Buyer Phone No. | 2112345678 |
billingEmail Required | ANS | 40 | Buyer E-mail | |
billingAddr Required | AN | 100 | Buyer Address | Jln. Raya Kasablanka Kav.88 |
billingCity Required | A | 50 | Buyer City | South Jakarta |
billingState Required | A | 50 | Billing State | DKI Jakarta |
billingPostCd Required | N | 10 | Billing Post Number | 14350 |
billingCountry Required | A | 10 | Billing Country | Indonesia |
cartData Required | JSONstring | 4000 | Cart Data | {} |
instmntType Required | N | 2 | 1 (Untuk PreAuth & Recurring default 1) | |
instmntMon Required | N | 2 | Installment Month 1: 1 Month/Full Payment, jika instmntType: null/1 | 1 (Untuk PreAuth & Recurring default 1) |
recurrOpt Required | N | 2 | 0: Automatic Cancel 1: Do not cancel 2: Do not make token | 2 |
dbProcessUrl Required | ANS | 255 | Notification URL | https://merchant.com/dbProcessUrl |
userIP Required for CC, E-Wallet, Payloan, QRIS | AN | 15 | User IP | 127.0.0.1 |
merchantToken Required | AN | 255 | Merchant Token | c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae |
description | AN | 100 | Transaction Description | Test Transaction |
userSessionID | AN | 100 | User Session ID | userSessionID |
userAgent | ANS | 100 | User Agent | Mozilla |
userLanguage | A | 2 | User Language | en-US |
Berikut ini adalah response parameter dari hasil request registrasi transaksi tipe Pre-Auth & Capture yang sebelumnya sudah dilakukan pada pembayaran Kartu Kredit.
Hasil parameter yang diperlukan untuk dapat melanjutkan ke proses berikutnya dari hasil response ini adalah tXid.
Untuk melanjutkan ke langkah berikutnya, silakan mengunjungi halaman 20240709 - Pre-Auth & Capture - Payment API Credit Card.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
resultCd | N | 4 | 0000 | |
resultMsg | AN | 255 | Result Message: Error Code | SUCCESS |
tXid | AN | 30 | Transaction ID | PACTEST00101202206241007570327 |
referenceNo | ANS | 40 | Merchant Ref. No | ordNo20221215101254 |
payMethod | N | 2 | 01 | |
amt | N | 12 | Payment Amount | 10000 |
transDt | N | 8 | Transaction Date (YYYYMMDD) | 20221212 |
transTm | N | 6 | Transction Time (HH24MISS) | 121212 |
description | AN | 100 | Transaction Description | Testing Transaction Credit Card |
bankCd | A | 4 | null | |
vacctNo | N | 20 | Virtual Account | null |
mitraCd | A | 4 | null | |
payNo | N | 12 | CVS Payment Number | null |
currency | A | 3 | Currency | IDR |
goodsNm | AN | 100 | Goods Name | Goods For Testing Transaction |
billingNm | A | 100 | Buyer Name | John Doe |
vacctValidDt | N | 8 | VA Expiry Date (YYYYMMDD) | null |
vacctValidTm | N | 6 | VA Expiry Time (HH24MISS) | null |
payValidDt | N | 8 | Expiry Date (YYYYMMDD) | null |
payValidTm | N | 6 | Expiry Time (HH24MISS) | null |
requestURL | ANS | 360 | Request URL | null |
paymentExpDt | N | 6 | QR Payment Expiry Date (YYYYMMDD) | null |
paymentExpTm | N | 6 | QR Payment Expiry Time (HH24MISS) | null |
qrContent | ANS | 360 | QR String in Plain Text | null |
qrUrl | ANS | 360 | URL for QR Image, Valid for 5 minutes | null |
Silakan memeriksa NICEPAY Code untuk mengetahui kode umum beserta kode response dalam metode pembayaran Kartu Kredit ataupun metode pembayaran lainnya di NICEPAY.