Changes the purchase's payment status. The payment status only marks whether the purchase has been paid to the supplier: it does not affect stock, amounts or the purchase status.

```
v1/purchases/update_payment.php
```

## Parameters

| Field | Type | Required | Description |
|---|---|---|---|
| purchase_id | int | Yes | Purchase ID |
| status | int | Yes | Payment status: **0** — Unpaid, **1** — Partially paid, **2** — Paid |

The payment status is shown in the purchases list if **Show purchase payment status** is on under **Settings → General**. Via the API it is changed and returned regardless of that setting.

## Example request

```
{
    "purchase_id": 29645,
    "status": 2
}
```

## Example response

```
{
    "success": true
}
```

## Errors

| Error | Reason |
|---|---|
| No purchase_id in input | A required field is missing (instead of purchase_id, the field's name) |
| Invalid payment status value. Must be one of: 0, 1, 2 | Invalid payment status |
| Purchase not found or access denied | Purchase not found or deleted |