Subscription Webhook

Payload shape for subscription webhooks.

Content

KeyTypeDescription
idintNumeric identifier
uuidstring
  • Textual identifier
  • 8 - 40 characters long
statusstringThe status of the subscription
startstringThe start date in the format 1970-01-01
endstring|nullThe end date in the format 1970-01-01 or null
valid_untilstring|nullThe next pay date in the format 1970-01-01 or null
paymentIntervalstringAn interval specification like the duration parameter of DateInterval
invoiceInvoiceInvoice
contactContactContact

Status Values

StatusDescription
activeThe subscription is active. Further charges are to come.
failedThe creation of the subscription failed, or a charge failed (status was overdue), and the retry failed as well.
cancelledThe subscription has been cancelled by the merchant, effective immediately. No more charges follow.
in_noticeThe subscription has been cancelled by the shopper before the end date. The remaining charges will follow.
overdueA charge failed. The subscription is tried to be charged again. After a second failure, the status changes to failed.

Example

{
  "id": 1234,
  "uuid": "aabb1122",
  "status": "active",
  "start": "2026-01-01",
  "end": null,
  "valid_until": "2026-12-31",
  "paymentInterval": "P1M",
  "invoice": {
    "number": "Test",
    "products": [
      {
        "name": "Test",
        "description": "",
        "price": 5000,
        "quantity": 1,
        "sku": null,
        "vatRate": "8.10"
      }
    ],
    "discount": {
      "code": null,
      "amount": 0,
      "percentage": null
    },
    "shippingAmount": null,
    "currency": "CHF",
    "test": 1,
    "referenceId": "",
    "purpose": "",
    "paymentRequestId": null,
    "paymentLink": null,
    "googleAnalyticProducts": [
      {
        "item_id": 1324,
        "item_name": "Test",
        "price": 50,
        "quantity": 1
      }
    ],
    "originalAmount": 5000,
    "refundedAmount": 0,
    "custom_fields": [
      {
        "type": "email",
        "name": "Email",
        "value": "subscription@test.com"
      }
    ]
  },
  "contact": {
    "id": 1234,
    "uuid": "aabb1122",
    "title": "female",
    "firstname": "zahls.ch",
    "lastname": "Test",
    "company": "Company Name",
    "street": "Burgstrasse 20",
    "zip": "3600",
    "place": "Thun",
    "country": "",
    "countryISO": "",
    "phone": "0335500010",
    "email": "subscription@test.com",
    "date_of_birth": "01.01.1970",
    "delivery_title": "",
    "delivery_firstname": "",
    "delivery_lastname": "",
    "delivery_company": "",
    "delivery_street": "",
    "delivery_zip": "",
    "delivery_place": "",
    "delivery_country": "",
    "delivery_countryISO": ""
  }
}