Skip to main content

Get refund

Get refund

Path Parameters
orderId int32 — REQUIRED

The order id.

refundId uuid — REQUIRED

The refund id.

Responses
200

The refund with the given id.

Schema — OPTIONAL
Resource object — OPTIONAL

A refund.

RefundId uuid — OPTIONAL

The id of the refund.

RefundInstanceId int32 — OPTIONAL

The internal id of the refund.

OrderId int32 — OPTIONAL

The order id of the order that the refund belongs to.

Reference string — OPTIONAL

A custom refund reference.

Description string — OPTIONAL

A custom refund description.

Author string — OPTIONAL

The name of the author of the refund.

ExternalOrderId string — OPTIONAL

The external order id of the order.

OrderTransactionId string — OPTIONAL

A transaction id of the order.

SecondaryOrderTransactionId string — OPTIONAL

An secondary transaction id of the order.

ExternalId string — OPTIONAL

An external transaction id of the order.

PaymentName string — OPTIONAL

The name of the payment used in the order.

Locale string — OPTIONAL

The locale of the order.

SiteName string — OPTIONAL

The market the order was placed on.

Customer string — OPTIONAL

The customer name.

OrderSum double — OPTIONAL

The sum of the order.

OrderVat double — OPTIONAL

The total vat of the order.

OrderValue double — OPTIONAL

The total value of the order rows.

OrderDiscount double — OPTIONAL

THe total discount on the order.

ShippingFee double — OPTIONAL

The order shipping fee.

PaymentFee double — OPTIONAL

The order payment fee.

Currency string — OPTIONAL

The code of the currency used for the refund.

CreatedOn date-time — OPTIONAL

The date the refund was created.

SentOn date-time — OPTIONAL

The date the refund was marked as sent.

ProcessedOn date-time — OPTIONAL

The date the refund was marked as processed.

Sent boolean — OPTIONAL

If true, the refund has been marked as sent.

Processed boolean — OPTIONAL

If true, the refund has been marked as processed.

RequiresApproval boolean — OPTIONAL

True if this refund requires approval before being sent, processed or settled.

Approved boolean — OPTIONAL

Null if undecided, true if approved and false if denied. Only applicable if RequiresApproval is true.

ApprovalDecidedBy string — OPTIONAL

The name of the one that approved or denied the refund.

ApprovalDecidedOn date-time — OPTIONAL

The date that the refund was approved or denied.

VatRate double — OPTIONAL

Vat rate. E.g. 0.25 for 25%, 0.12 for 12%.

SkipRefundEvents boolean — OPTIONAL

Whether or not refund events will be sent for this refund.

RefundedItemTotal double — OPTIONAL

The total amount refunded from order rows.

RefundedShippingFee double — OPTIONAL

The amount refunded from the shipping fee.

OrderStatus string — OPTIONAL

The status of the order that the refund belongs to.

RefundedPaymentFee double — OPTIONAL

The amount refunded from the payment fee.

RefundedDiscount double — OPTIONAL

The amount refunded from the discount (can be split over several refunds).

Shipped boolean — OPTIONAL

The shipping status of the order that the refund belongs to.

RefundedBalance double — OPTIONAL

The amount refunded from the balance (can be split over several refunds).

RefundedTotal double — OPTIONAL

Total amount refunded.

RefundRows object[] — OPTIONAL

List of refund rows belonging to this refund.

OrderId int32 — OPTIONAL
RefundRowId int32 — OPTIONAL
OrderRowId int32 — OPTIONAL

The order row id that this refund row belongs to, if any.

CaptureId uuid — OPTIONAL

The capture id that this refund row belongs to, if any.

RefundAmount double — OPTIONAL

The refund amount. This can be different than the corresponding order row value.

RefundAmountExVat double — OPTIONAL

The refund amount excluding VAT.

ToBalance boolean — OPTIONAL

If true, the refund amount of this refund row is added to the customer's balance.

Settled boolean — OPTIONAL

If true, the refund row is marked as settled.

SettledOn date-time — OPTIONAL

The date when the refund row was marked as settled.

CreatedOn date-time — OPTIONAL

The date the refund row was created.

Investigation boolean — OPTIONAL

If true, the refund row is marked for investigation.

RefundType int32 — OPTIONAL

Possible values: [0, 1, 2, 3]

The kind of source transaction the refund is derived from. 0 = Default. A regular refund of the order or order row. 1 = InstanceCost. Return cost type, used in drawing cost for instance. 2 = Shipping. Refund shipping type, used to refund shipping. 3 = InvoiceFee. Refund invoice fee.
0 = Default. A regular refund of the order or order row.
1 = InstanceCost. Return cost type, used in drawing cost for instance.
2 = Shipping. Refund shipping type, used to refund shipping.
3 = InvoiceFee. Refund invoice fee.

Rows object[] — OPTIONAL

List of order rows belonging to this refund.

OrderRowId int32 — OPTIONAL

The id of the order row.

ItemId int32 — OPTIONAL

The SKU.

ProductId int32 — OPTIONAL

The product id.

Price double — OPTIONAL

The price of the order row, inc vat.

PriceExVat double — OPTIONAL

The price of the order row, ex vat.

Name string — OPTIONAL

The name of the order row.

ProductName string — OPTIONAL

The name of the product.

Variant string — OPTIONAL

The name of the variant.

Brand string — OPTIONAL

The name of the product brand.

PrimaryImage string — OPTIONAL

The primary image of the product.

ArticleNumber string — OPTIONAL

The article number.

Shelf string — OPTIONAL

The shelf of the SKU.

CampaignNames string — OPTIONAL

The name of the campaigns applied to this order row.

Discount double — OPTIONAL

The discount amount applied to this order row.

SuggestedRefundAmount double — OPTIONAL

A suggested refund amount if this order row were to be returned. This takes into account discounts applied to the entire order.

AverageDiscount double — OPTIONAL

The average discount applied to this order row. This takes into account discounts applied to the entire order.

PriceBeforeDiscount double — OPTIONAL

The price of the order row before any discounts were applied.

Message string — OPTIONAL

A status message for the action taken.

Details string[] — OPTIONAL

Any validation messages for the data on the current action.

400

Bad request.

Schema — OPTIONAL
Message string — OPTIONAL

A status message for the action taken.

Details string[] — OPTIONAL

Any validation messages for the data on the current action.

404

Not found.

Schema — OPTIONAL
Message string — OPTIONAL

A status message for the action taken.

Details string[] — OPTIONAL

Any validation messages for the data on the current action.