Skip to navigation

Pay M-PESA Paybill From Kibeti

View as Markdown

Pays an M-PESA Paybill from the caller’s Kibeti wallet. accountNumber is the customer’s account at the biller and is required. The Kibeti wallet is taken from the logged-in user, so no wallet id is sent. description is optional (max 100 characters).

Confirm it with Confirm Bill Payment (POST /transactions/pay-bill/confirm), then Confirm Bill Payment OTP (POST /transactions/pay-bill/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
paybillNumberstringOptionalformat: "color"
accountNumberstringOptional
descriptionstringOptional

Response

201 Created
codeintegerOptional
messagestringOptional
dataobjectOptional

Errors

400
Bad Request Error
404
Not Found Error