Play around with our API using Postman
The pawaPay API enables you to pay and get paid with mobile money in Sub-Saharan Africa.
Let’s play around with the API in Postman
Fork our API to your workspace in Postman
Create an account with pawaPay
If you haven’t done so already, create an account in our sandbox. It only takes a few minutes and you can start testing our API immediately.
Generate the API token
Now go to System configuration > API tokens and generate an API token.
Please store it immediately. We do not store the tokens in pawaPay for security reasons.
Set up an environment in Postman
- Choose “Environments” from the sidebar in Postman and select the little ”+” button.
- Name the environment as you please. For example, “pawaPay sandbox”.
- Add the following variables into your environment:
| Variable | Value |
|---|---|
| apiToken | Paste the token you just generated as the value |
| baseUrl | https://api.sandbox.pawapay.io |
- Remember to save your changes.
- Choose the newly created environment from the environment dropdown in the upper right corner.
All done!
You can now start sending requests to the pawaPay API in the sandbox. Try “Initiate deposit” for example.
And explore our API reference to learn more about:
Deposits
Find out how to get paid.
Payouts
Find out how to pay someone.
Refunds
Find out how to refund someone’s payment.
Active configuration
Find out what’s available on your account and all the parameters you need to pay and get paid.
…and much more.
Want to test callbacks with Postman as well?
The pawaPay API is asynchronous. The fastest way to find out about the final status of a payment is through callbacks. Let’s configure those as well so you can see the whole flow in Postman.
Set up a mock server in Postman
- Choose “Mock servers” from the sidebar and select the little ”+” button.
- Choose “Select an existing collection”.
- Select the “pawaPay Merchant API” as the collection to mock.
- Name the server as you please. For example, “pawaPay sandbox”.
- Select “Create Mock Server”.
- Copy the mock server URL.
Set up callbacks
Sign in to the sandbox dashboard and go to System configuration > Callback URLs.
Select “Edit” and paste the callback URL you copied from Postman into the input boxes.
Once configured for all your flows, select “Save Changes”.
All done.
You can now start sending requests to the pawaPay API in the sandbox.
You will see the callbacks in the Mock servers tab when clicking on the mock server you just created.
Don’t forget to click “Refresh logs” after initiating a payment.
What to do next?
Check out the guides we have for different payment flows. You can test them in Postman as you go through them.