Incrementally authorize transaction

Increase the amount of a previously authorized transaction

SecurityBearer Authentication
Request
path Parameters
ratepay_transaction_id
required
string

ID of transaction to extend with additional authorization. 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 increase given in currency of original transaction.

Array of objects (ItemDto)

List of items to add.

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 special items to add, e.g. shipping costs or discounts.

Array of objects (VatDto)

List of value-added tax (VAT) amounts.

Responses
201

Authorization created

400

Bad request

404

Transaction not found

422

Authorization declined

451

Legally not allowed

500

Technical problem

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