Ready2order Coupon API
Coupons are gift cards and vouchers that merchants sell and later accept as payment at the point of sale. The `coupon_value` field always holds the current remaining balance.**Balance and Lifecycle**You create a coupon with an initial value. From there you can [charge it](#operation/couponChargeById) (add value) or [redeem it](#operation/couponRedeemById) (deduct value). Partial redemptions work fine; the coupon stays active until the balance reaches zero.**Coupon Purpose**`coupon_purpose` determines when VAT is due. We distinguish between two voucher types:| Purpose | When VAT is due | `coupon_containsVat` ||---------|-----------------|----------------------|| `single` | At issuance (place of supply and tax rate are known at creation) | The applicable rate, e.g. `20` || `multi` | At redemption (the POS applies the right rate per item) | Must be `0` |Single-purpose suits vouchers for specific goods at a fixed rate, such as a drink voucher tied to a particular product.Multi-purpose fits general gift cards redeemable for anything or across multiple locations.Check with your tax advisor which type applies to your situation.**Identifier**`coupon_identifier` is the numeric code printed on physical voucher cards. If you leave it out, an EAN-13 code is generated automatically. Pass it as the `identifier` query parameter on [GET /coupons](#operation/couponGetAll) to look up a coupon by barcode scan.
Ready2order Coupon API is one of 36 APIs that Ready2order publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Coupon. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.
This API exposes 7 operations across 4 paths. It is described by OpenAPI 3.0.0, at version R2-2026.30.2.
Requests are made against a single base URL, https://api.ready2order.com/v1.
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
Ready2order Coupon API declares
1 security scheme
for authenticating requests.
An API key is passed in the header as Authorization (Bearer).
Bearer— Account Token obtained after completing the authorization flow. See First Steps for details.
Paths & Operations 7
Across 4 paths, the API surfaces 7 operations — 1 DELETE, 2 GET, 3 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.
Coupons are gift cards and vouchers that merchants sell and later accept as payment at the point of sale. The couponvalue field always holds the current remaining balance. Balance…
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Ready2order 12
Other APIs Ready2order publishes across the network.