Endpoint - Post Sale Options

This call is made when creating an RMA or refund request for orders from this channel. It allows you to determine what kinds of refunds and returns are supported on the channel, so that the UI is presented accordingly.

📘

If you provide any reasons, you must provide a reason for all supported post sale actions.

Request

Post

GetPostSaleOptionsRequest

Field NameTypeDescription
AuthorizationTokenStringAuthorization Token from the customers integration.

Sample

{
  "AuthorizationToken": "0dfdbaf3e4d5434f825e774e31bcc148"
}

Response

GetPostSaleOptionsResponse

Field NameTypeDescription
ErrorStringIf there was an error with the product update.
CanCancelBooleanDetermines whether the channel allows cancelling an order.
CanCancelOrderLinesBooleanDetermines whether the channel allows cancelling individual order lines.
CanCancelOrderLinesPartiallyBooleanDetermines whether the channel allows cancelling only part of an order line (not the full quantity).
AutomaticRefundOnCancelBooleanDetermines whether the channel will automatically refund an order when it is cancelled.
CanRefundBooleanDetermines whether the channel allows refunding an order.
CanAttachRefundToItemBooleanDetermines whether the channel allows attaching refunds to a particular order line.
CanAttachRefundToServiceBooleanDetermines whether the channel allows attaching refunds to service lines.
RefundShippingTypes
Required
ShippingRefundTypeDetermines how the channel deals with shipping refunds.
CanRefundAdditionallyBooleanDetermines whether the channel allows creating refunds independent of any items/shipping.
CanReturnBooleanDetermines whether the channel allows creating returns.
PostSaleReasons
Required
PostSaleReasons[]Provides a list of reasons for post-sale actions.

ShippingRefundType (Flagged Enum)

FlagNumeric ValueDescription
NotSupported0Shipping refunds are not supported.
TiedToItem1Shipping refunds are only supported when attached to an item.
Independent2Shipping refunds are supported as independent refunds.

PostSaleReasons

Field NameTypeDescription
Tag
Required
StringValue used when submitting to the channel, e.g. OrderedWrongSize.
DisplayName
Required
StringA user-readable version of Tag, displayed to the user, e.g. Ordered Wrong Size.
Type
Required
ChannelReasonType[]The action this reason relates to, e.g. is this a reason for cancelling an order, or is it a reason for refunding shipping cost, or both etc.
SubReasonsSubReason[]Any subreasons for the reason.

ChannelReasonType

TypeNumeric ValueDescription
Cancellation0The reason is used when cancelling an order.
ItemRefund1The reason can be used as a reason for refunding an item.
ShippingRefund2The reason can be used as a reason for refunding the shipping cost.
ServiceRefund3The reason can be used as a reason for refunding a service item.
AdditionalRefund4The reason can be used for any additional refunds made.

SubReason

Field NameTypeDescription
Tag
Required
StringValue used when submitting to the channel.
DisplayName
Required
StringA user-readable version of Tag, displayed to the user.

Sample

{
  "Error": null,
  "CanCancel": true,
  "CanCancelOrderLines": true,
  "CanCancelOrderLinesPartially": true,
  "AutomaticRefundOnCancel": false,
  "CanRefund": true,
  "CanAttachRefundToItem": true,
  "CanAttachRefundToService": false,
  "RefundShippingTypes": 0,
  "CanRefundAdditionally": false,
  "CanReturn": false
}