v1

latestOpenAPI 3.1.0MIT2026-08-0659118508.8 KB

Subscription Payment

Create a one-off cycle on a subscription

Triggers an extra capture against an active subscription's saved payment method — useful for billing ad-hoc items like setup fees, add-ons, or upgrades without touching the recurring schedule. The regular cycles keep running unchanged.

Send capture_at to schedule the capture for later, or omit it to capture right away. The subscription must be active; a one-off cycle on an inactive subscription is rejected with a 409 Conflict.

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

post/subscription/{id}/cycle

Path parameters

idstring uuid required

UUID of the subscription to add the cycle to.

Request body

valuenumber double required

Must have at most two decimal places.

capture_atstring Y-m-d H:i

When to schedule the charge, in UTC. Must not be in the past. Omit to capture immediately.

descriptionstring

Free-form text shown on the bank statement or in the MB WAY app.

keystring

Your internal identifier for this charge. Useful for reconciliation on your side.

Example request

{
  "value": 10.5,
  "capture_at": "2037-12-12 09:00",
  "description": "extra subscription charge",
  "key": "one-time-charge-key"
}

Response

Created

statusstring required

messagestring[] required

idstring uuid required

The UUID of the newly created cycle.

Example response

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