Yoyo Developer Portal

Gift Card Issuing

Issue gift cards for 100+ South African brands

Via SMS or WhatsApp

Quick Start

Yoyo handles delivery - just provide a mobile number

How it works

1Call the Issue Gift Card API with campaign ID, balance, and mobile number
2Yoyo creates the gift card and generates a unique wiCode
3Yoyo automatically delivers the gift card via SMS or WhatsApp
4Customer receives the wiCode and can redeem at any integrated merchant

Issue Gift Card via SMS/WhatsApp

# Send via WhatsApp (update sendMessage to "SMS" for SMS delivery)
curl -X POST "https://za-vsp-int.wigroup.co/cvs-issuer/rest/giftcards?issueWiCode=true" \
  -H "apiId: YOUR_API_ID" \
  -H "apiPassword: YOUR_API_PASSWORD" \
  -H "Content-Type: application/json" \
  -d '{
    "campaignId": 9000,
    "balance": 10000,
    "mobileNumber": "+27821234567",
    "sendMessage": "WHATSAPP"
  }'

Note: The sendMessage type must be configured on the Yoyo platform. WhatsApp also requires META configuration. Set sendMessage: "SMS" to deliver via SMS instead. You can optionally set a custom SMS message using the smsMessage field.

Distribute and View in Your Own App

Get the wiCode, display the balance, and track usage

How it works

1Call the Issue Gift Card API without a userRef
2Receive the wiCode and gift card ID in the response
3Display the gift card in your app with balance information
4Use the Get Gift Card API to check remaining balance

Issue Gift Card for Custom Distribution

# Issue wiCode only — no message sent
curl -X POST "https://za-vsp-int.wigroup.co/cvs-issuer/rest/giftcards?issueWiCode=true" \
  -H "apiId: YOUR_API_ID" \
  -H "apiPassword: YOUR_API_PASSWORD" \
  -H "Content-Type: application/json" \
  -d '{
    "campaignId": 9000,
    "balance": 25000
  }'

Use Cases

Display balance in your mobile app
Corporate gift card programs
Reward and incentive platforms

Response Fields

wiCode - The redemption code
balance - Remaining value in cents
id - Gift card ID