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 terbagi menjadi dua tipe, yaitu Sandbox Credentials dan Production Credentials.
Apabila Anda ingin melakukan uji coba API kami terlebih dahulu sebelum melakukan proses integrasi dengan NICEPAY, silahkan 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).
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:
- Pilih tab Other.
- Scroll ke bawah untuk mendapatkan merchantKey Anda.
![Panduan Melihat M_KEY / Merchant Key Panduan Melihat M_KEY / Merchant Key](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/sXerwgaWCl-lFAYzimrFY_merchant-key.png?format=webp)
Jangan lupa untuk mencantumkan parameter iMid sesuai dengan iMid yang terdaftar untuk bisnis Anda saat melakukan integrasi dengan kami.
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.
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 |
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/ |
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 | |
Payloan | |
GPN | |
QRIS | |
Payout |
Kunjungi halaman Postman Collection untuk mengetahui cara uji coba API NICEPAY dengan menggunakan Postman.
Kunjungi halaman Library untuk mengetahui SDK yang digunakan pada NICEPAY.