Registration - API Direct Debit
NICEPAY menyediakan Direct Debit sebagai fitur pembayaran. Direct Debit yang didukung NICEPAY:
- Jenius Pay.
Namun, terdapat perbedaan khusus untuk Jenius, yaitu terletak pada tambahan di Parameter Request dan untuk request staging di Jenius dilakukan melalui HTTPS.
API Endpoint | /nicepay/direct/v2/registration |
Request Method | POST |
Description | Performs Transaction Regist to NICEPAY |
Merchant Token | SHA256(timeStamp+iMid+referenceNo+amt+merchantKey) |
Request Format | application/json |
Berikut ini adalah daftar parameter untuk melakukan request registrasi metode pembayaran Direct Debit. Parameter ini digunakan melalui platform pengujian API sebagai salah satu tahapan supaya sistem milik Merchant dapat terhubung dengan layanan dari NICEPAY.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
timeStamp Required | N | 14 | Request Timestamp (YYYYMMDDHH24MISS) | 20221212155200 |
iMid Required | AN | 10 | Merchant ID | IONPAYTEST |
payMethod Required | N | 2 | 04 | |
currency Required | A | 3 | Currency | IDR |
amt Required | N | 12 | Amount | 5000 |
referenceNo Required | ANS | 40 | Merchant's Ref No. | order20221212155200 |
goodsNm Required | AN | 100 | Goods Name | Test Transaction Nicepay |
billingNm Required | A | 100 | Buyer Name | John Doe |
billingPhone Required | N | 15 | Buyer Phone No. | 081214714045 |
billingEmail Required | ANS | 40 | Buyer E-mail | |
billingAddr Required | AN | 100 | Buyer Address | Jalan Bukit Berbunga 22 |
billingCity Required | A | 50 | Buyer City | Jakarta |
billingState Required | A | 50 | Billing State | DKI Jakarta |
billingPostCd Required | N | 10 | Billing Post Number | 12345 |
billingCountry Required | A | 10 | Billing Country | Indonesia |
cartData Required | JSONstring | 4000 | Cart Data | {} |
sellers | JSON String | 4000 | Seller Data | |
instmntType | N | 2 | 2 | |
instmntMon Required for CC | N | 2 | Installment Month | 1 |
recurrOpt | N | 2 | 0: Automatic Cancel 1: Do Not Cancel 2: Do Not Make Token | 0 |
bankCd | A | 4 | - | |
vacctValidDt | N | 8 | VA Expiry Date (YYYYMMDD) | 20200303 |
vacctValidTm | N | 6 | VA Expiry Time (HH24MISS) | - |
merFixAcctId | AN | 40 | Merchant Reserved VA ID | - |
mitraCd | A | 4 | JENC | |
userIP | AN | 15 | User IP | 127.0.0.1 |
dbProcessUrl Required | ANS | 255 | Notification URL | https://merchant.com/dbProcessUrl |
merchantToken Required | AN | 255 | Merchant Token | 6cfccfc0046773c1b589d8e98f8b596c284f3c70a4ecf86eba14c18944b74bcd |
deliveryNm | A | 30 | Delivery Name | |
deliveryPhone | N | 15 | Delivery Phone | 081214714045 |
deliveryAddr | AN | 100 | Delviery Address | Jalan Bukit Berbunga 22 |
deliveryCity | A | 50 | Delivery City | Jakarta |
deliveryState | A | 50 | Delivery State | DKI Jakarta |
deliveryPostCd | N | 10 | Delivery Post Code | 12345 |
deliveryCountry | A | 10 | Delivery Country | Indonesia |
vat | N | 12 | Vat | 0 |
fee | N | 12 | Service Fee | 0 |
notaxAmt | N | 12 | Tax Free Amount | - |
description | AN | 100 | Transaction Description | Testing |
merchantToken | AN | 255 | Merchant Token | 0dd1393f41bccbc33ed82cb514138aa5a46c24a6e55730868d264f3d80fb4fc1 |
reqDt | N | 8 | Request Date (YYYYMMDD) | - |
reqTm | N | 6 | Request Time (HH24MISS) | - |
reqDomain | ANS | 100 | Request Domain | merchant.com |
reqServerIP | ANS | 15 | Request Server IP | 127.0.0.1 |
userIP Required | AN | 15 | User IP Address | 127.0.0.1 |
reqClientVer | ANS | 50 | Client Version | 1.0 |
userSessionID | AN | 100 | User Session ID | userSessionID |
userAgent | ANS | 100 | User Agent | Mozilla |
userLanguage | A | 2 | User Language | en-US |
shopId | AN | 32 | Shop ID | NICEPAY |
userAgent Required | ANS | 100 | User Agent Information | Mozilla |
recurrOpt | N | 2 | 0: Automatic Cancel 1: Do Not Cancel 2: Do Not Make Token | 2 |
Silakan kunjungi bagian Direct Debit untuk mempelajari informasi umum mengenai metode pembayaran Direct Debit.
Parameter dibawah berisi informasi tambahan mengenai informasi Registrasi Direct Debit.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
payMethod Required | N | 2 | 04 | |
mitraCd Required | A | 4 | | JENC |
mRefNo Required | AN | 18 | Direct Debit Jenius Reference No. | |
Berikut ini adalah daftar response parameter dari request registrasi pada proses transaksi Direct Debit.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
resultCd | N | 14 | 0000 | |
resultMsg | AN | 255 | Result Message: Error Code | SUCCESS |
tXid | AN | 30 | Transaction ID | IONPAYTEST04202212121554299694 |
referenceNo | ANS | 40 | Merchant Ref. No. | order20221212155200 |
payMethod | N | 2 | 04 | |
amt | N | 12 | Payment Amount | 5000 |
transDt | N | 8 | Transaction Date (YYYYMMDD) | 20221212 |
transTm | N | 6 | Transaction Time (HH24MISS) | 155431 |
description | AN | 100 | Description | Testing |
bankCd | AN | 4 | null | |
vacctNo | N | 20 | VA Number | null |
mitraCd | AN | 4 | JENC | |
payNo | N | 12 | Payment Number | null |
currency | A | 3 | Currency | null |
goodsNm | AN | 100 | Goods Name | null |
billingNm | A | 100 | Buyer Name | null |
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 | 8 | 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 |