When creating an account with pawaPay, you will first receive access to our sandbox environment.
The sandbox environment is completely isolated from our production environment.You can safely test your integration with pawaPay without real mobile money wallets and real money involved immediately after creating your pawaPay account.Access to your production account, where live payments can be made, will be granted after completing the onboarding on your sandbox account.Now that you have an account in our sandbox, let’s look at how to start integrating.
The pawaPay Merchant API uses a bearer token for authentication.
An authorization header is required for all calls to the pawaPay Merchant API.The token can be generated from the pawaPay Dashboard.
Instructions on how to do that can be found in the pawaPay Dashboard Docs.Below is an example payout request with curl:
The API tokens are different between sandbox and production accounts.When moving from sandbox to production a new API token must be generated from the production pawaPay Dashboard.Please store the API token in your application’s environment specific secure storage.
If you are looking to add a second layer of security, you can implement Signatures to ensure security even if your API token should leak.
As the pawaPay API is asynchronous, we recommend implementing a callback handler in your application to find out about the final status of your payments as soon as they are processed.You can read more about how to do that from the pawaPay Dashboard docs.When configured, we will send you a callback with the final status of a payment to your configured callback URL. Read more about callbacks.
You can test the pawaPay Merchant API and Dashboard with your sandbox account right after signing up.
You do not need to go through the onboarding process for that since no real money is involved.There are special phone numbers available to simulate successful and different failure cases.
It is not possible to see the authorization flows (i.e. entering the PIN prompt) in sandbox.
Here’s a few helpful resources to get everything you need to start integrating and testing.