NICEPAY API
API Version 2 (V2)

Authentication

10min

Authentication Process



Authentication is an security procedure to recognize identity of a foreign request. If identity is recognized by , then request can access .

In this case, first requires an Key identity called merchantKey from your request. So you can connect with without any obstacles. Apart from merchantKey, you are also required to send mandatory , namely merchantToken.



Merchant Key

 Keys are divided into two types, namely Sandbox Credentials and Production Credentials.

Sandbox Credentials

If you want to test our first before carrying out with , please use following credentials provided below using iMid IONPAYTEST.

iMid is an identity or your ID as a on . iMid that is only devoted to your usage will be given after you officially register as our . To perform , please use iMid IONPAYTEST and specific key in Sandbox Credentials.

iMid

(Merchant ID)

IONPAYTEST (AutoPaid)

merchantKey

33F49GnCMS1mFYlGXisbUDzVf2ATWCl9k3R++d5hDd3Frmuos/XLx8XhXpe+LDYAbpGKZYSwtlyyLOtS/8aD7A==

The credentials above are provided for purposes only and will be made successful automatically (AutoPaid).

Production/Live Credentials

If you are already registered as a and want to perform stage with real s, you can view merchantKey that we specifically created with your iMid in portal Merchant Back Office.

Here are steps to get merchantKey:

  1. Access your Merchant Back Office dashboard.
  2.  a Profile.
  3.  a Merchant Data.
  4.  tab Other.
  5. Scroll down to get your merchantKey.
Panduan Melihat M_KEY / Merchant Key
Panduan Melihat M_KEY / Merchant Key


Don't forget to include iMid according to registered iMid for your when integrating with us.



Merchant Token

MerchantToken uses by to proceed security authentication with . This was created using SHA-256 hashing method that includes s iMid, merchantKey along with other variables needed. Here are details of Token:

JS


Parameter

Type

Size

Description

timeStamp

N

14

Transaction Timestamp (YYYYMMDDHHMMSS)

iMid

AN

10

 ID

refNo

ANS

40

's Reference Number

amount

N

12

Amount

merchantKey

ANS

88

 Key



NICEPAY API URL

Here's URL you can use according to your needs. This URL must be requested via 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/



Payment Method Testing

After you got all authentication requirements that can interact with our , please visit below to test with our s.

Payment Method

Credential

Credit Card

Virtual Account

Convenience Store

Direct Debit

E-Wallet

Payloan

GPN

QRIS

Payout



See also

 Postman Collection to find out how to test by using Postman.

 NICEPAY Library to find out used SDK on .