Developer Platform

Yoyo Integration APIs

Issue, redeem, and reward customers — with APIs built to integrate fast.

Yoyo powers South Africa's largest retail network. Issue vouchers. Sell gift cards. Redeem in-store and online. Run loyalty. Our APIs do it all — with advanced rule engines, campaign logic, settlement and reconciliation handled underneath.

What you can build

Issue vouchers

Send a voucher wherever your customers are — SMS, WhatsApp, or your own channels. Built for deals and rewards.

Start building

Sell gift cards

Digital gift cards from 100+ South African brands. One integration, the whole catalogue.

Start building

Redeem anywhere

In-store. Online. One flow. Accept vouchers, coupons, and gift cards anywhere you sell.

Start building

Reward every transaction

Earn automatically on card transactions, or issue to any mobile number off any trigger. One endpoint.

Start building

One journey, end to end. Issue a voucher, redeem it, reward what comes next.

Start building

Request API access and receive your test apiId and apiPassword.
Make your first call
Authenticate and send one minimal request to confirm you're connected.
Build your flow
Follow the guide for your integration: issue, redeem, or reward.
Go live
Run the test checklist and switch to production credentials.

Make your first call

Issue a voucher with a single request. Replace the placeholder credentials with your test apiId and apiPassword.

Need credentials first?

Issue a voucher

# Replace {apiId} and {apiPassword} with your test credentials
curl -X POST "https://za-vsp-int.wigroup.co/cvs-issuer/rest/coupons?issueWiCode=true" \
  -H "apiId: {apiId}" \
  -H "apiPassword: {apiPassword}" \
  -H "Content-Type: application/json" \
  -d '{
    "campaignId": "1234",
    "userRef": "your_customer_ref",
    "mobileNumber": "+27821234567"
}'

A successful response returns "responseCode": "-1" and a wiCode in the payload. See the Voucher Issuing guide for the full request reference.

More resources

General Information and FAQs

Authentication, environments, and common questions.

Get instant answers from the docs.

Need help?

Contact our integration team at help.integrations@yoyogroup.com.