OAuth Token Generation
In order to initiate API requests on behalf of your merchants, you will first need to retrieve OAuth tokens. The process is illustrated below:
- The Nuapay Customer Support team will issue an API Key to you upon request or you may generate your own API Key via the Nuapay Console.
- The OAuth token retrieved from the
/tokensendpoint allows you to then generate API requests on behalf of a specific merchant/organisation. - When generating an API request, provide the retrieved token as the authentication username in all your API requests.
- A password is not required, however the request must be made from an allowed-IP-address.
| API authentication header format: | Authorization: Bearer <OAuth Token> |
Scopes and Time To Live (TTL)
Before generating an OAuth token for a specific organisation you will need to specify the scopes required and the token’s TTL.
At least one scope must be included in your request.
The TTL by default is 10 seconds but long-lived tokens may also be created by configuring the expiresIn value in the request body.
API Details - GET /organisations
When working with our APIs, please use the Sandbox URI when testing and the Live URI when you move to Production.
LIVE https://api.nuapay.com SANDBOX https://sandbox.nuapay.com/
If you haven't done so already and would like to do some testing, please Request Sandbox Access
Important: Endpoints and Webhooks may be extended from time to time and any changes we make will follow our Versioning and Backward Compatibility rules. This means that the code that you write today must be designed to be robust enough to handle any future changes (where a new object is added to (or removed from) a specific API response, for example).
Use the GET /organisations endpoint to retrive the organisations linked to your partner entity:
Use the returned Organization identifier to Request a Token.