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": "08b1193f-344b-f2b0-73fe-d75b77e43222",
      "attention_reason": "site_id",
      "basket_id": "69e3f3f48a8cc9014600008a",
      "customer": {
        "id": "072042ac-ac62-dbe8-39dd-cae32b2eb852",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1952-08-17",
        "brand_id": "831d16d4-8cbc-0047-b521-a755764e767a",
        "site_id": "ca9c2f52-37c0-d556-d969-3c43697f5f71",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "b353c8e8-69f8-8fa2-409e-5b9f2581a2c6",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1892-03-27T04:44:12.0Z",
        "created_at": "1963-05-10T05:03:53.0Z",
        "updated_at": "1902-09-02T01:39:56.0Z",
        "deleted_at": "1893-10-26T07:56:24.0Z",
        "last_active_at": "1892-08-14T06:43:01.0Z",
        "email_verified_at": "1900-01-20T02:45:30.0Z",
        "last_check_in": {
          "checked_in_at": "1944-09-05T12:10:56.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "0b45f500-557d-9065-7667-e098a54d9dab",
          "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": "do id minim ullamco"
      },
      "end_date": "1969-11-24T11:32:34.0Z",
      "external_ref": "sit irure eiusmod",
      "members": [
        {
          "customer_id": "798518d8-a9ac-40fa-7333-a2d66ed7f607",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "488df9d1-6d4f-c2c8-a1cc-5a4e1795f66e",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "1918cdcd-f4f6-aae1-b37c-e889d8888aab",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "18531aa6-50f7-2204-a445-d154201e7218",
          "is_lead": false,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1893-03-11T22:56:38.0Z",
      "next_charge": {
        "id": "d877bd29-77d8-654f-9f92-14555fa90d23",
        "amount": 3995,
        "currency": "GBP",
        "status": "processing",
        "billing_period_from": "1934-01-11",
        "billing_period_to": "1946-10-07"
      },
      "payment_method": {
        "id": "dolore consectetur culpa aliqua fugiat",
        "last_4": "consectetur",
        "status": "revoked"
      },
      "rate": {
        "id": "cf3bf4f5-7487-446d-bf65-f6a575ccdd3d",
        "membership_type_id": "9fc409a5-4f55-742e-3c1e-0362ac36f461",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "nulla cillum",
          "Duis aliqua incididunt adipisicing"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1910-03-30T12:06:28.0Z",
        "updated_at": "1953-03-15T01:52:13.0Z"
      },
      "site_id": "85bc0646-837e-e9ab-8e9c-db54fdb4880d",
      "source": "self_signup",
      "start_date": "1942-06-03T21:10:45.0Z",
      "status": "needs_dd_mandate",
      "status_updated_at": "1903-06-07T11:49:09.0Z",
      "type": {
        "id": "93acf246-5313-d468-c6ae-9269cfe84462",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "ipsum ut nostrud adipisicing",
        "brand_id": "7d970e21-f9c0-8d55-4eec-086535a3f3dc",
        "offline_payments": false,
        "disable_confirmation_email": true,
        "private": false,
        "visibility": "private",
        "minimum_start_date": "1954-12-02T12:41:49.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "f7ec3eee-f8fc-9f0e-c2d5-5f579608a8cc",
            "membership_type_id": "d63f6b54-310c-1e77-47fd-78c68a93d2b4",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "sit proident ut",
              "labore",
              "aute occaecat",
              "sed voluptate ipsum",
              "tempor laborum adipisicing"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1899-01-19T02:40:51.0Z",
            "updated_at": "1920-02-02T10:01:22.0Z"
          },
          {
            "id": "810d208f-6bed-efb5-d8d5-9fe762c3e8dc",
            "membership_type_id": "11df5b2f-e595-29a1-76c3-27e18ceefffb",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "ea",
              "laboris id cillum"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1900-11-21T13:09:44.0Z",
            "updated_at": "1947-06-20T09:42:07.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1969-08-07T02:04:35.0Z",
        "updated_at": "1946-03-12T18:20:50.0Z",
        "deleted_at": "1897-08-20T14:41:38.0Z"
      },
      "payment_details_url": "ullamco nostrud eiusmod",
      "created_at": "1957-09-02T10:56:59.0Z"
    },
    {
      "id": "1f459638-f266-538b-5c56-2a1cc8bafa59",
      "attention_reason": "payment_disputed",
      "basket_id": "69e3f3f48a8cc9014600008b",
      "customer": {
        "id": "a179f613-1136-5205-2411-b7864cdca426",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1955-09-20",
        "brand_id": "d955ea89-1c93-8ffd-f887-34a80544780a",
        "site_id": "f9da8d70-1e83-73df-711b-f6f14365b92e",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "5248fa9d-96dc-7728-3274-d2d4d1939fd3",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1895-11-10T15:14:07.0Z",
        "created_at": "1944-04-10T03:51:49.0Z",
        "updated_at": "1924-03-05T16:45:59.0Z",
        "deleted_at": "1948-12-06T09:59:28.0Z",
        "last_active_at": "1914-01-10T06:33:31.0Z",
        "email_verified_at": "1954-11-23T06:22:48.0Z",
        "last_check_in": {
          "checked_in_at": "1901-09-27T06:03:57.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "bd3b26da-2c92-0fa5-9cd6-3a20949eb1dc",
          "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": "occaecat"
      },
      "end_date": "1892-11-19T21:06:49.0Z",
      "external_ref": "aute",
      "members": [],
      "membership_number": "1234567890",
      "next_billing_date": "1961-12-09T21:22:26.0Z",
      "next_charge": {
        "id": "1bfa8a4f-b757-ec5a-9d56-6e6207c4986d",
        "amount": 3995,
        "currency": "GBP",
        "status": "failed",
        "billing_period_from": "1966-01-22",
        "billing_period_to": "1896-04-20"
      },
      "payment_method": {
        "id": "commodo laboris non",
        "type": "card",
        "last_4": "irure nostrud",
        "status": "revoked",
        "card_brand": "amex"
      },
      "rate": {
        "id": "e51a5ebc-3656-87fb-f35a-ee377bd98b1f",
        "membership_type_id": "486b06b6-9b3b-2d26-5d91-aee60888eace",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "in tempor elit"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1967-02-28T18:27:25.0Z",
        "updated_at": "1955-12-02T13:56:27.0Z"
      },
      "site_id": "dc8cdb93-cf95-79cf-daf3-82805fd2f303",
      "source": "unknown",
      "start_date": "1928-10-27T17:38:59.0Z",
      "status": "inactive",
      "status_updated_at": "1967-08-23T03:50:39.0Z",
      "type": {
        "id": "63fbcec9-6173-7fa2-6eec-d03e8d17eadc",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "sint magna fugiat dolore",
        "brand_id": "f7b1c706-0f9c-9e34-e62f-e8e2dfead08c",
        "offline_payments": true,
        "disable_confirmation_email": true,
        "private": true,
        "visibility": "private",
        "minimum_start_date": "1952-08-20T16:59:45.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "163170e9-9291-152d-d2e5-c6e032d3a0f6",
            "membership_type_id": "0d3f8716-3064-dc20-bab4-f3a7de147af8",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "eu consequat qui commodo Lorem",
              "qui adipisicing tempor",
              "adipisicing qui commodo",
              "ut quis ipsum eiusmod",
              "esse minim"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1968-06-23T07:26:38.0Z",
            "updated_at": "1897-06-27T23:57:08.0Z"
          },
          {
            "id": "afabaca8-1df1-118c-5f20-2cb0423731c6",
            "membership_type_id": "e7df1a7c-0edf-147e-6286-785c4a531a73",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "consequat aliqua fugiat amet",
              "ea nostrud magna enim dolor",
              "Lorem sit in aliquip"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1907-11-18T05:58:42.0Z",
            "updated_at": "1909-08-01T17:07:31.0Z"
          },
          {
            "id": "07945f45-a3ee-29c1-e2da-af16d77cff51",
            "membership_type_id": "ef9e407e-eef7-5b62-2182-b16dee827a53",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "sint labore minim proident quis"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1950-10-07T05:18:43.0Z",
            "updated_at": "1949-01-24T03:15:46.0Z"
          },
          {
            "id": "c6791bd8-5c0a-f4fa-5863-96104b79af06",
            "membership_type_id": "b3982700-a0ef-a623-c726-aed6c68c4c6a",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "sed cillum laborum sunt"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1958-12-22T13:42:33.0Z",
            "updated_at": "1940-08-24T02:30:52.0Z"
          },
          {
            "id": "adece74c-cda3-f24b-f9c5-62854eeba3a4",
            "membership_type_id": "c4e44057-1c47-4ef4-7d27-0218c9567151",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "elit sunt",
              "eiusmod Excepteur fugiat",
              "mollit cupidatat elit Duis",
              "velit est occaecat",
              "Lorem occaecat labore"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1947-11-20T14:30:22.0Z",
            "updated_at": "1894-11-24T08:38:56.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1898-10-15T16:40:53.0Z",
        "updated_at": "1918-12-02T19:24:46.0Z",
        "deleted_at": "1953-05-06T23:21:31.0Z"
      },
      "payment_details_url": "ad ut",
      "created_at": "1952-12-13T04:34:25.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": "4c02b4a0-80c3-4547-fc94-6e8310ef6809",
    "attention_reason": "payment_outstanding",
    "basket_id": "69e3f3f48a8cc9014600008c",
    "customer": {
      "id": "d90a1cc9-797d-b546-8bc3-baa19863f602",
      "first_name": "Jane",
      "last_name": "Doe",
      "full_name": "Jane Doe",
      "phone": "+447900000000",
      "has_password": true,
      "dob": "1899-11-04",
      "brand_id": "6fd7615b-3011-5ca9-2e28-ece63513cb7f",
      "site_id": "8e87cbc7-b79c-6e49-0483-97e59c635645",
      "stripe_id": "cus_1234567890",
      "express_stripe_id": "cus_1234567890",
      "email": "janedoe@example.com",
      "labels": [
        {
          "id": "1a8eda09-ce30-f4fc-1ad4-7148d4c8fc1f",
          "value": "VIP",
          "colour": "ff6634"
        },
        {
          "id": "2ee33c7d-75cf-c691-1d5f-e5d27bbb04f3",
          "value": "VIP",
          "colour": "ff6634"
        },
        {
          "id": "e29cd817-ce11-c24f-c94a-cda633243aa4",
          "value": "VIP",
          "colour": "ff6634"
        },
        {
          "id": "4e9130d2-ff5e-2c93-d5b9-67cd38de509c",
          "value": "VIP",
          "colour": "ff6634"
        }
      ],
      "preferred_locale": "en",
      "locked_at": "1945-04-22T09:30:36.0Z",
      "created_at": "1922-12-11T13:41:40.0Z",
      "updated_at": "1901-07-13T21:01:35.0Z",
      "deleted_at": "1938-04-24T14:20:13.0Z",
      "last_active_at": "1938-02-27T19:06:17.0Z",
      "email_verified_at": "1924-11-18T12:03:23.0Z",
      "last_check_in": {
        "checked_in_at": "1928-05-31T10:47:37.0Z",
        "method": "Scanned"
      },
      "avatar_id": "000000-000000-000000-000000",
      "avatar": {
        "id": "bba3ae78-4601-57dc-ca1b-123c7a7345e9",
        "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": "non magna ipsum quis esse"
    },
    "end_date": "1919-09-11T12:35:53.0Z",
    "external_ref": "do",
    "members": [
      {
        "customer_id": "b4138e8d-9b80-f038-f2d5-17473099aa41",
        "is_lead": false,
        "membership_number": "1234567890"
      },
      {
        "customer_id": "59cf3a81-664c-cc2d-d511-f5ae5d6a01e1",
        "is_lead": true,
        "membership_number": "1234567890"
      }
    ],
    "membership_number": "1234567890",
    "next_billing_date": "1909-12-07T17:08:46.0Z",
    "next_charge": {
      "id": "fd33d1fc-1ff9-7219-fc57-b96cafa6cb05",
      "amount": 3995,
      "currency": "GBP",
      "status": "failed",
      "billing_period_from": "1892-07-31",
      "billing_period_to": "1910-01-30"
    },
    "payment_method": {
      "last_4": "eiusmod",
      "status": "revoked",
      "card_brand": "amex"
    },
    "rate": {
      "id": "46a2bd0d-d520-0981-962c-1019a8c377ce",
      "membership_type_id": "aac436fd-785c-31e2-0046-f6aaa8a9f7d2",
      "name": "Standard rate",
      "currency": "GBP",
      "price": 5000,
      "joining_fee": 1000,
      "billing_frequency": "P1M",
      "processors": [
        "dolor quis nostrud laboris",
        "tempor",
        "labore cillum sint",
        "ut quis"
      ],
      "default_duration": "P1Y",
      "private": true,
      "created_at": "1894-01-29T08:28:39.0Z",
      "updated_at": "1924-11-18T02:49:32.0Z"
    },
    "site_id": "049a7a03-af2e-740f-668a-d49a8dd25517",
    "source": "app",
    "start_date": "1963-08-23T13:23:28.0Z",
    "status": "upcoming",
    "status_updated_at": "1911-04-04T17:51:42.0Z",
    "type": {
      "id": "34d59e42-7a2f-1652-f310-d2d4d0752bf4",
      "name": "Gold tier",
      "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
      "terms": "dolor non cupidatat est",
      "brand_id": "98170ba5-2f3f-f35d-9113-42f459aa4dbf",
      "offline_payments": true,
      "disable_confirmation_email": true,
      "private": true,
      "visibility": "public",
      "minimum_start_date": "1890-02-15T14:33:06.0Z",
      "min_members": 2,
      "max_members": 4,
      "rates": [
        {
          "id": "987670b7-4c24-c9e6-9130-6c038101cef9",
          "membership_type_id": "cf4d4ba1-e485-d003-e49d-860269d046b7",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [
            "aliqua nulla voluptate"
          ],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1919-02-22T12:21:47.0Z",
          "updated_at": "1923-08-13T05:06:40.0Z"
        },
        {
          "id": "a8123d45-1c33-6a62-1c1a-b887a8e2fa0f",
          "membership_type_id": "488b5ac6-3821-4b0f-35cf-0e45537ae2df",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [
            "sed fugiat ex minim adipisicing",
            "reprehenderit cupidatat",
            "sunt esse ad"
          ],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1931-12-15T12:35:06.0Z",
          "updated_at": "1893-12-24T14:06:08.0Z"
        },
        {
          "id": "016c455e-5242-cedc-3fd1-b15fc58ff416",
          "membership_type_id": "32f66bf9-5509-0774-8fd3-f52a5f158f6d",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1921-12-03T19:53:29.0Z",
          "updated_at": "1928-09-02T10:57:48.0Z"
        },
        {
          "id": "acd1cf10-d248-1daf-ebe7-a7e7d5406369",
          "membership_type_id": "580f43f1-530a-d901-85b3-16c92314e25a",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [
            "aliqua pariatur commodo ullamco",
            "officia esse dolor Ut"
          ],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1944-08-21T12:01:45.0Z",
          "updated_at": "1942-04-09T10:52:55.0Z"
        },
        {
          "id": "082cb8cf-742d-9947-0629-090649b171aa",
          "membership_type_id": "b7fcb6d2-33ee-723f-7256-1f3787862784",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [
            "laboris voluptate in occaecat Duis",
            "labore tempor",
            "dolor aliqua aliquip Duis anim",
            "eiusmod esse in"
          ],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1897-12-24T17:06:22.0Z",
          "updated_at": "1966-01-26T07:07:33.0Z"
        }
      ],
      "revenue_schedule": "FREQ=WEEKLY",
      "created_at": "1905-12-23T22:09:16.0Z",
      "updated_at": "1956-11-15T14:03:06.0Z",
      "deleted_at": "1929-12-28T04:01:27.0Z"
    },
    "payment_details_url": "commodo nulla",
    "created_at": "1945-01-10T10:37:01.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": "b37004ec-b151-1bb3-f90a-160b3287cf5e",
    "membership": {
      "id": "63529ac0-e472-7791-1e1e-b98467ffd36c",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "af09c022-79b4-5f96-f460-ff720222e774",
      "customer_name": "Jane Jones"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones",
      "processor_type_id": "69e3f3f58a8cc90146000240"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "eiusmod aute dolore ad do",
    "can_download_receipt": false,
    "amount_refunded": 26160375,
    "refunded": false,
    "refunds": [],
    "site_id": "725e4bc9-31e4-50ed-171f-242fac5f189d",
    "billing_period_from": "1922-01-29",
    "billing_period_to": "1946-11-22",
    "processing_at": "1908-08-21T19:28:37.0Z",
    "created_at": "1899-08-16T04:19:16.0Z",
    "updated_at": "1946-07-06T03:47:01.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": "c3bc62d5-3665-561b-6054-c4895cc15bcf",
    "membership": {
      "id": "44e6df81-e29e-d095-46ff-f22cef7ad6ea",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "067d842e-6850-a412-fee2-4a45ecb03896",
      "customer_name": "Jane Jones"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones",
      "processor_type": "Cash",
      "processor_type_id": "69e3f3f48a8cc9014600008d"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "quis",
    "can_download_receipt": true,
    "amount_refunded": -40672512,
    "refunded": true,
    "refunds": [
      {
        "id": "46684fa8-61ad-6b10-e851-0fd2cb3c205b",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "af2b6936-50a9-545f-643d-3f967d4d0a70",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1900-11-22T18:01:18.0Z",
        "updated_at": "1957-03-07T01:07:39.0Z"
      },
      {
        "id": "1b8b66f7-858e-4672-b63d-cb69ec444563",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "ebbeb89f-5ca5-0dce-5899-ef943dffbdab",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1915-12-15T03:08:45.0Z",
        "updated_at": "1902-11-23T18:33:38.0Z"
      },
      {
        "id": "1b69abf1-69c2-ca4e-45bc-e4be86150bc4",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "537d67b4-6471-3cb0-975c-c01f6bd185b0",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1967-08-20T22:26:01.0Z",
        "updated_at": "1901-01-17T03:01:15.0Z"
      },
      {
        "id": "361df43d-8cd1-df4e-b3b2-4678d3d067d7",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "fa081d82-da5a-167e-ce66-fe444d264f56",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1954-01-21T23:13:55.0Z",
        "updated_at": "1963-02-17T22:05:39.0Z"
      },
      {
        "id": "23b5335e-8e23-f579-d8d9-635bcdc36d12",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "e9f2df18-6ef7-c0fd-213e-37fb74852fed",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1927-10-02T02:49:29.0Z",
        "updated_at": "1890-06-10T15:08:11.0Z"
      }
    ],
    "site_id": "ffdb6fae-4aa1-e87d-2e7f-7e4c37c71381",
    "billing_period_from": "1965-05-16",
    "billing_period_to": "1909-01-01",
    "processing_at": "1914-04-30T19:49:02.0Z",
    "created_at": "1952-06-26T20:14:24.0Z",
    "updated_at": "1964-05-08T08:20:17.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": "b7c51266-1e6e-f2d8-c1f1-b1c9decbd432",
    "membership": {
      "id": "1117fa94-4fdf-ea8d-76e6-91cef5c9bdb5",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "811d2c29-5469-c165-d08f-b837e03e8922",
      "customer_name": "Jane Jones"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones",
      "last_4": 4001,
      "processor_type": "Cash",
      "processor_type_id": "69e3f3f48a8cc9014600008e"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "sunt",
    "can_download_receipt": true,
    "amount_refunded": -77828626,
    "refunded": true,
    "refunds": [
      {
        "id": "a3051d31-17c7-35c0-7794-2ce6a0ff269c",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "f081b17a-6dbd-e9d1-3009-17188ba352bd",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1944-07-27T10:13:51.0Z",
        "updated_at": "1962-10-27T05:21:39.0Z"
      },
      {
        "id": "0ca2e461-f578-155c-d740-5287ab825330",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "6416451e-bdf7-170a-e29e-3ddb785f6ec3",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1956-11-03T04:31:49.0Z",
        "updated_at": "1890-10-23T05:30:28.0Z"
      },
      {
        "id": "9c2833d1-c46f-97e6-9113-2c2275fe1bbf",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "52429329-e977-7b98-9d2c-7f69a9e84fe6",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1905-09-26T03:22:10.0Z",
        "updated_at": "1947-02-24T06:20:47.0Z"
      },
      {
        "id": "3bacb1f1-876d-952a-2ace-4910ba2770c9",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "e3af9e29-7f25-f6d7-798b-fef209863a37",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1963-11-11T12:43:02.0Z",
        "updated_at": "1890-12-31T12:41:12.0Z"
      },
      {
        "id": "451a165b-a871-2f9f-6268-52fd32d45ee4",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "0f1180f2-caaf-c01a-c468-450b64947d0c",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1945-07-26T02:27:06.0Z",
        "updated_at": "1953-03-29T02:14:28.0Z"
      }
    ],
    "site_id": "0e6d0dbb-6a6c-2711-5cff-a8b9df781eca",
    "billing_period_from": "1943-07-24",
    "billing_period_to": "1913-03-26",
    "processing_at": "1897-06-27T03:25:26.0Z",
    "created_at": "1950-10-19T21:24:18.0Z",
    "updated_at": "1959-06-27T20:36:16.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": "69e3f3f58a8cc90146000241",
    "organisation_id": "bc8b7643-c63d-181d-6097-71f2979053ae",
    "site_id": "4ea4f893-3188-9577-7bf7-e4b79e4a78f0",
    "customer_id": "b1facf80-6b02-091a-c3cf-04a75a8d0616",
    "membership_id": "e5b79daf-c91b-1721-1137-b61ad4d3cbed",
    "from": "Trybe",
    "to": "+447123456789",
    "message": "sit id Excepteur tempor Ut",
    "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": {
    "et_25": [],
    "pariatur8": [],
    "veniam4": [
      "aliquip sit do quis nostrud",
      "proident nulla est Lorem",
      "nulla ullamco officia",
      "tempor amet in veniam",
      "enim adipisicing"
    ]
  },
  "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": "45ace1fe-7674-5065-d5fb-673c392c44d5",
    "organisation_id": "4140737d-5fe5-99dd-9c62-e29cb0830e0b"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}