Now Prepay's API supports multiple distribution channels, including self-serve kiosks, attended POS terminals (POS), and Host to Host. The billing system supports postpaid accounts and prepaid eCash accounts. You should know which kind of billing account you will be using before completing your development integration.
Integration development of your client application can be done to various levels or completed in phases. For example:
PIN products only
Real time reload / topup products only
Hard coded receipt layouts
Manual product file transfer and updating
Automated product file transfer and updating
It is recommended the client side have a response timeout of 20 seconds.
You should discuss the integration and launch plan with your Now Prepay contact before starting development.
In order to make a call to Now Prepay, there are several things a developer must understand. We recommend learning the following concepts in order:
Learn about Product Types and Store GUI's.
Learn about the files contain the information about the products including voucher content.
Decide on which protocol you want a make a call to Now Prepay.
Implement the API call that relates to the Product you want to sell and which Store GUI it will use.
The Now Prepay system caters to many types of clients, from personal handheld devices to centralized servers. Integrations are to be customized to fit the business needs.
All products are on the Now Prepay system are associated to a six character “product” code and a “value” code which are to be included in all transaction requests. These codes and values can change over time and are communicated using a “product file”. New files are scheduled for release approximately four times a year, or more frequently if there is an update which cannot wait until the scheduled release. New product file versions are to be checked for availability at least once per week. Daily is recommended.
The product file contains the codes and values available on the system, as well as instructional text and terms and conditions. The product file is a standardized file provided to a large group of Now Prepay customers and/or client types and is not typically customized. Now Prepay must approve the final output generated by all integrators meets the needs of the end user and any requirements by the product suppliers.
Note that it is necessary to support Canadian French if products are offered to Quebec users.
Some products can be requested and held in your local inventory (pre-fetched) before sale to the end user (e.g. most mobile pins) and some products must be transacted live (e.g. real-time top up). It is recommended all products be requested from the Now Prepay server real-time.
If the integration is between the Now Prepay system and a central distributor or single server (i.e. server to server) it is only necessary to use one billing (or “merchant”) account. If Now Prepay is to have individual arrangements with those using the client solution, each user will have their own merchant account. Each merchant account can have one or many client (or “terminal”) IDs, depending upon the number of physical machines, locations, and transaction volume by the merchant. Individual Terminal ID's are required to process transactions in sequence. If large volumes do not easily allow for sequential processing, more than one Terminal ID is to be used.
Depending upon the arrangement, the unique transaction number generated by Now Prepay may need to be shown to the end user. If Now Prepay is not providing support to the end user, this transaction number does not need to be displayed to the end user, but must be provided to Now Prepay for any support inquires.
The client’s reporting, reconciliation and support processes must be considered to ensure the developed solution meets the business requirements. Requirements are to be provided before development begins.
Now Prepay test system credentials and developer support for the Now Prepay test system are provided after the integration specifications are agreed. During development the developers should maintain an open dialogue with the Now Prepay development support team. Now Prepay can provide assistance validating results, provide test scenarios, and recommend test cases.
After both the client and Now Prepay agree development is complete, formal certification is required. Now Prepay provides the client a test script to be completed.
Production transactions are allowed after certification has passed, the production systems configured, and a few production control transactions have been validated.