Cancel transaction

Cancel a previously authorized transaction

SecurityBearer Authentication
Request
path Parameters
ratepay_transaction_id
required
string

ID of transaction to cancel. Get an overview of key identifiers used in payment API.

header Parameters
Idempotency-Key
string <= 64 characters

ID generated by client to uniquely identify the request. It is highly recommended to use a UUID version 4. Do not reuse an idempotency key for different calls. See Idempotency for further details.

Prefer
string

According to RFC 7240: Provide return=representation if you prefer that the response to a request includes the current state of the resource.

Value: "return=representation"
Request Body schema: application/json
required
gross_amount
required
number decimal places <= 2 > 0

Amount to cancel given in currency of original transaction.

Array of objects (ItemDto)

List of cancelled items

partner_operation_id
string [ 0 .. 255 ] characters

Arbitrary ID of partner for the operation. This ID can be displayed in settlement reports. Get an overview of key identifiers used in payment API.

partner_shop_id
string [ 1 .. 255 ] characters

The shop ID generated by the partner or provided upfront by Ratepay. Get an overview of key identifiers used in payment API. This field is required in case of marketplace transaction.

Array of objects (SpecialItemDto)

List of cancelled special items, e.g. shipping costs or discounts.

Array of objects (VatDto)

List of value-added tax (VAT) amounts.

Responses
201

Cancellation created

400

Bad request

404

Transaction not found

422

Cancellation declined

451

Legally not allowed

500

Technical problem

post/v2/transactions/{ratepay_transaction_id}/cancellations
Request samples
application/json
{
  • "gross_amount": 67.6,
  • "items": [
    ],
  • "partner_operation_id": "cancel-id-1234",
  • "partner_shop_id": "partner-shop-id-1",
  • "special_items": [
    ],
  • "vats": [
    ]
}
Response samples
application/hal+json
{}