How to Create Vouchers Using Snapplify's Ecommerce Voucher API

Use the Origin Voucher API to create vouchers for redeeming digital content (like eBooks or audiobooks). This guide walks you through the full process — from setup to handling API responses and errors.

API Documentation can be found on our developer portal.

You can optionally use the Snapplify Ecommerce plugin to manage vouchers with Wordpress.

Prerequisites

Before you start:

• Get your API key from Snapplify 
• Format: JSON
• Method: POST

API Endpoint

Define Voucher Parameters

Use the following parameters to define your voucher in the request body:

Field Rules and Defaults

How voucher fields behave depends on how the voucher is created:

• Both voucher.reference and voucher.label are optional.
• If voucher.label is not provided, it defaults to the value of voucher.reference.
• If voucher.reference is not provided, it defaults to the value of voucher.code.
• If voucher.code is not specified, a code is generated automatically.

Example Request 

{
  "label": "SNAPVOUCHER",
  "reference": "ORDER123",
  "quantity": 1,
  "email": "user@example.com"
}

{
  "label": "Snapplify Voucher",
  "code": "SNAPVOUCHER123",
  "reference": "Snapplify Voucher",
  "quantity": 1,
  "quantityRemaining": 1,
  "email": "user@example.com",
  "sessions": 1,
  "autoRedeem": false,
  "createdAt": "2023-09-02T07:21:14+00:00"
}

Advanced Use Cases and Notes

Redeem limits and multiple use

You can control how many times a voucher can be used (quantity) and whether it can be used by multiple users or just one (sessions).

Example – Single user, multiple redemptions

{
  "label": "Single User Multi-Redeem",
  "reference": "STUDENT456",
  "quantity": 3,
  "sessions": 1
}

{
  "status": 400,
  "message": "Could not create voucher: {Your Custom Error}"
}

Once your voucher is created, test it in your application or platform to confirm it works as expected. If needed, use the API responses and error messages to troubleshoot.

To learn more about using vouchers or managing redemptions, explore the related articles below.