Authentication
Authentication is an API security procedure to recognize the identity of a foreign request. If the identity is recognized by the system, then the request can access the API.
In this case, NICEPAY first requires an API Key identity called merchantKey from your request. So you can connect with NICEPAY without any obstacles. Apart from merchantKey, you are also required to send the mandatory parameter, namely merchantToken.
Merchant Keys are divided into two types, namely Sandbox Credentials and Production Credentials.
If you want to test our API first before carrying out the integration process with NICEPAY, please use the following credentials provided below using iMid IONPAYTEST.
iMid is an identity or your ID as a Merchant on NICEPAY. iMid that is only devoted to your business usage will be given after you officially register as our Merchant. To perform testing, please use iMid IONPAYTEST and the specific Merchant key in Sandbox Credentials.
iMid (Merchant ID) | IONPAYTEST (AutoPaid) |
merchantKey | 33F49GnCMS1mFYlGXisbUDzVf2ATWCl9k3R++d5hDd3Frmuos/XLx8XhXpe+LDYAbpGKZYSwtlyyLOtS/8aD7A== |
The credentials above are provided for testing purposes only and the payment process will be made successful automatically (AutoPaid).
If you are already registered as a NICEPAY Merchant and want to perform the integration stage with real transactions, you can view the merchantKey that we specifically created with your iMid in the portal Merchant Back Office.
Here are the steps to get merchantKey:
- Select tab Other.
- Scroll down to get your merchantKey.
![Panduan Melihat M_KEY / Merchant Key Panduan Melihat M_KEY / Merchant Key](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/sXerwgaWCl-lFAYzimrFY_merchant-key.png?format=webp)
Don't forget to include the iMid parameter according to the registered iMid for your business when integrating with us.
MerchantToken uses by the Merchant to proceed the security authentication process with the NICEPAY system. This parameter was created using the SHA-256 hashing method that includes parameters iMid, merchantKey along with the other variables needed. Here are the details of Merchant Token:
Parameter | Type | Size | Description |
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 |
Here's the NICEPAY API URL you can use according to your needs. This URL must be requested via the HTTPS protocol to connect with us.
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/ |
After you got all the authentication requirements that can interact with our API, please visit the page below to test with our services.
Payment Method | Credential |
Credit Card | |
Virtual Account | |
Convenience Store | |
Direct Debit | |
E-Wallet | |
Payloan | |
GPN | |
QRIS | |
Payout |
Visit the Postman Collection page to find out how to test NICEPAY API by using Postman.
Visit the Library page to find out the used SDK on NICEPAY.