Skip to main content
POST
Payouts

Authorizations

Authorization
string
header
required

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

Body

application/json
amount
integer<int32>
default:100
required
currency
string
default:KES
required
country
string
default:KE
required

ISO 3166-1 alpha-2 country code

destination
string
default:MoMo
required

MoMo / Bank Account

externalReference
string
required

A unique ID of your liking to reconcile transactions internally.

payoutMethod
object
externalAccountId
string
debitCurrency
string

The wallet you want to be debited from. If missing, we will default to the currency passed.

debitCountry
string

ISO 3166-1 alpha-2 country scope of the wallet being debited. Required when debitCurrency is different from currency and the debit wallet currency can exist in multiple country scopes, such as USD or XOF.

Response

200

success
boolean
default:true
Example:

true

message
string
Example:

"Withdrawal Request Accepted for Processing."

transactionId
string
Example:

"mIt5ycmF3YCqaOQp6Ljz"