Skip to navigation

Initiate P2K Transfer (Personal to Kibeti)

View as Markdown

Same shape as P2P, but sourceWalletId must be the caller’s PERSONAL wallet and destinationWalletId another user’s Kibeti (KIBETI) wallet. Paying your own Kibeti is rejected with 400 - use POST /transactions/kibeti/deposit. 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