Unhold order

POST /v1/unhold_order

Releases an order that was previously put on hold with Hold order.

Request

Send username, password and secretkey along with a data object. See Making requests.

Request bodycURL

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "secretkey": "YOUR_SECRET_KEY",
  "data": {
    "xid": "23542123",
    "order_id": "1001",
    "msg": "Error resolved, please unhold order"
  }
}

curl -X POST https://gatewaybeta.marcofinearts.com/v1/unhold_order \
  -H "Content-Type: application/json" \
  -d '{
    "username": "YOUR_USERNAME",
    "password": "YOUR_PASSWORD",
    "secretkey": "YOUR_SECRET_KEY",
    "data": {
      "xid": "23542123",
      "order_id": "1001",
      "msg": "Error resolved, please unhold order"
    }
  }'

data fields

Field	Required	Validation	Notes
xid	Conditional		Your order number. Required if order_id is not passed.
order_id	Conditional		Marco Fine Arts order ID. Required if xid is not passed.
msg	No		Reason for the request.

Response

SuccessError

{
  "res": "success"
}

{
  "res": "error",
  "code": "000",
  "message": "Error message."
}

Error codes

Code	Error	Description
404	Authentication failed	Your account is invalid or does not have API access. Check username, password and secretkey.
402	Missing field	One or more required fields are missing.
414	Missing field	order_id or xid is required.
415	Invalid data	Invalid order_id or xid.
419	Error	The order must be on hold to perform this action.