Yoyo Logo

Voucher Issuing

Issue vouchers via SMS, WhatsApp, or your own channels

Via SMS or WhatsApp

Quick Start

Yoyo handles delivery - just provide a mobile number

How it works

  1. 1Call the Issue Coupon API with campaign ID and mobile number
  2. 2Yoyo creates the voucher and generates a unique wiCode
  3. 3Yoyo automatically delivers the voucher via SMS or WhatsApp
  4. 4Customer receives the wiCode and can redeem at any integrated merchant
Issue Voucher with Message Delivery
# Issue voucher and send via configured channel (SMS or WhatsApp)
curl "https://za-vsp-int.wigroup.co/cvs-issuer/rest/coupons?issueWiCode=true" \
  -H "apiId: {apiId}" \
  -H "apiPassword: {apiPassword}" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "campaignId": "1234",
    "userRef": "your_customer_ref",
    "mobileNumber": "+27821234567",
    "smsMessage": "Your voucher code is ready!",
    "sendSMS": true
  }'

Note: The communication channel (SMS or WhatsApp) is configured at the system level, not per-request. Set sendSMS: true to trigger delivery via your configured channel. WhatsApp requires additional META configuration. The userRef field is mandatory for tracking.

Distribute in Your Own App or Channel

Get the wiCode and display it however you want

How it works

  1. 1Call the Issue Coupon API with userRef but without sendSMS
  2. 2Yoyo creates the voucher and returns the wiCode in the response
  3. 3Display the wiCode in your app, email, or any custom channel
  4. 4Customer uses the wiCode to redeem at any integrated merchant
Get wiCode for Custom Distribution
# Issue wiCode only — no message sent
curl --location 'https://za-vsp-int.wigroup.co/cvs-issuer/rest/coupons?issueWiCode=false' \
  -H "apiId: YOUR_API_ID" \
  -H "apiPassword: YOUR_API_PASSWORD" \
  -H "Content-Type: application/json" \
  -d '{
    "campaignId": "1234",
    "userRef": "your_customer_reference"
  }'
Use Cases
  • Display in your mobile app
  • Send via your own email system
  • Print on receipts or marketing materials
Response Fields
  • wiCode - The redemption code
  • id - Voucher ID
  • stateId - A = Active