Inicio
Documentação
Recursos
Parcerias
Comunidade

Parcerias

Conheça nosso programa para agências ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratá-los.

Comunidade

Fique por dentro das últimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Cancelar pedido - Pedidos de entrega - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Cancelar pedido

PUT

https://api.mercadopago.com/proximity-integration/shipments/{shipment_id}/cancel
Este endpoint cancela um pedido, alterando seu status. Pode ser adicionado um motivo para o cancelamento, bastando apenas verificar se o motivo do cancelamento está disponível para o status atual.
Parâmetros de requisição
PATH
shipment_id
string

OBRIGATÓRIO

Shipment ID do pedido.
BODY
status
string
Este campo indica o status do pedido, que deve ter o valor "cancelled" para este endpoint.
cancellation_reason
object
Motivo do cancelamento que foi recuperado do endpoint de motivos de cancelamento.
Parâmetros de resposta
status
string
Status of the order after its cancellation. The Status value that will be returned is "cancelled".
Erros

400Erro

400

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

401Erro

401

Unauthorized - Access Token is invalid

403Erro

403

Forbidden - User cannot access this resource

424Erro

424

Not Found - Failed to get some information of the order

500Erro

500

Internal server error

Requisição
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."
  }
}'
Resposta de exemplo
{
  "status": "cancelled"
}