Memberships

A Membership represents a membership belonging to one or more Customers.

Schema

Attributes

  • The ID of the membership

  • A string describing what kind of action needs to take place

    Possible values are no_mandate, setup_unpaid, mandate_revoked, payment_failed, payment_disputed, payment_outstanding and site_id

  • The basket ID which was used to purchase this membership, if applicable.

  • end_date
    Nullable

    The date which the membership ends

  • An external reference for this membership.

  • The unique membership number of the lead member. This is always a 10 digit numeric string. Since this field only relates to the lead member, this is now deprecated. Instead, find the membership for the relevant customer in the members array.

  • The date which the membership will next be billed

  • next_charge
    Nullable

    A summary of the next charge that's due for this membership.

    This property is only populated when the membership was retrieved using the `getCustomerMemberships endpoint.

  • Details about the payment method attached to this membership. This payment method is used to take payment on the monthly billing period. If a payment method hasn't been set up, this will be null.

  • The ID of the site this membership belongs to

  • Where the membership was created

    Possible values are self_signup, app, import and unknown

  • The date which the membership starts

  • Possible values are active, needs_dd_mandate, needs_attention, reserved, inactive, expired and upcoming

  • A URL to a page where the member can provide their payment details.

  • The datetime which the membership was created

""
listMemberships

List Memberships

This endpoint lists the Memberships which are associated to the provided site.

Query parameters

  • Filters memberships belonging to the specified customer

  • page
    Optional

    The page to retrieve results from

  • per_page
    Optional

    The number of results to return per page

Responses

  • 200

    The Memberships were successfully retrieved

GET/customers/memberships
200
example response
{
  "data": [
    {
      "id": "8927db5a-dbf9-d86a-96fb-536dd4b778f3",
      "attention_reason": "mandate_revoked",
      "basket_id": "69a83d0f2c7a75016400009e",
      "customer": {
        "id": "19fedcd8-40e2-d4d9-f535-933660853d79",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1968-02-16",
        "brand_id": "dd552b2f-f6a7-e6d3-335e-b2ccbf119ea8",
        "site_id": "3b8400ca-a477-9cb5-abb3-d68b1849e645",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "5c2e6c4c-13fb-7567-5624-ca86710a0cd9",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "9b70a9da-77e1-b0a9-7ab1-edffffcd15ba",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "ad13b560-9609-c7cf-ca16-ca2a54db15b1",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "a44ad8b2-d0ba-f712-9808-5682ba3ceedf",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "86564f35-dff7-1c01-ea7c-4beee1297584",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1912-05-02T13:30:34.0Z",
        "created_at": "1916-02-02T03:53:38.0Z",
        "updated_at": "1961-08-24T08:25:14.0Z",
        "deleted_at": "1893-03-28T14:01:45.0Z",
        "last_active_at": "1936-05-10T17:25:33.0Z",
        "email_verified_at": "1904-09-19T21:27:37.0Z",
        "last_check_in": {
          "checked_in_at": "1914-01-07T11:42:32.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "ca654192-d540-1d53-8d36-1ebdd864884d",
          "file_name": "super-cool-photo.jpg",
          "mime_type": "image/jpeg",
          "original_url": "https://example.com/media/super-cool-photo.jpg",
          "size": 84256,
          "url": "https://example.com/media/super-cool-photo-thumbnail@2x.jpg"
        },
        "external_ref": "consequat nisi"
      },
      "end_date": "1895-08-10T23:21:46.0Z",
      "external_ref": "ullamco sit",
      "members": [
        {
          "customer_id": "490693d1-c4c9-0048-845b-1f8dd95fc69f",
          "is_lead": false,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1930-09-04T02:51:54.0Z",
      "next_charge": {
        "id": "0b3eaf47-31a7-76b7-0841-3a868a369c6d",
        "amount": 3995,
        "currency": "GBP",
        "status": "failed",
        "billing_period_from": "1964-03-24",
        "billing_period_to": "1920-05-08"
      },
      "payment_method": {
        "id": "elit eu nisi",
        "type": "direct_debit",
        "last_4": "magna sit non ullamco",
        "card_brand": "amex"
      },
      "rate": {
        "id": "7bfbd574-b9b3-91ad-bebe-de33fc42cbc0",
        "membership_type_id": "f1f8f0a7-8d4a-372b-83e4-185985daba51",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "commodo ullamco consectetur dolor",
          "est sed Excepteur non deserunt"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1956-06-13T21:06:28.0Z",
        "updated_at": "1943-12-01T12:24:36.0Z"
      },
      "site_id": "cc6406e6-fcf3-4fa7-726d-fbf439b2ba9a",
      "source": "app",
      "start_date": "1915-12-25T11:47:33.0Z",
      "status": "needs_dd_mandate",
      "status_updated_at": "1965-08-13T13:38:11.0Z",
      "type": {
        "id": "73864095-c289-db0d-3742-212e8de47c85",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "tempor enim dolor",
        "brand_id": "5844d437-5c10-3367-4522-edfdfd3f199a",
        "offline_payments": true,
        "disable_confirmation_email": false,
        "private": true,
        "visibility": "private",
        "minimum_start_date": "1929-04-05T22:04:38.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "52c2c5b7-2aa0-00bb-1d6b-fab658dcb072",
            "membership_type_id": "83046e0d-69ad-848e-22a1-f5529cb1853b",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "in incididunt Duis",
              "consequat",
              "dolore mollit",
              "enim laborum dolor nostrud in"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1924-05-15T23:49:33.0Z",
            "updated_at": "1932-11-12T09:35:27.0Z"
          },
          {
            "id": "0ea30b5c-decf-7c7d-dd0e-bdc80e5c211c",
            "membership_type_id": "0886af4c-f61d-bdc1-4e0b-5a9c8dd0b112",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "id dolore dolore",
              "ex reprehenderit esse consectetur et",
              "id aliqua",
              "aliqua voluptate veniam ea",
              "est id Duis elit consectetur"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1895-03-05T23:29:18.0Z",
            "updated_at": "1913-02-26T09:40:50.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1954-03-08T11:40:20.0Z",
        "updated_at": "1897-04-18T10:34:22.0Z",
        "deleted_at": "1896-06-04T14:01:32.0Z"
      },
      "payment_details_url": "incididunt exercitation dolore non amet",
      "created_at": "1903-01-08T14:59:54.0Z"
    },
    {
      "id": "a8ab553a-9591-6bc2-ef29-45c0ac5eec03",
      "attention_reason": "no_mandate",
      "basket_id": "69a83d0f2c7a75016400009f",
      "customer": {
        "id": "2f3a8da5-7b12-067a-1bda-b1d87ffa2a27",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1965-12-26",
        "brand_id": "807a77d3-30b3-a570-fa5c-4ec5d3d9c113",
        "site_id": "e15219e1-3998-fb2c-3d31-1bbf195dd7f9",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "e876d09c-68b5-bb7e-0c83-51d43555a193",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "27e5bbf8-f68d-642f-0d20-7c91d34e044b",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "a9de5ee2-82e1-5087-1e22-195e84a6b205",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "7f9240ee-5940-4088-9687-fefd11d7ea64",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "f9663dce-f70f-c62f-b21a-a2a64b902f4b",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1896-03-31T06:07:07.0Z",
        "created_at": "1946-08-05T16:14:16.0Z",
        "updated_at": "1951-10-16T14:43:59.0Z",
        "deleted_at": "1890-10-04T14:12:58.0Z",
        "last_active_at": "1942-07-09T19:40:07.0Z",
        "email_verified_at": "1910-11-20T05:34:12.0Z",
        "last_check_in": {
          "checked_in_at": "1968-05-12T01:28:23.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "1611d351-b7e5-53fc-62a9-cdb776f0d88f",
          "file_name": "super-cool-photo.jpg",
          "mime_type": "image/jpeg",
          "original_url": "https://example.com/media/super-cool-photo.jpg",
          "size": 84256,
          "url": "https://example.com/media/super-cool-photo-thumbnail@2x.jpg"
        },
        "external_ref": "qui in"
      },
      "end_date": "1917-10-17T14:19:56.0Z",
      "external_ref": "ex dolor",
      "members": [
        {
          "customer_id": "8d89de2b-e2ca-356c-b8cf-a8e5163db993",
          "is_lead": true,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1938-09-29T15:16:38.0Z",
      "payment_method": {
        "id": "ipsum voluptate Lorem laboris minim",
        "type": "card",
        "last_4": "sint in exercitation",
        "status": "revoked",
        "card_brand": "amex"
      },
      "rate": {
        "id": "70a95f14-b383-1c31-723b-864c8961acde",
        "membership_type_id": "24133f53-e1a8-44e5-6128-4deba7124aff",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "aliqua ex sunt"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1947-11-16T13:18:09.0Z",
        "updated_at": "1936-02-25T19:01:09.0Z"
      },
      "site_id": "4d329c54-0bc2-4e06-c6d0-a7555534af36",
      "source": "app",
      "start_date": "1916-04-06T23:50:16.0Z",
      "status": "expired",
      "status_updated_at": "1929-11-07T22:02:20.0Z",
      "type": {
        "id": "3142e841-1618-76b8-0a28-54f71c84f4e3",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "quis id sit mollit",
        "brand_id": "1302a8fd-548d-3fef-bc6e-116702df2bc9",
        "offline_payments": false,
        "disable_confirmation_email": true,
        "private": true,
        "visibility": "private",
        "minimum_start_date": "1950-09-29T01:06:25.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "0b8bde81-61a7-f296-5ceb-1d0f453b3f5b",
            "membership_type_id": "d8b3fe3e-1674-eed6-8ffa-d02047ecdb24",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "et",
              "ad mollit",
              "ut eiusmod culpa",
              "velit officia ex consequat"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1963-05-02T13:37:34.0Z",
            "updated_at": "1960-02-28T10:23:15.0Z"
          },
          {
            "id": "92629bfa-810d-0963-90af-ef474ea9c300",
            "membership_type_id": "48f52bd8-8fed-cd8c-65a4-4dd0a1a5b531",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "id occaecat do ullamco",
              "dolor laboris fugiat",
              "Duis commodo"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1923-03-31T06:45:31.0Z",
            "updated_at": "1949-05-01T13:03:35.0Z"
          },
          {
            "id": "9b3fbe96-92df-d5e8-49eb-1103fd0f3627",
            "membership_type_id": "c3cf832d-da8e-0ae1-a31e-162fb48d0b16",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "est",
              "est et",
              "commodo non occaecat dolore",
              "ullamco"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1932-12-06T11:57:10.0Z",
            "updated_at": "1914-08-06T01:22:29.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1899-10-13T16:08:23.0Z",
        "updated_at": "1948-08-28T21:16:01.0Z",
        "deleted_at": "1941-10-22T03:54:45.0Z"
      },
      "payment_details_url": "dolor laborum dolore",
      "created_at": "1965-09-17T01:01:07.0Z"
    }
  ],
  "meta": {
    "from": 1,
    "to": 2,
    "total": 2,
    "current_page": 1,
    "last_page": 2,
    "per_page": 15,
    "path": "http://example.com/api"
  },
  "links": {
    "first": "http://example.com?page=1",
    "next": "https://example.com?page=3",
    "prev": "https://example.com?page=1",
    "last": "https://example.com?page=4"
  }
}
getMembership

Show a membership

Use this endpoint to retrieve a Membership by its ID.

Path parameters

Responses

  • 200

    The Membership was successfully retrieved

  • 404

    The resource couldn't be found

GET/customers/memberships/{membershipId}
200
example response
{
  "data": {
    "id": "3908589b-5f9f-a7b5-3690-9488f4b963ff",
    "attention_reason": "payment_failed",
    "basket_id": "69a83d0f2c7a7501640000a0",
    "customer": {
      "id": "306f9b95-53ce-6d73-11ae-f41554655b5f",
      "first_name": "Jane",
      "last_name": "Doe",
      "full_name": "Jane Doe",
      "phone": "+447900000000",
      "has_password": true,
      "dob": "1935-05-14",
      "brand_id": "113f4170-ac32-638e-dbac-6243ea58de2c",
      "site_id": "b00635b0-b219-4677-88ce-b8f3568e12c0",
      "stripe_id": "cus_1234567890",
      "express_stripe_id": "cus_1234567890",
      "email": "janedoe@example.com",
      "labels": [
        {
          "id": "0a6e648c-fed6-d1e4-c866-71edb954f05f",
          "value": "VIP",
          "colour": "ff6634"
        },
        {
          "id": "810b4073-e759-c0cb-7d5d-a8e640b7b0dd",
          "value": "VIP",
          "colour": "ff6634"
        },
        {
          "id": "41daaa13-fb1f-814a-57f3-bf61153309e1",
          "value": "VIP",
          "colour": "ff6634"
        }
      ],
      "preferred_locale": "en",
      "locked_at": "1942-09-10T02:24:47.0Z",
      "created_at": "1962-04-20T07:10:55.0Z",
      "updated_at": "1967-04-15T03:48:16.0Z",
      "deleted_at": "1969-09-14T04:31:34.0Z",
      "last_active_at": "1927-12-14T21:17:35.0Z",
      "email_verified_at": "1962-07-11T09:47:22.0Z",
      "last_check_in": {
        "checked_in_at": "1902-01-10T23:08:11.0Z",
        "method": "Scanned"
      },
      "avatar_id": "000000-000000-000000-000000",
      "avatar": {
        "id": "7d8b5dc6-1bc4-08e7-b8cf-7791af78aafe",
        "file_name": "super-cool-photo.jpg",
        "mime_type": "image/jpeg",
        "original_url": "https://example.com/media/super-cool-photo.jpg",
        "size": 84256,
        "url": "https://example.com/media/super-cool-photo-thumbnail@2x.jpg"
      },
      "external_ref": "ipsum Duis esse tempor incididunt"
    },
    "end_date": "1939-07-26T18:11:31.0Z",
    "external_ref": "sed dolore nulla sunt Duis",
    "members": [
      {
        "customer_id": "f07c234a-cf8b-a16f-1092-b5fe920de745",
        "is_lead": true,
        "membership_number": "1234567890"
      },
      {
        "customer_id": "49aacda0-525a-941e-06c3-28393cd911a4",
        "is_lead": true,
        "membership_number": "1234567890"
      },
      {
        "customer_id": "713c9d22-b737-6b7b-8ab4-400ce0692957",
        "is_lead": false,
        "membership_number": "1234567890"
      },
      {
        "customer_id": "22557ddb-2cee-ba08-0480-eb198ece523c",
        "is_lead": true,
        "membership_number": "1234567890"
      }
    ],
    "membership_number": "1234567890",
    "next_billing_date": "1919-08-15T03:48:31.0Z",
    "next_charge": {
      "id": "d1104c50-4cd4-8dae-a1a0-74c67e5f08b0",
      "amount": 3995,
      "currency": "GBP",
      "status": "awaiting_approval",
      "billing_period_from": "1907-01-07",
      "billing_period_to": "1936-11-21"
    },
    "payment_method": {
      "id": "Excepteur sunt nisi Ut culpa"
    },
    "rate": {
      "id": "177324f4-0698-c74e-3be9-9536f72e40bf",
      "membership_type_id": "f7d535da-7a81-22df-09e7-b6e270e5883f",
      "name": "Standard rate",
      "currency": "GBP",
      "price": 5000,
      "joining_fee": 1000,
      "billing_frequency": "P1M",
      "processors": [
        "aliqua cillum mollit eu",
        "veniam do ut tempor est"
      ],
      "default_duration": "P1Y",
      "private": true,
      "created_at": "1910-01-09T18:52:27.0Z",
      "updated_at": "1920-01-14T04:03:09.0Z"
    },
    "site_id": "243f4765-4aea-b17a-c78c-3eb9f405bdff",
    "source": "app",
    "start_date": "1923-03-11T16:43:10.0Z",
    "status": "upcoming",
    "status_updated_at": "1951-03-14T15:44:48.0Z",
    "type": {
      "id": "429ee4b8-4e05-b023-cf7d-2b7afa5ec081",
      "name": "Gold tier",
      "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
      "terms": "ad tempor ex",
      "brand_id": "d5894557-f418-92db-b6dc-7f60afd3fab7",
      "offline_payments": false,
      "disable_confirmation_email": true,
      "private": false,
      "visibility": "private",
      "minimum_start_date": "1966-02-05T04:25:56.0Z",
      "min_members": 2,
      "max_members": 4,
      "rates": [
        {
          "id": "4006477f-3295-0670-ff6b-7129c8df6c03",
          "membership_type_id": "d850bacf-207c-80e1-f522-ba8a67225e94",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [
            "commodo",
            "consequat fugiat proident commodo aute"
          ],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1964-10-27T08:32:46.0Z",
          "updated_at": "1952-08-13T06:35:34.0Z"
        },
        {
          "id": "ac850b90-46b4-6a49-1422-d58ee113c842",
          "membership_type_id": "602e3c37-53f7-462d-7580-e9ff28677857",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1935-02-27T12:16:47.0Z",
          "updated_at": "1901-10-12T02:52:26.0Z"
        },
        {
          "id": "419d88f8-3499-7036-93a2-9fcc31ffd625",
          "membership_type_id": "59a7553e-d09d-dcb2-8ebe-56ca827f8a7b",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [
            "amet occaecat commodo in",
            "id",
            "reprehenderit dolore eu",
            "et",
            "cillum eiusmod"
          ],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1931-07-19T13:04:52.0Z",
          "updated_at": "1897-09-18T19:23:52.0Z"
        },
        {
          "id": "1b7e6842-9dbb-11b9-d209-09240ee71af7",
          "membership_type_id": "336bd778-756f-b233-7d54-0a349cd11462",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [
            "ut"
          ],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1965-12-18T13:17:53.0Z",
          "updated_at": "1962-09-04T02:25:05.0Z"
        }
      ],
      "revenue_schedule": "FREQ=WEEKLY",
      "created_at": "1905-11-17T21:05:50.0Z",
      "updated_at": "1945-08-08T10:07:42.0Z",
      "deleted_at": "1936-09-03T13:13:47.0Z"
    },
    "payment_details_url": "nisi sunt",
    "created_at": "1923-06-22T12:27:18.0Z"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
actionAddMembershipChargePayment

Record a manual payment against a charge

This endpoint allows a manual (off-Trybe) payment to be recorded against a membership charge.

Path parameters

Request body

  • The ID of the custom payment type this payment should be recorded as

  • amount
    Nullable

    The amount of the payment

Responses

  • 200

    A charge against a membership.

  • 404

    The resource couldn't be found

POST/shop/membership-charges/{chargeId}/payment
200
example response
{
  "data": {
    "id": "c0f83b0b-9ac7-8896-1b76-649cf7feecf9",
    "membership": {
      "id": "28709999-7bc2-6222-8c85-e8d3e40ad05f",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "cf2fa3c7-d4d6-4b33-a647-ddf1206f0319",
      "customer_name": "Jane Jones"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones",
      "last_4": 4001
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "adipisicing ipsum do",
    "can_download_receipt": true,
    "amount_refunded": -4407000,
    "refunded": false,
    "refunds": [],
    "site_id": "7b853585-c7a4-c923-2200-5fb3589f8136",
    "billing_period_from": "1953-07-17",
    "billing_period_to": "1892-07-28",
    "processing_at": "1909-10-06T12:24:02.0Z",
    "created_at": "1921-05-15T21:47:20.0Z",
    "updated_at": "1948-05-28T09:32:26.0Z"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
actionProcessMembershipCharge

Manually process a charge for a membership

This endpoint allows a membership charge to be processed manually.

Path parameters

Responses

  • 200

    A charge against a membership.

  • 404

    The resource couldn't be found

POST/shop/membership-charges/{chargeId}/process
200
example response
{
  "data": {
    "id": "23be1098-6516-80f5-cb52-79f3204e9598",
    "membership": {
      "id": "6dc1043c-ab96-b06a-2800-da2aeffdb713",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "b40d1cba-a47c-1d51-e127-ee3aea621e3f"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones",
      "last_4": 4001,
      "processor_type": "Cash"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "mollit magna ut do exercitation",
    "can_download_receipt": false,
    "amount_refunded": -51361308,
    "refunded": true,
    "refunds": [],
    "site_id": "af65c8c3-cc42-1e6e-f85f-58b17260018b",
    "billing_period_from": "1959-12-28",
    "billing_period_to": "1966-12-03",
    "processing_at": "1967-11-13T23:12:55.0Z",
    "created_at": "1906-05-21T02:24:29.0Z",
    "updated_at": "1931-08-11T18:22:01.0Z"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
actionRetryMembershipCharge

Manually retry a charge for a membership

This endpoint allows a membership charge to be retried manually.

Path parameters

Responses

  • 200

    A charge against a membership.

  • 404

    The resource couldn't be found

POST/shop/membership-charges/{chargeId}/retry
200
example response
{
  "data": {
    "id": "2053f9cd-6cc1-b4dc-2fa8-84d1362586d6",
    "membership": {
      "id": "2a3d6618-1216-5673-fa00-5f6a4321024e",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "07e3cebb-187c-0b11-c108-5ccc3a89e370",
      "customer_name": "Jane Jones"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones",
      "last_4": 4001,
      "processor_type": "Cash",
      "processor_type_id": "69a83d0f2c7a7501640000a1"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "eu consequat ipsum nostrud enim",
    "can_download_receipt": true,
    "amount_refunded": 25107755,
    "refunded": true,
    "refunds": [
      {
        "id": "6f90955e-a875-d651-a6c9-f24f9c6496ac",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "900d566e-ab3e-c063-a2fa-58954a9c4794",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1957-03-05T02:49:07.0Z",
        "updated_at": "1953-08-17T16:15:44.0Z"
      },
      {
        "id": "55a0bcd6-59a6-0d47-511a-9c83263027ce",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "5603f968-2c16-51ff-b40e-f77923259b8b",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1925-10-15T21:10:15.0Z",
        "updated_at": "1909-10-05T20:21:01.0Z"
      }
    ],
    "site_id": "21834d08-c6dd-c786-993d-246b4df9cdd5",
    "billing_period_from": "1965-11-09",
    "billing_period_to": "1916-04-12",
    "processing_at": "1963-12-11T08:37:41.0Z",
    "created_at": "1893-07-16T12:04:45.0Z",
    "updated_at": "1892-11-30T13:22:26.0Z"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
createMembershipSms

Send an SMS message for a membership

This endpoint sends an SMS message to a membership's lead member. Currently supports sending billing details request messages.

Path parameters

Request body

  • message_type
    Required

    The type of message to send.

    Possible values are billing_details_request

  • If true, send the SMS even if the membership already has a payment method. Defaults to false.

Responses

  • 200

    The SMS message was successfully sent

  • 404

    The resource couldn't be found

  • 422

    The request didn't pass validation

POST/shop/memberships/{membershipId}/sms
200
example response
{
  "data": {
    "id": "69a83d0f2c7a750164000295",
    "organisation_id": "e4924256-20ff-6b46-e53f-384a81eb5b71",
    "site_id": "2f692933-43f7-8f9e-d8fe-5f71c0ac7bac",
    "customer_id": "e304be0d-805c-c76e-a6c7-e314a10d47f6",
    "membership_id": "33da341b-0acf-3ca4-7ddc-ae36b8872137",
    "from": "Trybe",
    "to": "+447123456789",
    "message": "dolore ullamco exercitation",
    "message_type": "billing_details_request",
    "message_delivered": true,
    "created_at": "2024-02-02T12:01:01.0Z",
    "sent_at": "2024-02-02T12:01:01.0Z"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
422
example response
{
  "errors": {
    "in1": [
      "aliqua qui in occaecat",
      "incididunt labore"
    ]
  },
  "message": "The request didn't pass validation"
}
createMembershipSmsPreview

Preview an SMS message for a membership

This endpoint previews an SMS message for a membership.

Path parameters

Request body

  • message_type
    Required

    The type of the SMS message.

    Possible values are billing_details_request

  • If true, preview the SMS even if the membership already has a payment method. Defaults to false.

Responses

  • 200

    The preview of the SMS message was successfully retrieved

  • 404

    The resource couldn't be found

POST/shop/memberships/{membershipId}/sms/preview
200
example response
{
  "data": {
    "message": "Your Premium Membership membership is almost ready! Please provide payment details for your membership payments. Set up here: https://example.com/confirm\n",
    "site_id": "800c8332-a72f-459b-46a5-70a2e4479d5c",
    "organisation_id": "0556ed26-009c-0e8d-949a-8c4043acd022"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}