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 .