NAV Navbar
  • NICEPAY
  • Authentication and Credentials
  • NICEPAY URLs

  • Our APIs
  • API V2
  • API V1 Professional
  • API V1 Enterprise
  • 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 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 POST application/json /nicepay/direct/v2/registration timeStamp
    iMid
    referenceNo
    amt
    merchantKey
    Transaction Registration
    V2 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
    referenceNo
    amt
    merchantKey
    Transaction Cancel
    V2 POST application/json /nicepay/direct/v2/sms-transmit timeStamp
    iMid
    msgRefno
    merchantKey
    SMS Transmit