M-Pesa icon

M-Pesa

Consume M-Pesa Daraja 3.0 APIs

Actions12

B2B → Payment Request

AI-generated

Summary

Send a business-to-business (B2B) payment request to transfer funds from your organization to another business via M-Pesa Daraja API.

Inputs

  • Initiator Name (required) — The username of the API operator as set on the M-Pesa portal.
  • Payment Type (required) — Select the type of B2B payment to make, such as Business Pay Bill, Business Buy Goods, Disburse Funds To Business, Business To Business Transfer, or Merchant To Merchant Transfer.
  • Amount (required) — The amount of money to be transferred.
  • Sender Shortcode (Party A) (required) — Your organization's shortcode initiating the transaction.
  • Receiver (Party B) (required) — The shortcode identifying the receiving business.
  • Sender Identifier Type (required) — The type of organization sending the payment (currently only Shortcode supported).
  • Receiver Identifier Type (required) — The type of organization receiving the payment (currently only Shortcode supported).
  • Remarks (required) — Comments or remarks sent along with the transaction.
  • Queue Timeout URL (required) — URL to receive a notification if the payment request times out.
  • Result URL (required) — URL to receive the asynchronous transaction result callback.
  • Account Reference (required) — Account number or reference for the B2B transaction.

Output shape

a single JSON response object from the M-Pesa B2B payment request API call

The operation returns the raw JSON response from the M-Pesa B2B payment request endpoint. The response includes transaction status and details as provided by the Daraja API. The request is asynchronous; transaction results are posted to the specified Result URL.

Links

Discussion