# Release a held payment.

> A payment created with `hold` keeps its sellers' money until you release it: in `lite`, on the seller's balance, out of their payouts; in `relay`, as an unpaid due. Release it once the buyer has the goods: the seller is paid on their next payout (or with `POST /accounts/{id}/payouts`). A sale you never release is released on its own at `release_at` (the account's `hold_max_days` after the payment succeeded), and you receive `payment.hold_expiring` three days before.

`POST https://api.wajub.com/payments/{id}/release`

A payment created with `hold` keeps its sellers' money until you release it: in `lite`, on the seller's balance, out of their payouts; in `relay`, as an unpaid due. Release it once the buyer has the goods: the seller is paid on their next payout (or with `POST /accounts/{id}/payouts`). A sale you never release is released on its own at `release_at` (the account's `hold_max_days` after the payment succeeded), and you receive `payment.hold_expiring` three days before.

Without a body, every held part of the payment is released. With `shares`, only the parts of the accounts named: each part is released whole, never a share of it. A payment released before it succeeds is simply never held. Idempotent: releasing what is already released answers the payment's holds as they are, and sends no second `payment.released`.

Called with your own secret key, never with `X-Sync`. A restricted key is refused, whatever it may do on payments, as on `/sync/*` and on freezing, unfreezing and the embedded sessions of an account; the other `/accounts/*` calls take a restricted key with `account.read` or `account.write`.

## Path parameters

- `id` (string, required): The payment's `id`.

## Body (application/json)

- `shares` (array of object): Only these parts of a shared payment, 1 to 50. Leave it out to release every held part: `null` or `[]` is refused (`422`).
  - `shares[].account` (string): The account whose part is released.

## Responses

- `200`: OK
- `403`: Forbidden
- `404`: Not a payment of yours or of your accounts
- `409`: Nothing held
- `422`: Unprocessable Content

## Example response (200)

```json
{
  "code": 200,
  "status": "OK",
  "message": "Payment released",
  "payment": {
    "id": "trx_Lw2Ka8Qd1Fz6Tn4Bc7Xm",
    "object": "payment",
    "holds": [
      {
        "account": "acc_Gt6yU3nE8rM1kS5vX9bQ",
        "account_type": "lite",
        "status": "released",
        "max_days": 30,
        "currency": "XAF",
        "amount": 9300,
        "held": 0,
        "given_back": 0,
        "held_at": "2026-11-20T09:12:04+00:00",
        "release_at": "2026-12-20T09:12:04+00:00",
        "released_at": "2026-11-23T15:40:11+00:00",
        "release_reason": "platform"
      }
    ]
  }
}
```
