Sign in

v47

OpenAPI 3.0.0raw.githubusercontent.com2026-08-013871777.1 KB
Refund

Create a refund

Creates a refund for the specified order. The order can be specified either by Ivy's internal orderId or by the referenceId provided by the merchant during checkout creation. If the refund should only be partial, you can specifiy this with the amount parameter.

post/api/service/refund/create

Headers

Idempotency-Keystring

Idempotency key for safe retries. Reusing a key with an identical request body returns the cached response. Reusing a key with a different body returns 409.

Request body

orderIdstring

The internal Ivy id of the order. Must be present in request body if referenceId is not provided

referenceIdstring

The external id set by the merchant during checkout creation. Required if orderId is not passed.

bankStatementReferencestring

An optional custom text that will be shown on the customer's payment reference. Input has to be maximum 16 alpha-numeric characters. If not provided, a default Ivy refund referenceId will be shown.

amountnumber required

Response

Creates a refund and returns the details of created refund

idstring required

The unique Refund id

amountnumber required

The amount of the refund in decimals.

currency'EUR' | 'USD' | 'GBP' | 'PLN' | 'SEK' | 'DKK' required

Refund's currency.

status'initiated' | 'pending' | 'succeeded' | 'failed' required

The current status of this refund.

orderIdstring required

The id of the refunded order

transactionIdstring

The id of the transaction