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 |