NICEPAY

Welcome to NICEPAY API Documentation and References.

NICEPAY Payment Solution is a product of PT. IONPAY NETWORKS that provide various electronic payment over the Internet safely without separate security device. Using our latest technology, we are integrated with Banks, E-wallets and other financial services via encrypted host to host connection to provide a secure and fast transaction.

There are two Versions of our API, allowing you to interact securely with our API using different approach.

API	Request Data	Response	Payment Page
V1 Professional	application/x-www-form-urlencoded	application/json	NICEPAY Secure Payment Page
V1 Enterprise	application/x-www-form-urlencoded	application/json	Merchant-hosted payment page
V2 Professional	application/json	application/json	NICEPAY Secure Payment Page
V2 Enterprise	application/json	application/json	Merchant-hosted payment page

Have any inquiry ?
Feel free contact us : it@nicepay.co.id.

Prerequisites

1. Contact our Merchant Acquisition Staff
2. Get Test MID (Merchant ID)
3. Get Test API Key (Merchant Key)
4. NICEPAY SDK if necessary (Java,PHP,and other)
5. Read NICEPAY API Documentation

Integration Process

1. Understanding SDK, Parameters and Payment Flow
2. Explore API Operation Calls
3. Integration
4. Implementation Test (Development Environment)
5. Request Production MID and API Key
6. Go Live

Libraries and Plugins

You can also download our SDK and Plugins from our GitHub.

Or you can directly hit our APIs If the SDK for your preferred Programming Language is not available.

Currently, We Provide Plugins and SDKs for:

1. Java
2. C#
3. PHP
4. Python
5. CodeIgniter
6. Laravel
7. Magento
8. Opencart
9. Wordpress WooCommerce

Download

Authentication and Credentials

To connect to our APIs, merchantToken is required to be sent along with other parameters. This token is generated using SHA-256 hashing which includes secret keys such as iMid, merchantKey and other keys.

Sandbox Credentials

The credentials below are provided only for testing purposes

iMid (Merchant ID)	IONPAYTEST
merchantKey	33F49GnCMS1mFYlGXisbUDzVf2ATWCl9k3R++d5hDd3Frmuos/XLx8XhXpe+LDYAbpGKZYSwtlyyLOtS/8aD7A==

NICEPAY URLs

NICEPAY APIs should be requested through HTTPS request to our Endpoint URL.

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/

API V1 Endpoints

API	Method	End Point	Merchant Token	Description
V1 Professional	POST application/x-www-form-urlencoded	/nicepay/api/orderRegist.do	iMid referenceNo amt merchantKey	Transaction Registration
V1 Enterprise	POST application/x-www-form-urlencoded	/nicepay/api/onePassToken.do	iMid referenceNo amt merchantKey	Request Credit Card Token
V1 Enterprise	Pop-up / Redirect	/nicepay/api/secureVeRequest.do	n/a	Request 3DS Pages
V1 Enterprise	Pop-up / Redirect	/nicepay/api/migsRequest.do	n/a	Request MIGS Pages
V1 Enterprise	POST application/x-www-form-urlencoded	/nicepay/api/onePass.do	iMid referenceNo amt merchantKey	Transaction Payment (Credit Card) and Registration for other payment methods.
V1 Enterprise	POST application/x-www-form-urlencoded	/nicepay/api/ewalletTrans.do	iMid referenceNo amt merchantKey	E-Wallet Trans
V1	POST application/x-www-form-urlencoded	/nicepay/api/onePassStatus.do	iMid referenceNo amt merchantKey	Status Inquiry
V1	POST application/x-www-form-urlencoded	/nicepay/api/onePassAllCancel.do	iMid tXid amt merchantKey	Cancel Transaction

API V2 Endpoints

API	Method	End Point	Merchant Token	Description
V2 Professional	POST application/json	/nicepay/redirect/v2/registration	timeStamp iMid referenceNo amt merchantKey	Transaction Registration
V2 Professional	POST application/x-www-form-urlencoded	/nicepay/redirect/v2/payment	timeStamp iMid referenceNo amt merchantKey	Transaction Payment
V2 Enterprise	POST application/json	/nicepay/direct/v2/registration	timeStamp iMid referenceNo amt merchantKey	Transaction Registration
V2 Enterprise	POST application/x-www-form-urlencoded	/nicepay/direct/v2/payment	timeStamp iMid referenceNo amt merchantKey	Transaction Payment
V2	POST application/json	/nicepay/direct/v2/inquiry	timeStamp iMid referenceNo amt merchantKey	Transaction Status Inquiry
V2	POST application/json	/nicepay/direct/v2/cancel	timeStamp iMid tXid amt merchantKey	Transaction Cancel
V2	POST application/json	/nicepay/direct/v2/sms-transmit	timeStamp iMid msgRefno merchantKey	SMS Transmit