Logo

Express Deposit

Initiate a direct debit from a user's mobile wallet. This request triggers a STK push or equivalent prompt on the PhoneNumber provided.

DISCLAIMER

This service sends two callbacks. ONLY rely on the second callback for the final status of the transaction. Refer to the IPN section for the structure of the second callback.

Note: A valid token is required for authentication (expires hourly). Check the Token Request section.

Data Definition

Field NameTypeMax LengthDescription
ShortCodestring7The credit party in the transaction.
Amountdecimal8The amount to be debited.
PhoneNumberstring-The debit party (customer phone).
AccountNostring25Nullable; required only for Paybill deposits.
POST/v1/express-deposit

Initiate Deposit

Send an express deposit request to collect funds from a customer's mobile wallet via the sandbox environment.