Dynamic EMVCo QR Code Generation
Generate dynamic, amount-locked EMVCo QR codes that customer banking and wallet apps can scan for one-click checkout.
Request Headers
| Header | Type | Status | Description |
|---|---|---|---|
Authorization | string | Required | Bearer vxz_tok_* (OAuth 2.0 Scoped Bearer Token) |
Content-Type | string | Required | application/json |
POST/v1/c2b/qrLive & Sandbox
Body Parameters (JSON)
| Parameter | Type | Status | Description |
|---|---|---|---|
amount | number | Required | Amount to collect in KES |
reference | string | Required | Your unique transaction reference |
qrType | string | Conditional | EMVCo QR category (default DYNAMIC) |
Request Code Snippets (cURL, Node, Python, PHP, Go)
Request Example
curl -X POST https://developer.vixzz.com/v1/c2b/qr \
-H "Authorization: Bearer vxz_tok_c2b_8f9k3m9s2a1l" \
-H "Content-Type: application/json" \
-d '{
"merchantId": "MER_948201",
"amount": 5000,
"currency": "KES",
"expiryMinutes": 15
}'JSON Return Response Body (200 OK)
Response
{
"success": true,
"qrString": "00020101021226500010KE.CO.VIXZZ0109MER_948201520454115303404540450005802KE5914VIXZZ_MERCHANT6007NAIROBI62210117ORDER_948201_VXZ6304A1B2",
"qrImageUrl": "https://developer.vixzz.com/v1/qr/render/QR_948201.png",
"expiresAt": "2026-09-07T02:45:00.000Z"
}