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

.