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

HeaderTypeStatusDescription
AuthorizationstringRequiredBearer vxz_tok_* (OAuth 2.0 Scoped Bearer Token)
Content-TypestringRequiredapplication/json
POST/v1/c2b/qrLive & Sandbox

Body Parameters (JSON)

ParameterTypeStatusDescription
amountnumberRequiredAmount to collect in KES
referencestringRequiredYour unique transaction reference
qrTypestringConditionalEMVCo 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"
}