Credit Card - V1 Enterprise
- Request onePassToken.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
iMid Required | AN | 10 | IONPAYTEST | |
merchantToken Required | AN | 255 | f5d1a08fd497bf3f39e9a0027c0a6822109903cd95140c36db537b5977fb9652 | |
cardNo Required | N | 16 | Card Number | 5123450000000008 |
cardExpYYmm Required | N | 4 | Card Expiry (YYMM) | 3901 |
cardHolderNm Required | AN | 45 | Card Holder Name | John Doe |
cardHolderEmail Required | ANS | 100 | Card Holder Email | |
amt Required | N | 12 | 10000 | |
referenceNo Required | ANS | 40 | MerchantReferenceNumber001 | |
instmntType | N | 2 | 1 | |
instmntMon | N | 2 | Installment Month | 1 |
Parameter | Tipe | Ukuran | Deskripsi |
resultCd | N | 4 | Result Code |
resultMsg | AN | 255 | |
cardToken | AN | 64 | One Time Use Transaction Token
|
paymentType | N | 1 | CC Authorization type |
paymentType | Deskripsi |
1 | 3D Secure |
2 | KeyIn (Proceed to Registration without 3Ds / MiGS) |
3 | MiGS |
Langkah-langkah 3Ds:
- Pembeli input OTP.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
country Required | N | 3 | Country | 360 |
callbackUrl Required | ANS | 200 | Callback URL | https://merchant.com/callback |
onePassToken Required | AN | 64 | One Time Use Transaction Token | d12b153b3dd50b1875e64ac17288a7cd33fd5511cf01924cac2ca7f345de8f08 |
Parameter | Tipe | Ukuran | Deskripsi |
resultCd | N | 4 | Result Code |
resultMsg | AN | 255 | |
referenceNo | ANS | 40 | |
merchantToken | AN | 255 |
MiGS (Mastercard Internet Gateway Service) adalah sebuah dari Mastercard untuk melakukan pengembalian dana dan memantau laporan berdasarkan antara dan .
Langkah-langkah:
- Pembeli input OTP.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
instmntType Required | N | 2 | 1 | |
instmntMon | N | 2 | Installment Month | 1 |
referenceNo Required | ANS | 40 | MerchantReferenceNumber001 | |
cardCvv | N | 3 | Card CVV | 100 |
callbackUrl Required | ANS | 200 | Callback URL for Result | http://merchant.com/callbackUrl |
onePassToken Required | AN | 64 | One Time Use Transaction Token | d12b153b3dd50b1875e64ac17288a7cd33fd5511cf01924cac2ca7f345de8f08 |
Parameter | Tipe | Ukuran | Deskripsi |
resultCd | N | 4 | Result Code |
resultMsg | AN | 255 |
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
iMid Required | AN | 2 | IONPAYTEST | |
payMethod Required | N | 2 | 01 | |
currency Required | A | 40 | Currency | IDR |
amt Required | N | 12 | Goods Amount | 10000 |
referenceNo Required | ANS | 40 | MerchantReferenceNumber001 | |
goodsNm Required | AN | 100 | Goods Name | |
billingNm Required | A | 30 | Billing Name | John Doe |
billingPhone Required | N | 15 | Billing Phone Number | 08123456789 |
billingEmail Required | ANS | 40 | Billing E-mail | |
billingCity Required | N | 50 | Billing City | South Jakarta |
billingState Required | A | 50 | Billing State | DKI Jakarta |
billingPostCd Required | N | 10 | Billing Post Number | 10200 |
billingCountry Required | A | 10 | Billing Country | |
callBackUrl Required | ANS | 255 | https://www.mechant.com/callbackUrl | |
dbProcessUrl Required | ANS | 255 | https://www.merchant.com/dbProcessUrl | |
description Required | AN | 100 | Description | |
merchantToken Required | AN | 255 | 2349fcbd3a5b81d08ca719cc6d9c826f2f6f9d4de337b86e4019114aad6222b1 | |
userIP Required | ANS | 15 | User IP | 127.0.0.1 |
cartData Required | ANS | 4000 | Cart Data (JSON Format) | {} |
instmntType Required | N | 2 | 1 | |
instmntMon Required | N | 2 | Installment Month | 1 |
cardCvv | N | 3 | Card CVV | 100 |
onePassToken Required | AN | 64 | One Time Use Transaction Token | 9338d54573688ae18e175240b0257de48d89c6ef1c9c7b5c094dc4beed9e435f |
recurrOpt Required For Recurring CC | N | 2 | 0 Automatic Cancel 1 Do Not Cancel 2 Do Not Make Token | 1 |
billingAddr | AN | 100 | Billing Address | Jln. Raya Kasablanka Kav.88 |
deliveryNm | A | 30 | Delivery Name | |
deliveryPhone | N | 15 | Delivery Phone | 08123456789 |
deliveryAddr | AN | 100 | Delivery Address | Jln. Dr. Saharjo No.88 |
deliveryEmail | AN | 100 | Delivery E-mail | |
deliveryCity | A | 50 | Delivery City | South Jakarta |
deliveryState | A | 50 | Delivery State | DKI Jakarta |
deliveryPostCd | N | 10 | Delivery Post Number | 10201 |
deliveryCountry | A | A | Delivery Country | |
vat | N | 12 | Vat | 0 |
fee | N | 12 | Service Tax | 0 |
notaxAmt | N | 12 | Tax Free Amount | 0 |
reqDt | N | N | Request Date (YYYYMMDD) | 20230516 |
reqTm | N | N | Request Time (HH24MISS) | 135959 |
reqDomain | ANS | 100 | Request Domain | www.merchant.com |
reqServerIP | ANS | 15 | Request Server IP | 127.0.0.1 |
reqClientVer | ANS | 50 | Request Client Version | 1.0 |
userSessionID | AN | 100 | User Session ID | userSessionID |
userAgent | ANS | 100 | User Agent Information | Mozilla |
userLanguage | ANS | 2 | User Language | en-US |
Parameter | Tipe | Ukuran | Deskripsi |
resultCd | N | 4 | Result Code |
resultMsg | AN | 255 | |
tXid | AN | 30 | Transaction ID |
referenceNo | ANS | 40 | |
payMethod | N | 2 | |
amount | N | 12 | Transaction Amount |
currency | AN | 3 | Currency |
goodsNm | N | 100 | Goods Name |
billingNm | N | 30 | Buyer Name |
transDt | N | 8 | Transaction Date (YYYYMMDD) |
transTm | N | 6 | Transaction Time (HH24MISS) |
description | AN | 100 | Transaction Description |
callbackUrl | ANS | 100 | Callback URL |
authNo | N | 10 | Authorization Number |
issuBankCd | A | 4 | |
issuBankNm | A | 255 | |
acquBankCd | A | 4 | |
acquBankNm | A | 255 | |
cardNo | ANS | 20 | Card Number with Masking |
instmntMon | N | 2 | Installment Month |
instmntType | N | 2 | |
recurringToken | AN | 64 | |
preauthToken | AN | 64 | |
ccTransType | N | 2 | |
vat | N | 12 | Vat Number |
fee | N | 12 | Service Fee |
notaxAmt | N | 12 | Tax Free Amount |
Saat menandatangani kontrak sebagai Recurring, memberikan RecurringToken ke response Pembayaran. dapat menggunakan RecurringToken untuk permintaan Pembayaran berikutnya tanpa memasukan detail kartu, kecuali CVV (Mandatory).
Untuk melakukan pembayaran Recurring, membutuhkan recurringToken milik agar dapat menggunakan secara berkala tanpa harus memasukkan data kartu berkali-kali. recurringToken didapatkan setelah melakukan untuk pertama kali. Berikut adalah langkah untuk mendapatkan recurringToken.
- Proses dengan Recurring pada V1 Enterprise terbagi menjadi 2, yaitu Direct 3Ds dan Direct Non-3Ds.
API Endpoint | /nicepay/api/recurringToken.do |
Method application/x-www-form-urlencoded | POST |
Description | recurringToken.do hampir sama dengan onePassToken.do bedanya apakah menggunakan info kartu atau Recurring Token |
Merchant Token | SHA256 (Merchant ID + Reference Number + Amount + Merchant Key) |
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
amt Required | N | 12 | Amount | 10000 |
referenceNo Required | AN | 40 | MerchantReferenceNumber001 | |
merchantToken Required | AN | 255 | baf19eaed10d8539498cbe06ed19c50a60a587416d9c980abbb3c06b4eee51f5 | |
iMid Required | AN | 10 | IONPAYTEST | |
recurringToken Required | AN | 100 | Recurring Token | 88cb7e30c531429a95fb2af442f591b75939fd0387288af2dc2340c50776d84a |
instmntType Required | AN | 2 | 1 | |
instmntMon Required | N | 2 | Installment month | 1 |
cardHolderNm Required | AN | 45 | Card Holder Name | John Doe |
cardHolderEmail Required | ANS | 100 | Card Holder Email |
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
resultCd | N | 4 | Result Code | 0000 |
resultMsg | AN | 255 | SUCCESS | |
cardToken | AN | 64 | Recurring Token | 9338d54573688ae18e175240b0257de48d89c6ef1c9c7b5c094dc4beed9e435f |
paymentType | AN | 1 | |
Setelah mendapatkan recurringToken dari pertama yang berhasil atau hasil pendaftaran kartu, akan menggunakan recurringToken tersebut untuk melakukan pada jadwal berikutnya. Berikut adalah langkah pada dalam menggunakan recurringToken.
Proses ini akan terus berjalan selama masa Recurring berlaku.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
iMid Required | AN | 2 | IONPAYTEST | |
payMethod Required | N | 2 | 01 | |
currency Required | A | 40 | Currency | IDR |
amt Required | N | 12 | Goods Amount | 10000 |
referenceNo Required | ANS | 40 | MerchantReferenceNumber001 | |
goodsNm Required | AN | 100 | Goods Name | |
billingNm Required | A | 30 | Billing Name | John Doe |
billingPhone Required | N | 15 | Billing Phone Number | 08123456789 |
billingEmail Required | ANS | 40 | Billing E-mail | |
billingCity Required | N | 50 | Billing City | South Jakarta |
billingState Required | A | 50 | Billing State | DKI Jakarta |
billingPostCd Required | N | 10 | Billing Post Number | 10200 |
billingCountry Required | A | 10 | Billing Country | |
callBackUrl Required | ANS | 255 | https://www.mechant.com/callbackUrl | |
dbProcessUrl Required | ANS | 255 | https://www.merchant.com/dbProcessUrl | |
description Required | AN | 100 | Description | This Is The Description Of The Payment |
merchantToken Required | AN | 255 | 2349fcbd3a5b81d08ca719cc6d9c826f2f6f9d4de337b86e4019114aad6222b1 | |
userIP Required | ANS | 15 | User IP | 127.0.0.1 |
cartData Required | ANS | 4000 | Cart Data (JSON Format) | {} |
instmntType Required | N | 2 | 1 | |
instmntMon Required | N | 2 | Installment Month | 1 |
cardCvv | N | 3 | Card CVV | 100 |
recurringToken Required | AN | 64 | Recurring Token | 88cb7e30c531429a95fb2af442f591b75939fd0387288af2dc2340c50776d84a |
recurrOpt Required For Recurring CC | N | 2 | 0 Automatic Cancel 1 Do Not Cancel 2 Do Not Make Token | 1 |
billingAddr | AN | 255 | Billing Address | Jln. Raya Kasablanka Kav.88 |
deliveryNm | A | 30 | Delivery Name | |
deliveryPhone | N | 15 | Delivery Phone | 08123456789 |
deliveryAddr | AN | 100 | Delivery Address | Jln. Dr. Saharjo No.88 |
deliveryEmail | ANS | 100 | Delivery E-mail | |
deliveryCity | A | 50 | Delivery City | South Jakarta |
deliveryState | A | 50 | Delivery State | DKI Jakarta |
deliveryPostCd | N | 10 | Delivery Post Number | 10201 |
deliveryCountry | A | A | Delivery Country | |
vat | N | 12 | Vat | 0 |
fee | N | 12 | Service Tax | 0 |
notaxAmt | N | 12 | Tax Free Amount | 0 |
reqDt | N | N | Request Date (YYYYMMDD) | 20230516 |
reqTm | N | N | Request Time (HH24MISS) | 135959 |
reqDomain | ANS | 100 | Request Domain | www.merchant.com |
reqServerIP | ANS | 15 | Request Server IP | 127.0.0.1 |
reqClientVer | ANS | 50 | Request Client Version | 1.0 |
userSessionID | AN | 100 | User Session ID | userSessionID |
userAgent | ANS | 100 | User Agent Information | Mozilla |
userLanguage | ANS | 2 | User Language | en-US |
Parameter | Tipe | Ukuran | Deskripsi |
resultCd | N | 4 | Result Code |
resultMsg | AN | 255 | |
tXid | AN | 30 | Transaction ID |
referenceNo | ANS | 40 | |
payMethod | N | 2 | |
amount | N | 12 | Transaction Amount |
currency | AN | 3 | Currency |
goodsNm | N | 100 | Goods Name |
billingNm | N | 30 | Buyer Name |
transDt | N | 8 | Transaction Date (YYYYMMDD) |
transTm | N | 6 | Transaction Time (HH24MISS) |
description | AN | 100 | Transaction Description |
callbackUrl | ANS | 100 | Callback URL |
authNo | N | 10 | Authorization Number |
issuBankCd | A | 4 | |
issuBankNm | A | 255 | |
acquBankCd | A | 4 | |
acquBankNm | A | 255 | |
cardNo | ANS | 20 | Card Number with Masking |
instmntMon | N | 2 | Installment Month |
instmntType | N | 2 | |
ccTransType | N | 2 | |
vat | N | 12 | Vat Number |
fee | N | 12 | Service Fee |
notaxAmt | N | 12 | Tax Free Amount |
ini digunakan khusus pada tipe Recurring untuk membuat recurringToken tanpa melakukan terlebih dahulu, melainkan hanya melalui pendaftaran kartu. recurringToken berhasil dibuat dapat digunakan untuk melakukan (recurringTrans.do).
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
iMid Required | AN | 10 | IONPAYTEST | |
merchantToken Required | AN | 255 | b63d66156715bf8c9d851e76e61a42ce7efb815a91843b7535c5bcde8490cb4d | |
cardNo Required | N | 16 | Card Number | 552103******6573 |
cardExpYymm Required | N | 4 | Card Expired YY/MM | 2012 |
billingNm Required | A | 30 | Billing Name | John Doe |
cardHolderNm Required | AN | 45 | Card Holder Name | John Doe |
cardHolderEmail Required | ANS | 100 | Card holder Email |
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
resultCode | N | 4 | Result Code | 0000 |
resultMsg | AN | 255 | Result Message | SUCCESS |
transDt | N | 8 | Transaction Date | 20180604 When Success |
transTm | N | 6 | Transaction Time | 141806 When Success |
recurringToken | AN | 10 | Recurring Token | 75d5220c439b83359ed440ab 12b713ed273feb455cc278fe0 0209e57dfe84cjk When Success |
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
resultCode Required | N | 4 | 0000 | |
resultMsg Required | AN | 255 | Result Message | SUCCESS |
transDt Required | N | 8 | Transaction Date | 20180604 |
transTm Required | N | 6 | Transaction Time | 141806 When Success |
recurringToken Required | AN | 60 | Authorization Number | 75d5220c439b83359ed440ab 12b713ed273feb455cc278fe0 0209e57dfe84cjk When Success |
billingEmail Required | AN | 40 | Billing Email | When Success |
billingNm Required | A | 30 | Billing Name | When Success |
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
resultCode | N | 4 | Result Code | 0000 |
resultMsg | AN | 255 | Result Message | SUCCESS |
transDt | N | 8 | Transaction Date | 20180604 When Success |
transTm | N | 6 | Transaction Time | 141806 When Success |
Untuk melakukan Pre-Auth & Capture, membutuhkan preauthToken agar dapat melakukan capture. Proses tersebut hanya dapat dilakukan selama preauthToken masih berlaku. Berikut adalah langkah pada dalam menggunakan Pre-Auth Token.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
iMid Required | AN | 2 | IONPAYTEST | |
payMethod Required | N | 2 | 01 | |
currency Required | A | 40 | Currency | IDR |
amt Required | N | 12 | Goods Amount | 10000 |
referenceNo Required | ANS | 40 | MerchantReferenceNumber001 | |
goodsNm Required | AN | 100 | Goods Name | |
billingNm Required | A | 30 | Billing Name | John Doe |
billingPhone Required | N | 15 | Billing Phone Number | 08123456789 |
billingEmail Required | ANS | 40 | Billing E-mail | |
billingCity Required | N | 50 | Billing City | South Jakarta |
billingState Required | A | 50 | Billing State | DKI Jakarta |
billingPostCd Required | N | 10 | Billing Post Number | 10200 |
billingCountry Required | A | 10 | Billing Country | |
callBackUrl Required | ANS | 255 | https://www.mechant.com/callbackUrl | |
dbProcessUrl Required | ANS | 255 | https://www.merchant.com/dbProcessUrl | |
description Required | AN | 100 | Description | |
merchantToken Required | AN | 255 | 2349fcbd3a5b81d08ca719cc6d9c826f2f6f9d4de337b86e4019114aad6222b1 | |
userIP Required | ANS | 15 | User IP | 127.0.0.1 |
cartData Required | ANS | 4000 | Cart Data (JSON Format) | {} |
instmntType Required | N | 2 | 1 | |
instmntMon Required | N | 2 | Installment Month | 1 |
cardCvv | N | 3 | Card CVV | 100 |
preauthToken Required | AN | 255 | Pre-Auth Token | c2921cc7a1967f905fd4f895f22f06c02d24adf8c9f7b169d6ef0c2c0b128549 |
recurrOpt Required For Recurring CC | N | 2 | 0 Automatic Cancel 1 Do Not Cancel 2 Do Not Make Token | 1 |
billingAddr | AN | 255 | Billing Address | Jln. Raya Kasablanka Kav.88 |
deliveryNm | A | 30 | Delivery Name | |
deliveryPhone | N | 15 | Delivery Phone | 08123456789 |
deliveryAddr | AN | 100 | Delivery Address | Jln. Dr. Saharjo No.88 |
deliveryEmail | AN | 100 | Delivery E-mail | |
deliveryCity | A | 50 | Delivery City | South Jakarta |
deliveryState | A | 50 | Delivery State | DKI Jakarta |
deliveryPostCd | N | 10 | Delivery Post Number | 10201 |
deliveryCountry | A | A | Delivery Country | |
vat | N | 12 | Vat | 0 |
fee | N | 12 | Service Tax | 0 |
notaxAmt | N | 12 | Tax Free Amount | 0 |
reqDt | N | N | Request Date (YYYYMMDD) | 20230516 |
reqTm | N | N | Request Time (HH24MISS) | 135959 |
reqDomain | ANS | 100 | Request Domain | www.merchant.com |
reqServerIP | ANS | 15 | Request Server IP | 127.0.0.1 |
reqClientVer | ANS | 50 | Request Client Version | 1.0 |
userSessionID | AN | 100 | User Session ID | userSessionID |
userAgent | ANS | 100 | User Agent Information | Mozilla |
userLanguage | ANS | 2 | User Language | en-US |
Parameter | Tipe | Ukuran | Deskripsi |
resultCd | N | 4 | Result Code |
resultMsg | AN | 255 | |
tXid | AN | 30 | Transaction ID |
referenceNo | ANS | 40 | |
payMethod | N | 2 | |
amount | N | 12 | Transaction Amount |
currency | AN | 3 | Currency |
goodsNm | N | 100 | Goods Name |
billingNm | N | 30 | Buyer Name |
transDt | N | 8 | Transaction Date (YYYYMMDD) |
transTm | N | 6 | Transaction Time (HH24MISS) |
description | AN | 100 | Transaction Description |
callbackUrl | ANS | 100 | Callback URL |
authNo | N | 10 | Authorization Number |
issuBankCd | A | 4 | |
issuBankNm | A | 255 | |
acquBankCd | A | 4 | |
acquBankNm | A | 255 | |
cardNo | ANS | 20 | Card Number with Masking |
instmntMon | N | 2 | Installment Month |
instmntType | N | 2 | |
ccTransType | N | 2 | |
vat | N | 12 | Vat Number |
fee | N | 12 | Service Fee |
notaxAmt | N | 12 | Tax Free Amount |