Authorize a return

PUT

https://api.feedamp.feedonomics.com/api/v1/returns/:return-id/authorize

PUT

/api/v1/returns/:return-id/authorize

curl -X PUT https://api.feedamp.feedonomics.com/api/v1/returns/return-id/authorize \
     -H "client: 1" \
     -H "token: <apiKey>"

{
  "return": {
    "id": "123",
    "state": "Pending Authorization",
    "integration_name": "amazon",
    "paused": 0,
    "return_info": {
      "mp_return_number": "152-123344ABC",
      "mp_order_number": "111-99998888-55555",
      "pre_authorized": 1,
      "request_date": "2018-02-07T22:00:00.000Z",
      "return_lines": [
        {
          "mp_return_line_number": "123-456-789",
          "mp_order_line_number": "afdafasdgasdg",
          "quantity": 2,
          "reason": "wrong_item_received",
          "shipping_expected": 1,
          "sku": "1234-12353",
          "product_name": "Beats Pill Speakers",
          "requested_refund_principal": 1.05,
          "requested_refund_tax": 0.11,
          "requested_refund_shipping": 0,
          "requested_refund_shipping_tax": 0,
          "carrier": "FedEx",
          "tracking_number": "168739720393",
          "destination": "123 Example St. Los Angeles, CA"
        }
      ],
      "respond_by_date": "2018-02-09T22:00:00.000Z",
      "notes": "Didn't fit me!",
      "merchant_return_number": "RMA-1234"
    },
    "order_id": "456"
  }
}

Authorize (or reject) a customer-initiated return. This only applies to returns in the Pending Authorization state. This is also an opportunity for the seller to supply their own return number (i.e RMA) or shipping label.

Authentication

tokenstring

The Authentication token obtained from the get_token route.

x-api-keystring

The SSO token obtained from the Feedonomics platform SSO token route.

Path parameters

return-idstringRequired

FeedAMP return id

Response

Single Return resource

returnobjectOptional

Errors

400

Bad Request Error

404

Not Found Error

Authentication

Path parameters

Headers

Response

Errors