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

1

Fork our API to your workspace in Postman

Run In Postman
2

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.
3

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.
4

Set up an environment in Postman

  1. Choose “Environments” from the sidebar in Postman and select the little ”+” button.
  2. Name the environment as you please. For example, “pawaPay sandbox”.
  3. Add the following variables into your environment:
VariableValue
apiTokenPaste the token you just generated as the value
baseUrlhttps://api.sandbox.pawapay.io
  1. Remember to save your changes.
  2. Choose the newly created environment from the environment dropdown in the upper right corner.
5

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.
1

Set up a mock server in Postman

  1. Choose “Mock servers” from the sidebar and select the little ”+” button.
  2. Choose “Select an existing collection”.
  3. Select the “pawaPay Merchant API” as the collection to mock.
  4. Name the server as you please. For example, “pawaPay sandbox”.
  5. Select “Create Mock Server”.
  6. Copy the mock server URL.
2

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”.
3

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.

Deposits

Step by step guide on how to get paid by your customers.

Payouts

Step by step on how to pay your customers.

Refunds

Sometimes you need to refund. Follow this guide to refund your customers.

Payment page

Find out how to get paid, with an out-of-the-box payment experience.