Skip to navigation
Sare Core APIWallet

Confirm Airtime Purchase OTP

View as Markdown

Places the hold on the wallet and confirms the OTP with Choice, which releases the top-up. Status becomes PROCESSING; the final outcome arrives by callback and the customer is notified.

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.
transactionIdstringOptional
otpstringOptionalformat: "color"

Response

200 OK
codeintegerOptional
messagestringOptional
dataobjectOptional