v1

latestOpenAPI 3.1.0MIT2026-08-0659118508.8 KB

Subscription Payment

Update a cycle on a subscription

Overrides the charge amount for a single cycle without touching the subscription's recurring schedule or default value. Only RENEWABLE cycles in PENDING status can be patched — anything else (one-off charges, already-processed cycles, deleted cycles) returns 409 Conflict.

Required scope: <code style="background:#e8f0fe;color:#1a73e8;padding:2px 8px;border-radius:12px;font-size:0.85em">subscription:update</code>

patch/subscription/{id}/cycle/{cycle_id}

Path parameters

idstring uuid required

UUID of the subscription the cycle belongs to.

cycle_idstring uuid required

UUID of the cycle to update.

Request body

valuenumber double required

New amount for the cycle, in euros. Must have at most two decimal places.

Example request

{
  "value": 99.99
}

Response

statusstring required

messagestring[] required

idstring uuid required

The UUID of the updated cycle (same as the cycle_id path parameter).

Example response

{
  "status": "ok",
  "message": [
    "Your request was successfully updated"
  ],
  "id": "550e8400-e29b-41d4-a716-446655440000"
}