Skip to main content
POST
Withdraw via Lipa na M-Pesa (Kenya)
Send money from integrator wallet to customer via Lipa na M-Pesa STK Push or to a business shortcode.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
amount
number
required

Amount to pay

Example:

100

walletId
string
required

Wallet ID to debit from

Example:

"5f9b2c7b9c9d6b0017b4e6b1"

lipaNaMpesaDetails
object
required

Lipa na M-Pesa payment details

callbackUrl
string

Callback URL for status updates

Example:

"https://example.com/callback"

referenceId
string

Your reference ID

Example:

"LIPA-001"

Response

success
boolean
Example:

true

message
string
Example:

"Lipa na M-Pesa withdrawal has been successfully created."

data
object