Skip to navigation

Send To Mobile Money From Kibeti

View as Markdown

Sends money from the caller’s Kibeti wallet to an M-PESA or Airtel Money number. destination takes the same values as Initiate Withdrawal, limited here to MPESA or AIRTEL; the phone number must be on that network. The Kibeti wallet is taken from the logged-in user, so no wallet id is sent.

Confirm it with Confirm Withdrawal (POST /transactions/withdraw/confirm), then Confirm Withdrawal OTP (POST /transactions/withdraw/confirm/otp). Choice is called on the parent Personal wallet’s account; the hold and debit land on the Kibeti wallet.

Headers

AuthorizationstringOptional
X-Device-IdstringOptional

Required on non-GET requests to non-public paths (DeviceSignatureFilter), skipped for GET/whitelisted/multipart requests and in the local profile.

X-SignaturestringOptional

Base64 ECDSA signature over sha256(body) + timestamp + requestId, signed with the device’s registered private key.

X-TimestampstringOptional

Unix epoch seconds; must be within 5 minutes of server time.

X-Request-IdstringOptional

Unique per request - reused values are rejected as replays.

Idempotency-KeystringOptional

Required by @RequireIdempotencyKey

Request

This endpoint expects an object.
amountintegerOptional
destinationstringOptional
phoneNumberstringOptionalformat: "utc-millisec"

Response

201 Created
codeintegerOptional
messagestringOptional
dataobjectOptional

Errors

400
Bad Request Error
404
Not Found Error