---
title: "Update order status"
method: PUT
path: "/api/order/{pedido}"
tags: ["Pedidos"]
---

# Update order status

`PUT /api/order/{pedido}`

Atualiza o status de um pedido que esteja em "A pagar" (1) para "Pago" (6) ou "Cancelado" (8). Pedidos em qualquer outro status são rejeitados e permanecem inalterados. O pedido precisa pertencer ao mercado da chave de API autenticada.

## Path parameters

- `pedido` integer, required

## Request body

- object
  - `status` 6 | 8, required — Novo status do pedido. Aceita apenas <code>6</code> (Pago) ou <code>8</code> (Cancelado).
  - `forma_pagamento_id` integer — Forma de pagamento do pedido. Obrigatório quando <code>status</code> for <code>6</code> (Pago). Deve existir em <code>forma_pagamento</code>.

## Response `200`

Pedido atualizado com sucesso.

- object
  - `data` object

## Other responses

- `401` — Unauthorized
- `404` — Pedido inexistente ou pertencente a outro mercado.
- `422` — Pedido em status diferente de "A pagar".

---

[API](https://skmtc.dev/beepayapp/apis/beepay.md) · [All operations](https://skmtc.dev/beepayapp/apis/beepay/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/beepayapp/beepay/revisions/787a925e98a0/schema)