Get Seller Initiated Refunds for order | feedonomics

curl https://marketplace-order-api.feedamp.feedonomics.com/api/v1/orders/mp_order_number/refunds/feedamp_refund_id \
     -H "Authorization: Bearer <token>"

{
  "feedamp_refund_id": 1001,
  "mp_order_number": "ABC-123",
  "status": "CREATED",
  "date_created": "2023-05-02",
  "merchant_refund_lines": [
    {
      "mp_line_number": "ABC-123-GHY-219",
      "currency": "USD",
      "refund_quantity": 1,
      "item_refund": 6.99,
      "item_tax_refund": 0.11,
      "shipping_refund": 0,
      "shipping_tax_refund": 0,
      "discount_refund": 0,
      "reason": "CUSTOMER_CANCELLED"
    }
  ],
  "errors": [
    {
      "code": "EXCESS_ITEM_REFUND",
      "message": "Requested refund amount (100.99) exceeds the line's cost (75.99)"
    }
  ]
}

Get all seller-initiated refunds for an order

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

mp_order_numberstringRequired

The unique Id for an order that is generated by the marketplace

feedamp_refund_idstringRequired

The unique for a seller initiated refund

Response

Order Refunds

feedamp_refund_idinteger

internal unique id that identifies this particular refund

mp_order_numberstring

the mp odder number the refund should be applied to

notesany

Custom notes on the refund to send to the customer. If reason is set to 'OTHER', this field contains additional information regarding the refund.

statusenum

Status of the Refund in FeedAMP CREATED - The refund is ready to be processed PAUSED - The refund is not ready to be processed. If the market place reports any errors for a refund the refunds becomes paused. When the seller resolves the errors the state changes back to CREATED COMPLETE - The marketplace has indicated that the refund has been processed

Allowed values:

date_createddate

Date the refund was created. ISO 8601 DATE YYYY-MM-DD

merchant_refund_lineslist of objects

Collection of lines refunded by merchant

errorslist of objects

Collection of active errors for the refund

Errors

401

Unauthorized Error

404

Not Found Error