Skip to main content
POST
/
reservations
/
{id}
/
charge
Charge a specific voucher reservation
curl --request POST \
  --url https://vouchers.api.jtl-software.com/v1/reservations/{id}/charge \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "order_number": "ORDER-62642"
}
'
{
  "id": "cff8784e5eb28b9b04860",
  "voucher_id": "cff8784e34b28b9b04860",
  "client_id": "cff8784e5eb28b81ca02a",
  "type": "charge",
  "amount": "10.53",
  "order_number": "ORDER-62642",
  "created_at": "2017-07-21T17:32:28+00:00",
  "updated_at": "2017-07-21T17:32:28+00:00"
}

Authorizations

​
Authorization
string
header
required

This API uses OAuth 2 with Client Credentials Flow (see: https://www.oauth.com/oauth2-servers/access-tokens/client-credentials).

You can request only a subset of specific scopes for your client, however the available scopes for each client are defined through the client groups in the UI.

Within your token request, you can also send the optional parameter client_type (string with a max length of 32 chars). This value is only used for internal statistics.

Path Parameters

​
id
string
required

Body

application/json

Voucher charge request body

​
order_number
string
required

Order or invoice number of the transaction for this usage

Example:

"ORDER-62642"

Response

OK

​
id
string
read-only

Primary identification key - will be used in voucher-charge calls

Example:

"cff8784e5eb28b9b04860"

​
voucher_id
string
read-only

Voucher primary identification key (see voucher -> id)

Example:

"cff8784e34b28b9b04860"

​
client_id
string
read-only

Client primary identification key (see client -> id)

Example:

"cff8784e5eb28b81ca02a"

​
type
enum<string>
read-only

Type of this charge. Can either be "charge", "recharge" or "refund"

Available options:
charge,
recharge,
refund
Example:

"charge"

​
amount
string

Amount in the currency of this voucher. Must be send as string in the following pattern:

  • Up to five digits before the decimal point
  • The decimal point (.)
  • Exactly two digits after the decimal point
Required string length: 4 - 9
Pattern: ^\d+\.\d{2}$
Example:

"10.53"

​
order_number
string

Order or invoice number of the transaction

Example:

"ORDER-62642"

​
created_at
string<RFC3339>
read-only

created_at - datetime in RFC3339 format, see https://tools.ietf.org/html/rfc3339

Example:

"2017-07-21T17:32:28+00:00"

​
updated_at
string<RFC3339>
read-only

updated_at - datetime in RFC3339 format, see https://tools.ietf.org/html/rfc3339

Example:

"2017-07-21T17:32:28+00:00"