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 .
Berikut ini adalah dapat dipilih oleh untuk melakukan , yakni:
melanjutkan membaca ini untuk mengetahui rincian Registration lebih lanjut.
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 | ID | 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 | Order Number | MerchantReferenceNumber001 |
merchantToken Required | AN | 255 | Token | 4686062c297a3e48cf385953f411bbd48753bb70b041f2113a3e7c2e99c54f3c |
callBackUrl | AN | 255 | Result Forward URL | https://www.merchant.com/callbackUrl/ |
dbProcessUrl | AN | 255 | Notification URL | https://www.merchant.com/dbProcessUrl |
goodsNm Required | AN | 100 | Goods Name | Goods 1 |
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 | This Is The Description Of The |
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 | 's 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 | Value Added Tax () | (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 | Order Number | ReferenceNumber001 |
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 | This Is The Description Of The When Success |
currency | AN | 3 | Currency | IDR When Success |
goodsNm | AN | 100 | Goods Name | Goods 1 When Success |
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 | Redirect URL | 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.
- cartData harus dilepas dalam bentuk string.
- Karakter spesial tidak didukung dalam cartData.
- Pastikan bahwa count sama dengan jumlah object item.
- Pastikan bahwa goods_amt x goods_quantity sama dengan amt.
Parameter | Deskripsi | Contoh |
---|---|---|
Count | Total jumlah dari keseluruhan cart data | 2 |
Item | Terbagi menjadi 5 macam , yaitu img_url, goods_name, goods_detail, goods_amt, dan goods_quantity | - |
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.
- cartData secara spesifik untuk .
- Pastikan - countberdasarkan dengan nomor tipe barang-barang.
- Pastikan goods_sellers_id dan goods_sellers_name berisi sesuai dengan sellers pada Registration.
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 |