Skip to navigation
Sare Core APIWallet

Opt In To Kibeti

View as Markdown

Activates the caller’s Kibeti (PERSONAL_BUSINESS) wallet after checking their wallet PIN, and saves individualKraPin to their KYC profile.

  • No Kibeti wallet yet: creates one as a sub-wallet of the caller’s Personal wallet. If that Personal wallet isn’t already a Choice Current Account (C001), a wallet upgrade is requested from Choice in the background.
  • INACTIVE (previously opted out): reactivates it.
  • Already ACTIVE: returns it unchanged.
  • BLACKLISTED, FROZEN or DORMANT: rejected.

Requires an active Personal wallet. Sends a best-effort SMS on success.

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.
pinstringOptionalformat: "utc-millisec"
individualKraPinstringOptional

Response

200 OK
codeintegerOptional
messagestringOptional
dataobjectOptional

Errors

400
Bad Request Error