> ## Documentation Index
> Fetch the complete documentation index at: https://api.sosmednext.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel Order

> Membatalkan pesanan yang sedang berjalan dan mengembalikan saldo secara otomatis.

Gunakan endpoint ini untuk membatalkan satu atau beberapa pesanan yang masih dalam status `pending` atau `processing`. Saldo akan dikembalikan (refund) secara otomatis jika pembatalan berhasil diproses oleh provider.

> **Catatan:** Tidak semua layanan mendukung pembatalan. Pesanan dengan status `success` atau `canceled` tidak dapat dibatalkan.

## Body Parameters (JSON)

<ParamField body="orders" type="string" required>
  ID Order yang ingin dibatalkan, dipisahkan koma. Maksimal 100 ID per request. Contoh: `"9210,9211"`
</ParamField>

## Contoh Request

```bash theme={null}
curl -X POST \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orders": "9210,9211"}' \
  "https://app.sosmednext.com/api/v1/cancel"
```

## Response

```json Response Sukses (200 OK) theme={null}
[
  { "order": 9210, "cancel": 1 },
  { "order": 9211, "cancel": { "error": "Order already success" } }
]
```

### Penjelasan Response:

| Field                      | Keterangan                                     |
| :------------------------- | :--------------------------------------------- |
| `cancel: 1`                | Pembatalan berhasil, saldo telah dikembalikan. |
| `cancel: { error: "..." }` | Pembatalan gagal dengan pesan error.           |

### Kemungkinan Pesan Error:

* `Order not found` — ID order tidak ditemukan atau bukan milik Anda.
* `Order already success` — Pesanan sudah selesai, tidak bisa dibatalkan.
* `Order already canceled` — Pesanan sudah dibatalkan sebelumnya.
* `No provider data` — Pesanan belum dikirim ke provider.