Authorize C2B Payment
Submits the 6-digit OTP code received by the customer to authorize deducting funds from their single unified wallet. Upon verification, funds transfer atomically into your business wallet on the sovereign ledger.
POST/v1/c2b/verify-otpLive & Sandbox
Request Headers
| Header | Type | Status | Description |
|---|---|---|---|
Authorization | string | Required | Bearer vxz_tok_* (OAuth 2.0 Scoped Bearer Token) |
Content-Type | string | Required | application/json |
Idempotency-Key | string | Recommended | Unique key for this operation, 8–80 characters. Send it to make retries safe: repeating the same key returns the original result instead of performing the operation twice. Without it the API derives a key from the request body and replays the original result for a few minutes, so an accidental double submit is still ignored. |
Body Parameters (JSON)
| Parameter | Type | Status | Description |
|---|---|---|---|
transactionId | string | Required | The transaction ID returned by payment initiation (e.g. TXN_C2B_84920199). |
challengeId | string | Required | The OTP challenge ID issued during initiation (e.g. OTP_CHG_94820194). |
otpCode | string | Required | The 6-digit numeric OTP authorization code received by the customer (e.g. 748291). |
Request Code Snippets (cURL, Node, Python, PHP, Go)
Verify OTP Request
curl -X POST https://developer.vixzz.com/v1/c2b/verify-otp \
-H "Authorization: Bearer vxz_tok_c2b_8f9k3m9s2a1l" \
-H "Content-Type: application/json" \
-d '{
"transactionId": "TXN_C2B_84920199",
"challengeId": "OTP_CHG_94820194",
"otpCode": "748291"
}'JSON Return Response Body (200 OK)
Settlement Response
{
"success": true,
"transactionId": "TXN_C2B_84920199",
"status": "COMPLETED",
"type": "paybill",
"accountNumber": "3810482910482",
"amount": 2500,
"currency": "KES",
"fee": 0,
"netAmount": 2500,
"completedAt": "2026-09-07T02:30:14.441Z"
}