Registration - API Checkout
Langkah pada Registration - API Checkout ini berfungsi untuk mendaftarkan sebuah request checkout belanja dari kepada kami. Sehingga dapat membayar jumlah yang ditagihkan pada payment page sediakan.
Pada prinsipnya, semua pada memiliki sama. Hanya saja membedakan adalah pada setiap .
Pada saat melakukan , melakukan pendaftaran pesanan sebelum dapat melakukan pada diinginkan melalui tautan didapatkan.
kunjungi Payment - API Checkout untuk mengetahui penjelasan lebih rinci terkait khusus .
Untuk dapat menggunakan seluruh pada kecuali , diperlukan untuk mendaftarkan tersebut dengan Registrasi ini. Berikut nya:
API URL | /nicepay/redirect/v2/registration |
Method | POST |
Header | Content-Type: application/json |
Merchant Token | SHA256 (timestamp+ iMid+ referenceNo+ amt+ merchantKey) |
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
iMid Required | AN | 10 | IONPAYTEST | |
timeStamp Required | N | 14 | Request Timestamp (YYYYMMDDHH24MISS) | 20230516660517 |
payMethod Required | N | 2 | 00 | |
bankCd | A | 4 | Bank Code | CENA |
currency Required | AN | 3 | Currency | IDR |
amt | N | 12 | Transaction Amount | 10000 |
referenceNo Required | ANS | 40 | MerchantReferenceNumber001 | |
merchantToken Required | AN | 255 | 4686062c297a3e48cf385953f411bbd48753bb70b041f2113a3e7c2e99c54f3c | |
callBackUrl | AN | 255 | https://www.merchant.com/callbackUrl/ | |
dbProcessUrl | AN | 255 | https://www.merchant.com/dbProcessUrl | |
goodsNm Required | AN | 100 | Goods Name | |
mitraCd Required For CVS, E-Wallet & Payloan | AN | 4 | Mitra Code | DANA |
vacctValidDt Required For VA | N | 8 | VA Expiry Date (YYYYMMDD) | 20230531 |
vacctValidTm Required For VA | N | 8 | VA Expiry Time (HH24MISS) | 235959 |
description Required | AN | 100 | Transaction Description | |
billingNm Required | A | 100 | Billing Name | John Doe |
billingPhone Required | N | 15 | Billing Phone | 08123456789 |
billingEmail Required | AN | 40 | Billing E-mail | |
billingAddr | AN | 100 | Billing Address | Jln. Raya Casablanka Kav.88 |
billingCity Required | A | 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 | |
userIP | AN | 15 | User IP | 127.0.0.1 |
cartData Required | AN | 4000 | Cart Data | {\"count\":\"1\",\"item\":[{\"goods_id\":\"BB12345678\",\"goods_detail\":\"BB123456\",\"goods_name\":\"iPhone5S\",\"goods_amt\":\"10000\",\"goods_type\":\"Smartphone\",\"goods_url\":\"http://merchant.com/cellphones/iphone5s_64g\",\"goods_quantity\":\"1\",\"goods_sellers_id\":\"SEL123\",\"goods_sellers_name\":\"Sellers1\"}]} |
deliveryNm | A | 30 | Delivery Name | |
deliveryPhone | N | 15 | Delivery Phone | 08123456789 |
deliveryAddr | AN | 100 | Delivery Address | Jln. Dr.Saharjo No.88 |
deliveryCity | A | 50 | Delivery City | South Jakarta |
deliveryState | A | 50 | Delivery State | DKI Jakarta |
deliveryPostCd | N | 10 | Delivery Post Number | 10201 |
deliveryCountry | A | 10 | Delivery Country | |
vat | N | 12 | (empty) | |
fee | N | 12 | Service Fee | (empty) |
notaxAmt | N | 12 | Tax Free Amount | (empty) |
reqDt | N | 8 | Request Date (YYYYMMDD) | (empty) |
reqTm | N | 6 | Request Time (HH24MISS) | (empty) |
reqDomain | AN | 100 | Request Domain | (empty) |
reqServerIP | AN | 15 | Request Server IP | (empty) |
reqClientVer | AN | 50 | Request Client Version | (empty) |
userSessionID | AN | 100 | User Session ID | (empty) |
userAgent | AN | 100 | User Agent Information | (empty) |
userLanguage | A | 2 | User Language | (empty) |
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
resultCd | N | 4 | Result Code | 0000 |
resultMsg | AN | 255 | SUCCESS | |
tXid | AN | 30 | Transaction ID | IONPAYTEST00202305161555223616 When Success |
referenceNo | ANS | 40 | ||
payMethod | N | 2 | 00 When Success | |
amt | N | 12 | Amount | 10000 When Success |
transDt | N | 8 | Transaction Date (YYYYMMDD) | 20230516 When Success |
transTm | N | 6 | Transaction Time (HH24MISS) | 135959 When Success |
description | AN | 100 | Transaction Description | |
currency | AN | 3 | Currency | IDR When Success |
goodsNm | AN | 100 | Goods Name | |
billingNm | A | 100 | Buyer Name | John Doe When Success |
payValidDt | N | 8 | CVS Expiry Date (YYYYMMDD) | null |
payValidTm | N | 6 | CVS Expiry Time (HH24MISS) | null |
paymentURL | AN | 40 | https://www.nicepay.co.id/nicepay/redirect/v2/payment |
Setelah sudah didaftarkan, arahkan langsung menuju kami untuk melakukan . periksa Payment - API Checkout untuk mengetahui penjelasan lebih rinci.
Cart Data pada berguna untuk mendeklarasikan item apa saja akan di-checkout beserta rincian dan harga per item. Cart Data ini berlaku untuk semua , kecuali menggunakan dikarenakan memiliki Cart Data khusus.
Penjelasan detail pada parameter Item.
Parameter | Deskripsi | Contoh |
img_url | URL Gambar Barang (Ukuran 50px x 50px) | http://img.aaa.com/ima1.jpg |
goods_name | Nama Barang | Item 1 Name |
goods_detail | Deskripsi Detail Barang | Item 1 Detail |
goods_amt | Harga Barang | 700 |
goods_quantity | Jumlah Barang | 1 |
Parameter | Deskripsi |
count | Total Cart Data Count |
item | List of Goods |
item -> goods_id | Goods ID |
item -> goods_detail | Goods Detail |
item -> goods_name | Goods Name |
item -> goods_amt | Goods Amount |
item -> goods_type | Goods Type |
item -> goods_url | Goods URL |
item -> goods_quantity | Goods Quantity |
item -> goods_sellers_id | Seller's ID |
item -> goods_sellers_name | Seller's Name |
cartData wajib dilepas dalam format string.
Parameter | Deskripsi |
sellersId | Seller's ID |
sellersNm | Seller's Name |
sellersEmail | Seller's E-mail |
sellersUrl | Seller's URL |
sellersAddress -> sellerNm | Seller's Name |
sellersAddress -> sellerLastNm | Seller's Last Name |
sellersAddress -> sellerAddr | Seller's Address |
sellersAddress -> sellerCity | Seller's City |
sellersAddress -> sellerPostCd | Seller's Postal Code |
sellersAddress -> sellerPhone | Seller's Phone |
sellersAddress -> sellerCountry | Seller's Country |