Event: subscription.paused

When it fires

A subscription has transitioned from Active (or Trial) into Paused. Recurring billing is suspended; the gateway will not attempt further charges while the subscription is paused.

This event is not fired when a subscription is cancelled — that’s covered by subscription.cancelled.

Headers

Same envelope as other events: Topiic-Event-Id, Topiic-Idempotency-Key, Topiic-Signature. See Verifying signatures.

Body

{
  "id": "9e4b1d27-…",
  "type": "subscription.paused",
  "createdAt": "2026-05-27T11:42:08.041Z",
  "merchantId": "e7d2f1a8-9c4b-4d62-8a3f-1b5c7e9d0f24",
  "data": {
    "subscriptionId": "3c4d5e6f-7a8b-9c0d-1e2f-3a4b5c6d7e8f",
    "memberId":       "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
    "planId":         "b6a8a5b8-7b3c-4d1e-9c2a-1f9e8d7c6b5a",
    "externalRef":    "cust_42",
    "status":         "Paused",
    "pausedAt":       "2026-05-27T11:42:08.000Z"
  }
}

data fields

Field	Type	Notes
subscriptionId	UUID	The Topiic Subscription id.
memberId	UUID	The Topiic Member id. Use this to find the customer on your side.
planId	UUID	The Plan the subscription is enrolled in. Unchanged by the pause.
externalRef	string | null	Your own id for the member (from the deep link’s ref), if one was recorded.
status	string	Always "Paused".
pausedAt	ISO-8601 UTC	When the pause took effect.

What to do on receipt

1. Verify the signature, dedupe on event.id.
2. Find the customer on your side via memberId.
3. Update their entitlement / access — e.g. flip a paused flag, suppress class booking, hide membership perks.
4. Return 2xx within 10 seconds.

Treat pauses as temporary — the same subscription may transition back to Active via subscription.resumed. Don’t tear down state you’ll need to put back.