> ## 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.

# Vouchers API Changelog

> Version history and breaking changes for the Vouchers API.

## 1.8 (2022-02-01)

* Error responses now return unique error codes and more detail (see [Error Codes](/guides/voucher/error-codes))

## 1.7 (2021-11-23)

* The refund endpoint now returns the created refund object
* The full charged amount can now be refunded
* **Deprecated:** The cancel endpoint is deprecated and will be removed in a future version. Use the refund endpoint instead.

## 1.6 (2021-09-13)

* `usages` renamed to `charges` across all endpoints

## 1.5 (2021-08-16)

* `client_type` is now sent at the `oauth/token` call, not the `clients/connect` call

## 1.4 (2021-08-13)

* `client_type` is no longer restricted to fixed values
* Vouchers with active status or existing charges can no longer be deleted

## 1.3 (2021-08-10)

* `code` and `pin` properties (deprecated since v1.1) are now removed from all responses except the voucher create call
* Client groups with old scopes (`can-manage`, `can-use`) are migrated to the new scopes automatically

## 1.2 (2021-08-06)

* New optional `order_number` property on voucher creation

## 1.1 (2021-08-04)

* Refactored client group scopes for more granular access control
* Clients can request a subset of their available scopes when getting a token
* Vouchers can be created with an initial amount of 0
* `client_type` can now be sent in the connect call (optional)
* New endpoint: `PATCH /vouchers` to update `sku` and `batch` on inactive vouchers
* New endpoint: `POST /vouchers/recharge`
* New endpoint: `POST /clients/disconnect` to invalidate all credentials for a client
* New endpoint: `GET /vouchers/{id}/complete` to read voucher secrets (`code` and `pin`)
* **Deprecated:** `code` and `pin` will be removed from all responses except the create call - use the complete endpoint instead