Home
Documentation
Resources
Partners
Community

Resources

Check for updates on our solutions and system performance, or request technical support.

Partners

Discover our program for agencies or developers that offer integration services and sellers who want to hire them.

Community

Get the latest news, ask others for help and share your knowledge.

Cancel order - Shipping orders - Mercado Pago Developers

Intelligent search powered by OpenAI 

Cancel order

PUT

https://api.mercadopago.com/proximity-integration/shipments/{shipment_id}/cancel
This endpoint cancels an order, changing its status. A reason for the cancellation can be added, it's necessary just to check if the reason of cancellation are available for the current status.
Request's parameters
PATH
shipment_id
string

REQUIRED

Shipment ID of the order.
BODY
status
string
This field indicates the order status, which must have the value "cancelled" for this endpoint.
cancellation_reason
object
Reason of the cancellation that was retrieved from the endpoint of cancellation reason.
Response parameters
status
string
Status of the order after its cancellation. The Status value that will be returned is "cancelled".
Errors

400Error

400

Conflict-error - This order cannot be cancelled due to its current status.

401Error

401

Unauthorized - Access Token is invalid

403Error

403

Forbidden - User cannot access this resource

424Error

424

Not Found - Failed to get some information of the order

500Error

500

Internal server error

Request
curl -X PUT \
    'https://api.mercadopago.com/proximity-integration/shipments/{shipment_id}/cancel'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-4599*********755-11221*********d497ae962*********ecf8d85-1*********' \
    -d '{
  "status": "cancelled",
  "cancellation_reason": {
    "id": "CS7452",
    "value": "out_of_stock",
    "message": "Me falta alguno de los productos."
  }
}'
Sample answer
{
  "status": "cancelled"
}