API Reference

Getting Started

Secure transactions with Nowpay and integrate in your website/app.
A brief overview of Nowpay's services, API stack, and tools for developers.

Welcome to the world of APIs. Start Building with Nowpay now. API is the abbreviation for Application Programming Interface. An API allows a third party application to use a common set of services via a defined interface.
As a recommended security measure, you validate each transaction response via a server-to-server (S2S) API call. Transaction revalidation protects from request/response tampering possible in-browser calls. Based on the response received, you display the order status to the customer.

Understanding account credentials
  • Username - This is a unique identifier provided by Nowpay to every API merchant. UID is part of your account credentials and production UID will be available once your activation is complete.
  • Key - This is a unique secret key used for secure encryption of every request. This needs to be kept on server-side and should not be shared with anyone.
  • IP whitelisting allows us to create lists of trusted IP addresses or IP ranges from which our users can access our domains. IP whitelist is a security feature often used for limiting and controlling access only to trusted users. So at the time of configuration, We would white list user public IP on our firewall, so our web services would be called by the authorized user server only. Similarly, user also would have to white list our public IP to call the web services.
How do I sign up for a developer account on Nowpay development portal?
User account need to be created with Nowpay. After creating an account API Portal and Services Agreement, you can start developing apps.

Detailed Flow Explained

  • Transaction Creation

    • When a transaction request is received at Nowpay server, there are multiple validations carried out like valid source of the request, the structure of request, uniqueness of request etc. Once these validations are passed, a transaction is created.

  • Successful Transaction

    • The customer fills in basic request details to authorize. Once the authorization is successful, response includes succes status which will be consider as successful transaction.

  • Failed Transaction

    • If resposne include status as failed with respective configured values then same will be considered as Failed transaction.

  • Pending Transaction

    • If resposne include status as pending with respective configured values then same will be considered as pending transaction.

    The prepaid mobile recharge plans and tariffs data included in the information services are the Intellectual Properties of the respective Telecom Operator and Service Provider and Nowpay does not own any such Intellectual Property Rights over the same.

    The information services, layout and interface design of the site/app, any visuals on the website/app, presentation and structuring of data on the site/app, is solely owned by Nowpay and is protected by local copyright law and international treaty provisions.

    Nothing in this Agreement shall be deemed to be a transfer of intellectual property rights. It is hereby specifically disclaimed that we shall under no circumstance be liable for any failure to recharge or any other complication arising from a recharge information provided on our Website or App & transaction we facilitate through multiple third parties.

    The user hereby directed to communicate with such third parties directly for any transactional issues.