Authentication - API Checkout
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.
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== |
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.
Berikut langkah untuk mendapatkan merchantKey:
- Akses dashboard Merchant Back Office Anda.
- Pilih menu Profile.
- Pilih sub-menu Merchant Data.
- Pilih tab Other.
- Scroll ke bawah untuk mendapatkan merchantKey Anda.
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.
//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 = d7c10cfccd64fdb21836f4330bb23f9ed357bc4b02420399d48b4661b89a55a0Parameter | 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 | Current NICEPAY Base URL | New NICEPAY Base URL |
|---|---|---|---|
Development | https | https://dev.nicepay.co.id/ | https://dev-services.nicepay.co.id |
Production | https | https://www.nicepay.co.id/ | https://services.nicepay.co.id |
Mohon segera lakukan perubahan NICEPAY Base URL menjadi URL terbaru sebelum tanggal 25 Desember 2026.
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 | |
Virtual Account | |
Convenience Store | |
Direct Debit | |
E-Wallet | |
Paylater | |
QRIS | |
Payout |