Refund transaction

Refund a previously authorized and captured transaction

SecurityBearer Authentication
Request
path Parameters
ratepay_transaction_id
required
string

ID of transaction to refund. 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 refund given in currency of original transaction.

Array of objects (ItemDto)

List of refunded 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 refunded special items, e.g. shipping costs or discounts.

Array of objects (VatDto)

List of value-added tax (VAT) amounts.

Responses
201

Refund created

400

Bad request

404

Transaction not found

422

Refund declined

451

Legally not allowed

500

Technical problem

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