--- title: Authentication - API Checkout slug: nicepay-api-authentication-api-checkout description: Informasi seputar rincian dan proses autentikasi dengan sistem API Checkout NICEPAY image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/6b3FRXdI78alwjnTBpJj7_rdrx9d8diazpgm07xfz2test-1.png icon: {"faIcon":"fa-solid fa-user-gear"} docTags: createdAt: 2022-09-01T07:21:40.000Z --- # Proses *Authentication* *** *Authentication* merupakan prosedur keamanan API untuk mengenali identitas dari suatu *request* asing. Apabila identitas tersebut sudah dikenali oleh sistem, maka *request* tersebut dapat mengakses API tersebut. Dalam hal ini, NICEPAY membutuhkan identitas API Key terlebih dahulu yang disebut `merchantKey` dari *request* Anda, sehingga Anda dapat terhubung dengan NICEPAY tanpa hambatan apapun. Selain `merchantKey`, Anda juga dibutuhkan untuk mengirim *mandatory parameter*, yaitu `merchantToken`. ## Merchant Key Merchant Key terbagi menjadi dua tipe, yaitu Sandbox Credentials dan Production Credentials. ### Sandbox Credentials Apabila Anda ingin melakukan uji coba API kami terlebih dahulu sebelum melakukan proses integrasi dengan NICEPAY, silakan menggunakan kredensial yang telah disediakan di bawah ini dengan menggunakan `iMid` **IONPAYTEST**. :::hint{type="info"} `iMid` merupakan identitas atau ID Anda sebagai Merchant pada NICEPAY. `iMid` yang hanya dikhususkan untuk penggunaan bisnis Anda akan diberikan setelah Anda resmi terdaftar sebagai Merchant kami. Untuk melakukan testing, silakan memakai `iMid` **IONPAYTEST **dan memakai Merchant Key khusus tersebut di *Sandbox Credentials.* ::: | `iMid `
******(Merchant ID)****** | **IONPAYTEST**
**(AutoPaid)** | | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | | `merchantKey` | 33F49GnCMS1mFYlGXisbUDzVf2ATWCl9k3R++d5hDd3Frmuos/XLx8XhXpe+LDYAbpGKZYSwtlyyLOtS/8aD7A== | :::hint{type="info"} Kredensial di atas disediakan hanya untuk keperluan testing serta proses pembayaran akan dibuat berhasil secara otomatis (`AutoPaid`). ::: ### Production/Live Credentials Apabila Anda sudah resmi terdaftar menjadi Merchant NICEPAY dan ingin melakukan tahap integrasi dengan transaksi nyata, Anda dapat melihat `merchantKey` yang kami buatkan khusus dengan iMid Anda di dalam portal [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6). Berikut langkah untuk mendapatkan `merchantKey`: 1. Akses *dashboard* [Merchant Back Office](https://bo.nicepay.co.id/logIn.do) Anda. 2. Pilih menu [Profile](docId\:BabGGtWurVs0v13RqGnyS). 3. Pilih sub-menu [Merchant Data](docId:7IhkFtaIHOX62F21vl8Bq). 4. Pilih *tab* `Other`. 5. *Scroll* ke bawah untuk mendapatkan `merchantKey` Anda. ![](https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/sXerwgaWCl-lFAYzimrFY_merchant-key.png "Panduan Melihat M_KEY / Merchant Key") :::hint{type="warning"} Jangan lupa untuk mencantumkan parameter `iMid` sesuai dengan `iMid` yang terdaftar untuk bisnis Anda saat melakukan integrasi dengan kami. ::: ## Merchant Token `MerchantToken` digunakan Merchant untuk melakukan proses autentikasi keamanan dengan sistem NICEPAY. Parameter ini dibuat dengan menggunakan metode *hashing* `SHA-256` yang sudah termasuk parameter `iMid`, `merchantKey`, serta variabel lain yang dibutuhkan. Berikut detail dari Merchant Token. ```javascript //Generate merchantToken// merchantData = timeStamp + iMid + refNo + amount + merchantKey; merTok = CryptoJS.SHA256(merchantData).toString(CryptoJS.enc.Hex); Sample: merchantData = 20221202101271 + IONPAYTEST + OrdNo-20221202101271 + 100000 + 33F49GnCMS1mFYlGXisbUDzVf2ATWCl9k3R++d5hDd3Frmuos/XLx8XhXpe+LDYAbpGKZYSwtlyyLOtS/8aD7A== merTok = d7c10cfccd64fdb21836f4330bb23f9ed357bc4b02420399d48b4661b89a55a0 ``` | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | | ------------- | -------- | ---------- | ---------------------------------------- | | `timeStamp` | N | 14 | Transaction Timestamp (`YYYYMMDDHHMMSS)` | | `iMid` | AN | 10 | Merchant ID | | `refNo` | ANS | 40 | Merchant's Reference Number | | `amount` | N | 12 | Amount | | `merchantKey` | ANS | 88 | Merchant Key | ## NICEPAY API URL Berikut NICEPAY API URL yang dapat Anda gunakan sesuai dengan kebutuhan Anda. URL ini harus di-*request* melalui protokol HTTPS agar dapat terhubung dengan kami. | **Environment** | **Protocol** | **Base URL** | | --------------- | ------------ | -------------------------------- | | Development | https | `https://dev.nicepay.co.id/` | | Staging | https | `https://staging.nicepay.co.id/` | | Production | https | `https://www.nicepay.co.id/` | ## Uji Coba Metode Pembayaran Setelah Anda mendapatkan semua keperluan autentikasi agar dapat berinteraksi dengan API kami, silakan kunjungi laman di bawah ini untuk uji testing dengan layanan kami. | **Metode Pembayaran** | **Kredensial** | | --------------------- | ---------------------------------------------------------------- | | Kartu Kredit | [Integrasi & Testing Kartu Kredit](docId\:ZA5d5J-5w_gT44qGTxB5n) | | Virtual Account | [Integrasi & Testing VA](docId\:sts64cm0VYN3Q8_quNq23) | | Convenience Store | [Integrasi & Testing CVS](docId:6zSlSRyypvTgFXAKRIXHI) | | Direct Debit | [Integrasi & Testing Direct Debit](docId\:sHrV7hpVnWLt9ipNeCfE4) | | E-Wallet | [Integrasi & Testing E-Wallet](docId\:b9HPduhC2MPMLaLHIjCbO) | | Paylater | [Integrasi & Testing Paylater](docId\:ZEuw_0d227R_LUPBI3ptN) | | GPN | [Integrasi & Testing GPN](docId\:LuCYNk98cX7upRb-xSZS3) | | QRIS | [Integrasi & Testing QRIS](docId\:tCFbU7--Xd0Sm5_rQ00_w) | | Payout | [Integrasi & Testing Payout](docId\:LkYgPUsJyOVKICpo6yFHn) |