riverty logo

Docs

Start a Subscription

You can start a subscription once a Subscription Product and Consumer have been created. Starting a subscription will trigger the Consumer Risk Check and kickstart the subscription lifecycle.

Using the 'billingDayOffset' parameter you can control when the customer receives their subscription invoices from Riverty. The billing day offset will delay the invoice date with the integer that you enter on top of the active from date.

Below a request example:

PUT v1/clients/{{ClientID}}/subscriptions/{{SubscriptionID}}

  • ClientID = Your assigned Riverty client-id
  • SubscriptionID = Your internal subscription identifier to this subscription

Example Request

    
        {
 "customerNumber": "customer-number-1",
 "subscriptionProductId": "subscription-product-id-1",
 "billingDayOffset": 2,
 "metadata": [
  {
   "key": "order-id",
   "value": "a9ee9996-e941-4aa8-90b9-4b047c4afe87"
  }
 ],
 "activeFrom": "2022-09-28"
}

Example Response

    
        {
 "customerNumber": "customer-number-1",
 "subscriptionProductId": "subscription-product-id-1",
 "metadata": [
  {
   "key": "order-id",
   "value": "a9ee9996-e941-4aa8-90b9-4b047c4afe87"
  }
 ],
 "active": {
  "from": "2022-09-28",
  "until": "9999-12-31"
 },
 "closeDetails": {
  "canceledByClient": false,
  "canceledByBillingPartner": false,
  "terminatedByClient": false
 },
 "billingDetails": {
  "nextBillingDate": "2022-09-30",
  "billingDayOffset": 2
 },
 "currentPeriod": {
  "start": "2022-09-28",
  "end": "2022-10-27"
 },
 "id": "subscription-id-1",
 "status": "ACTIVE",
 "createdAt": "2022-01-28T13:04:40.020Z",
 "updatedAt": "2022-02-28T13:04:40.020Z",
 "_links": [
  {
   "method": "GET",
   "href": "https://api.riverty.io/subscription/v1/clients/1234/subscriptions/subscription-id-1",
   "rel": "self",
   "target": "API"
  },
  {
   "method": "GET",
   "href": "https://api.riverty.io/subscription/v1/clients/1234/subscription-products/subscription-product-id-1",
   "rel": "subscription-product",
   "target": "API"
  },
  {
   "method": "PUT",
   "href": "https://api.riverty.io/subscription/v1/clients/1234/subscriptions/subscription-id-1/cancellation",
   "rel": "cancellation",
   "target": "API"
  },
  {
   "method": "PUT",
   "href": "https://api.riverty.io/subscription/v1/clients/1234/subscriptions/subscription-id-1/termination",
   "rel": "subscription-terminate",
   "target": "API"
  },
  {
   "method": "GET",
   "href": "https://api.riverty.io/subscription/v1/clients/1234/subscriptions/subscription-id-1/timeline",
   "rel": "subscription-timeline",
   "target": "API"
  },
  {
   "method": "GET",
   "href": "https://consumer.riverty.io/s/apgD/SGVsbG9MaXR0bGVIYWNrZXI",
   "rel": "manage-payments",
   "target": "BROWSER"
  }
 ]
}