Skip to main content

Welcome to PostaPay APIs

Introduction

PostaPay API provides a whole host of products that can facilitate you to improve your business processes and gain a better competitive edge. We expose endpoints for C2B, B2C, B2B, Utilities and Wallet as a Service(WAAS).

Explore Our APIs

How to get started

To start integrating with PostaPay API, follow the steps below:

1.Register as a PostaPay Merchant.

The process of registering is straightforward:

  • Download the PostaPay business application forms Here.
  • Fill out the business application forms.
  • Email the filled out forms together with KYC documents to merchants@postapay.co.ke.

Once your merchant account is created, you will receive the login details you can use to access the merchant portal.

2. Get Started as a Developer​

To register as a developer, you need to first have an active PostaPay user account.

Below are the steps required to set up the PostaPay Developer portal to start testing PostaPay APIs.

  1. Download PostaPay App to create a PostaPay user account.
  1. Once registered as a user, Register on PostaPay Developer Portal.
  2. Use the phone number and password you set during registration to Login.
  3. Go to the SANDBOX APPS tab and click on the Create A New Sandbox Application button to create a testing application.
  4. Enter the name of your application, the callback url and the service(C2B/B2C/B2B or WAAS) you want to subscribe to from the dropdown.
  5. To start testing you will need the API Credentials namely CLIENT ID and CLIENT SECRET and these are accessed from the sandbox app created in number 5.
  6. Use the credential to test the various end points and note down the test cases results on the Test Cases Document

NB: You will need the test case document above to create the Production application, when going live.

Go Live

Our GoLive process is straightforward:

  1. While logged in to the Developer Portal,switch to the PRODUCTION APPS tab where you can view or create Production Applications.
  2. To create a production application, click the button labeled Create a New Production Application. Enter the name of your application, the callback url and the service(C2B/B2C/B2B or WAAS) you want to subscribe to from the dropdown.
  3. One Time Password(OTP) will be sent to the owner of the paybill. Enter the OTP on the Verification code prompt on the form.
  4. Upload the Test Case Document filled while testing the API.
  5. Click Submit to submit the form.
  6. Kindly await for your production application to be approved.

NB: Until the app is approved, you cannot access CLIENT ID and CLIENT SECRET for the application.