Skip to navigation

Pay M-PESA Till From Kibeti

View as Markdown

Pays an M-PESA Buy Goods till from the caller’s Kibeti wallet. The Kibeti wallet is taken from the logged-in user, so no wallet id is sent. description is optional (max 100 characters).

Runs the same pipeline as any M-PESA till payment: 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, which Kibeti shares; 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
tillNumberstringOptionalformat: "color"
descriptionstringOptional

Response

201 Created
codeintegerOptional
messagestringOptional
dataobjectOptional

Errors

404
Not Found Error