Skip to navigation

Initiate B2K Transfer (Sare Till to Kibeti)

View as Markdown

Same shape as P2P, but sourceWalletId must be the caller’s BUSINESS wallet (Sare till) and destinationWalletId a Kibeti (KIBETI) wallet - the till owner’s own Kibeti included. Confirm with POST /transactions/confirm, then POST /transactions/confirm/otp.

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

Request

This endpoint expects an object.
sourceWalletIdstringOptional
destinationWalletIdstringOptional
amountintegerOptional

Response

201 Created
codeintegerOptional
messagestringOptional
dataobjectOptional

Errors

400
Bad Request Error