> ## Documentation Index
> Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Voucher API

> Create, manage, and redeem vouchers in JTL Voucher Cloud.

The Voucher API lets you issue vouchers, control their lifecycle (activate, reserve, charge, refund, recharge), and manage client access. It is built on OAuth 2 client credentials and supports both production and sandbox environments.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/guides/voucher/quickstart">
    Set up a client, get credentials, create your first voucher, and run through the full charge flow.
  </Card>

  <Card title="Error codes" icon="triangle-alert" href="/guides/voucher/error-codes">
    Error response format and all validation error codes grouped by operation.
  </Card>

  <Card title="Authentication" icon="key" href="/guides/voucher/quickstart#3-get-an-access-token">
    The Voucher API has its own OAuth 2 server and a pin-based credential exchange. See the quickstart for the token endpoint and setup steps.
  </Card>
</CardGroup>

## Environments

| Environment | Base URL                                       |
| ----------- | ---------------------------------------------- |
| Production  | `https://vouchers.api.jtl-software.com/v1`     |
| Sandbox     | `https://vouchers-sbx.api.jtl-software.com/v1` |

## OpenAPI Spec

Import into Postman, Insomnia, or generate a client: [Download JSON](/openapi/voucher.json).