Registration - API Convenience Store
NICEPAY menyediakan Toserba (Indomaret dan Alfamart Group) sebagai metode pembayaran sehingga Pelanggan dapat melakukan pembayaran melalui gerai-gerai Mitra Toserba di Seluruh Indonesia. Notifikasi real-time secara langsung akan dikirimkan ketika pembayaran berhasil.
Mitra Toserba NICEPAY:
- Alfamart
- Indomaret
- Lawson
- Alfamidi
- Dan+Dan Store
API ini digunakan untuk mengaktifkan metode pembayaran Convenience Store pada Merchant, sehingga Pelanggan dapat melakukan transaksi pembayaran menggunakan Convenience Store dengan Merchant. Tahapan ini digunakan untuk mengintegrasikan sistem dari Merchant dengan sistem dari NICEPAY.
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 |
Silakan kunjungi halaman NICEPAY Code untuk mengetahui daftar istilah kode yang berhubungan dengan sistem API.
Berikut ini adalah daftar parameter untuk melakukan request registrasi metode pembayaran Convenience Store. 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) | 20221202152801 |
iMid Required | AN | 10 | Merchant ID | IONPAYTEST |
payMethod Required | N | 2 | 03 | |
currency Required | A | 3 | Currency | IDR |
amt Required | N | 12 | Amount | 5000 |
referenceNo Required | ANS | 40 | Merchant's Ref. No. | Order12345 |
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 | JSONstring | 4000 | Cart Data | |
mitraCd Required | A | 4 | | ALMA |
userIP | AN | 15 | User IP | 127.0.0.1 |
dbProcessUrl Required | ANS | 255 | Notification URL | https://ptsv2.com/t/test-nicepay-v2 |
merchantToken Required | AN | 255 | Merchant Token | fa79a58a73bf9f6d07ce84daaabb8f23da6ca61d478d4e917d2e259d5c7e1106 |
deliveryNm | A | 30 | Delivery Name | |
deliveryPhone | N | 15 | Delivery Phone | 12345678 |
deliveryAddr | AN | 100 | Delivery 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 |
description | AN | 100 | Transaction Description | - |
reqDomain | ANS | 100 | Request Domain | merchant.com |
reqServerIP | ANS | 15 | Request Server IP | 127.0.0.1 |
reqClientVer | ANS | 50 | Client Version | - |
userSessionID | AN | 100 | User Session ID | 697D6922C961070967D3BA1BA5699C2C |
Silakan kunjungi bagian Convenience Store (CVS) untuk mempelajari informasi umum mengenai metode pembayaran Convenience Store.
Parameter dibawah berisi informasi tambahan mengenai informasi Registrasi Convenience Store.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
payMethod Required | N | 2 | 03 | |
mitraCd Required | A | 4 | Merchant ID | IONPAYTEST |
payValidDt Required | N | 8 | CVS Expiry Date (YYYYMMDD) | 20221212 |
payValidTm Required | N | 6 | CVS Expiry Time (HH24MISS) | 201012 |
Berikut ini adalah daftar response dari request status inquiry pada proses transaksi Convenience Store.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
resultCd | N | 14 | 0000 | |
resultMsg | AN | 255 | Result Message: Error Code | SUCCESS |
tXid | AN | 30 | Transaction ID | IONPAYTEST03202212021529034686 |
referenceNo | ANS | 40 | Merchant Ref. No. | Order12345 |
payMethod | N | 2 | 03 | |
amt | N | 12 | Payment Amount | 5000 |
transDt | N | 8 | Transaction Date (YYYYMMDD) | 20221202 |
transTm | N | 6 | Transaction Time (HH24MISS) | 152903 |
description | AN | 100 | Description | null |
bankCd | AN | 4 | null | |
vacctNo | N | 20 | VA Number | null |
mitraCd | AN | 4 | ALMA | |
payNo | N | 12 | Payment Number | 9041021529034686 |
currency | AN | 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 |