We recommend that you first read the API documentation to familiarize yourself with various concepts and functionality offered by the API.
When you’re ready, you will need to contact us to get access to a Sandbox account where you can start exploring our API. The Sandbox environment acts exactly in the same way as Production but does not use real money. Once your account has been set up you will have access to the Paybase Console where you can view your API keys and account settings. Console is also the dashboard you will use on a day to day basis to manage your account, customers and transactions.
Generating your API Key
You can retrieve your API Token from the Console for both Sandbox and Production on the Integrations tab on the top right menu. If none have been generated, click the New Key button, give it a name and then generate the key. Generating a new key will not affect any existing keys.
Please use the following URLs to connect to our API:
Authenticating your requests
Authentication with the Paybase API is done by passing a token in the
X-Token HTTP request header. This token is used to identify you, as well as authorise requests in the system.
If the token provided is invalid or does not authorise the request, the API will respond with a
403 response code. See the Error Codes section for more information.
X-Token header, there are a number of additional headers that may need to be passed.
|The API Token to authenticate and authorise requests to the Paybase API.|
|In all cases where possible, you should pass the Customer's IP address with requests. Doing this allows us to better protect you against fraud and cyber crime.|
|This offers you the ability to protect against duplicate requests by providing an identifier with an optional TTL. The default TTL is 24 hours.|
|Provide a custom TTL for your request identifier, this is expected in the format |
Postman is an API client that can be used to easily interact with the Paybase API when getting started. It allows you to get up and running quickly and start making test API calls to our Sandbox environment to help you get familiar with our API.
Download the Postman collection for the Paybase API here