Wallet Payments API (KENYA)

With this, you can make direct call to the backend implementation

It also allows you to manage the payment flow from end to end. This means that you can build your own user interfaces and customer experiences.

📘

Get Your Token

To make an API call to the Wallet Payments API, you must first generate an access token. Please follow the link below to generate your token:

Generate your Token: Click here to generate your access token

To get started with the Wallet Payments API, you will need to

1- Make a payment request

Once you have an access token, make a POST request to the following endpoint:

📘

TEST URL

https://qa.interswitchng.com/collections/api/v2/mobile-wallet/initialize

In the Authorization header, set the value to Bearer <access_token>, where <access_token> is the access token you generated in step 1.

In the request body, include the following parameters:

• order_id: The ID of the order.
• customer_mobile_number: The customer MSISDN.
• order_currency: The currency of the order which must be KES
• pay_item_id: The pay item ID of the order
• merchant_code: A unique reference for the transaction.
• currency This is a constant field. which must be 404
• order_amount The amount of the item purchased
• txn_ref The transaction reference
• mobile_wallet_provider The provider which must be MPESA
• merchant_country The merchant country

  Sample Payload

{
    "order_id": "123",
    "order_currency": "KES",
    "customer_mobile_number": "243815199291",
    "mobile_wallet_provider": "MPESA",
    "pay_item_id": "Default_Payable_MX228251",
    "merchant_code": "MX228251",
    "txn_ref": "11223GHHGGQ49172910130",
    "currency": "404",
    "order_amount": "11",
    "merchant_country": "KE"
}

📘

For more information, see the Interswitch [Transaction Status API documentation]

get a particular transaction

📘

LIVE URL: https://webpay.interswitchng.com/collections/api/v2/mobile-wallet/initialize