{primary} To start using the TradeSafe API you only require a basic account to get started with development. Registering your application requires three basic steps, form there you have full access to integrate TradeSafe into your application.
You can access the development portal from the Merchant Portal button found at www.tradesafe.co.za.
Use the Merchant Portal to register or login. Alternatively, start by clicking Register or Login if you already have a TradeSafe merchant account.
Once registration has been completed you will be taken to the profile page to complete your profile.
Once registered you will need to complete your profile, which required the following information:
You will also have the opportunity to verify your email address and mobile number at this point.
At any point in time if you need to change your details you can click on profile in the sidebar.
Once your profile has been updated, you will be taken to the organisation page. Here you will need to provide the details of your organisation.
As you are in a development environment, you do not need to provide any valid company information at this stage (i.e. use 000000 for the bank account number etc.). However, we strongly encourage you to complete this information accurately from the get go, as we will verify your company before taking you live.
{warning} Please note your TradeSafe business account will have to be verified in order for you to go to production
If you have already registered an organisation on the TradeSafe platform, the organisation will be copied over to the developer portal. Just click on Organisations, then click edit. Please review your business details and then click save. You will then be able to register your application.
To add a new organisation, please provide the following details:
After creating your organisation you will be taken to the application creation page. Here you can configure the various details of your application from which gateways you want to use to where the user should be redirected after payment.
{info} If you are using a prebuilt integration option like our WordPress Plugin, it will provide you with the required details to compete the application registration process.
On the application setting form you can configure:
{warning} Once your application is saved you will be provided with a Client ID and Secret Key. Ensure you properly store these details as once you leave the page the secret can not be retrieved, you will be required to create a new application to generate a new key.
The application details section required a name and the organization associated with the application. Optionally a logo can be included that will be displayed on the payment page. The dimensions for the logo are 300x150. Larger logos will be scaled down to the match these dimensions.
The section allows you to select which payment options are available to your users.
The currently available options are:
Toggle weather or not you want the buyer to receive a payment receipt from TradeSafe.
The OAuth callback URL for your application.
The URL that we will send transaction updates to.
The page your users will be directed to after a successful payment.
The page your users will be redirected to after a canceled or failed payment.
{info} When making changes to existing URL callbacks, it may take up to 15 minutes for the changes to propagate on our system
You will now have access to the dashboard. As you create and update transactions the dashboard will start filling up with information. The data displayed is based on a 6-month rolling window.