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": "1f441d4d-8c9c-3961-12f7-dc0bb04b656a",
      "attention_reason": "payment_disputed",
      "basket_id": "699306c78cf5970137000066",
      "customer": {
        "id": "c36342f8-5ce0-9815-bc2c-9cf307ddb645",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1965-07-21",
        "brand_id": "afd70431-ad43-5631-d72a-02e7d2c124de",
        "site_id": "f13cf473-c55c-536a-f1d1-8e989a4c7bb1",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [],
        "preferred_locale": "en",
        "locked_at": "1929-08-01T21:05:56.0Z",
        "created_at": "1912-06-07T13:18:10.0Z",
        "updated_at": "1890-09-19T02:30:59.0Z",
        "deleted_at": "1908-05-16T08:45:26.0Z",
        "last_active_at": "1937-12-12T03:38:18.0Z",
        "email_verified_at": "1892-05-18T22:45:33.0Z",
        "last_check_in": {
          "checked_in_at": "1939-12-23T01:01:32.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "8362076c-9242-a178-15b0-eadbf3075c00",
          "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": "nulla"
      },
      "end_date": "1907-11-18T19:30:54.0Z",
      "external_ref": "esse fugiat ex exercitation nulla",
      "members": [
        {
          "customer_id": "d62bad76-b173-3486-c42a-ac05335edeff",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "63584ef1-1e2f-58ab-1c68-756b8dbf1f75",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "d7cfd907-feec-678e-17ff-ef93b36780bf",
          "is_lead": true,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1931-03-13T05:36:35.0Z",
      "next_charge": {
        "id": "0e37f808-7dfa-2444-4798-4e4103541b94",
        "amount": 3995,
        "currency": "GBP",
        "status": "awaiting_approval",
        "billing_period_from": "1917-09-09",
        "billing_period_to": "1943-10-30"
      },
      "payment_method": {
        "id": "do Ut nisi",
        "type": "card",
        "card_brand": "amex"
      },
      "rate": {
        "id": "69579f61-096f-701e-360b-0031c9341819",
        "membership_type_id": "077c42ee-6f47-dc1e-358f-9886e3044b52",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "quis magna non",
          "sed officia irure Duis amet",
          "ex deserunt esse",
          "elit amet"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1965-06-08T23:23:31.0Z",
        "updated_at": "1916-02-17T09:17:47.0Z"
      },
      "site_id": "4fcf002c-006c-5020-1a7e-d57833e290e0",
      "source": "import",
      "start_date": "1963-09-10T06:26:10.0Z",
      "status": "inactive",
      "status_updated_at": "1947-07-18T19:52:28.0Z",
      "type": {
        "id": "41f07eaa-4c87-9891-21bc-6a6273990a48",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "dolore sed proident Excepteur cupidatat",
        "brand_id": "67e32100-36b7-f077-e398-74e19c8dd3e5",
        "offline_payments": true,
        "disable_confirmation_email": true,
        "private": true,
        "visibility": "link_only",
        "minimum_start_date": "1895-02-19T17:12:07.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1924-02-26T05:39:53.0Z",
        "updated_at": "1949-12-05T20:20:06.0Z",
        "deleted_at": "1960-10-17T16:04:15.0Z"
      },
      "payment_details_url": "pariatur",
      "created_at": "1946-09-29T13:56:26.0Z"
    },
    {
      "id": "1414e885-3619-7422-e256-138b4ab46521",
      "attention_reason": "payment_outstanding",
      "basket_id": "699306c78cf5970137000067",
      "customer": {
        "id": "f777f03e-1550-0d5d-556f-7acb72fcd97d",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1918-09-01",
        "brand_id": "bafc56f9-9c2a-de72-7f44-dbaa09ba9fb4",
        "site_id": "9393db6d-295a-0639-5388-3b79d1e4d944",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "d372f114-7d3a-ff69-b61d-4e6e42957d85",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "8d7ec4e2-1562-16fb-3d65-3a0ff9fd18a7",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "f7d332e1-e243-65dd-afd1-4e511393a9fb",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1902-02-19T01:05:25.0Z",
        "created_at": "1957-02-10T05:20:46.0Z",
        "updated_at": "1925-11-22T16:44:38.0Z",
        "deleted_at": "1953-05-06T01:36:38.0Z",
        "last_active_at": "1945-09-16T08:03:56.0Z",
        "email_verified_at": "1919-03-06T13:53:13.0Z",
        "last_check_in": {
          "checked_in_at": "1901-06-21T04:20:44.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "9f1f0381-de4b-2b98-8a18-8d1075c50996",
          "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": "dolore"
      },
      "end_date": "1896-09-27T01:24:04.0Z",
      "external_ref": "culpa sunt",
      "members": [
        {
          "customer_id": "69ce1575-cbd4-9df9-e274-17023ba09165",
          "is_lead": false,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1912-09-15T22:52:13.0Z",
      "next_charge": {
        "id": "b25a2249-dce1-20f4-4e0c-0b0ded63fbca",
        "amount": 3995,
        "currency": "GBP",
        "status": "failed",
        "billing_period_from": "1969-08-19",
        "billing_period_to": "1902-09-03"
      },
      "payment_method": {
        "id": "ullamco in cupidatat culpa tempor",
        "type": "direct_debit",
        "last_4": "nulla esse do",
        "status": "revoked",
        "card_brand": "amex"
      },
      "rate": {
        "id": "c0408b83-06bc-27c6-fa3d-7dcfe177d706",
        "membership_type_id": "e8927007-67d4-c06c-9400-d2d2e1df55a9",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "Ut ut aliquip reprehenderit",
          "nisi magna do quis ad",
          "reprehenderit minim voluptate dolore elit",
          "commodo"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1952-08-05T06:55:58.0Z",
        "updated_at": "1897-12-29T02:27:23.0Z"
      },
      "site_id": "b6d03987-e853-cbe4-0124-12fecef7ad36",
      "source": "import",
      "start_date": "1910-01-21T04:55:57.0Z",
      "status": "reserved",
      "status_updated_at": "1965-04-21T03:44:17.0Z",
      "type": {
        "id": "b2d0eb10-e0eb-deba-f684-e772442ed724",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "pariatur culpa dolor",
        "brand_id": "cd5e9c3f-3655-6254-8c69-9c80d170f976",
        "offline_payments": false,
        "disable_confirmation_email": false,
        "private": true,
        "visibility": "public",
        "minimum_start_date": "1891-02-11T19:50:37.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "0ffbe36e-a359-5396-04db-a2958b0533c6",
            "membership_type_id": "92883c62-0a73-8716-092d-36e575063d57",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "minim"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1947-07-28T18:49:22.0Z",
            "updated_at": "1900-09-10T09:29:38.0Z"
          },
          {
            "id": "02b938c8-1919-2bb8-ecef-4a01b4c24114",
            "membership_type_id": "0cc20d83-d586-3885-e316-888c2ebea654",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "ex proident ut dolor",
              "reprehenderit"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1910-02-14T23:13:52.0Z",
            "updated_at": "1934-02-11T02:33:02.0Z"
          },
          {
            "id": "8e254e35-2d31-b7e0-368c-bad46af669cc",
            "membership_type_id": "1fb42322-dd70-fa7c-1def-3ef1f79f33a4",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "sunt velit voluptate do",
              "nulla enim",
              "ut anim minim adipisicing esse"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1920-11-12T05:58:21.0Z",
            "updated_at": "1941-02-26T10:53:10.0Z"
          },
          {
            "id": "9e5d701f-cd3a-21dc-6a94-e2a943c4b5a1",
            "membership_type_id": "4f38518b-f1c4-2740-0ce5-74424b27bca1",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "minim non ex",
              "quis"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1906-11-07T04:03:03.0Z",
            "updated_at": "1941-02-12T03:25:50.0Z"
          },
          {
            "id": "03d600ba-d453-0461-62c1-85cfdcd5a897",
            "membership_type_id": "0be81df5-734f-d626-6dcb-fc9a199a1971",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "ad pariatur ut",
              "ad voluptate nisi",
              "velit adipisicing reprehenderit ex",
              "sunt elit consequat"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1911-09-20T08:54:35.0Z",
            "updated_at": "1951-06-11T04:25:45.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1900-12-11T21:24:16.0Z",
        "updated_at": "1937-01-15T08:48:07.0Z",
        "deleted_at": "1956-12-30T23:32:26.0Z"
      },
      "payment_details_url": "anim in ut deserunt",
      "created_at": "1906-03-06T09:40:20.0Z"
    },
    {
      "id": "4e342a10-7d14-28fc-7925-636c87a26e95",
      "attention_reason": "site_id",
      "basket_id": "699306c78cf5970137000068",
      "customer": {
        "id": "361531a9-837c-1cfb-4812-c577627664ec",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1912-04-05",
        "brand_id": "86853fe1-79c5-8f75-3ee4-2be2f9d180cc",
        "site_id": "9c700a58-3b19-51cb-a6c7-3e3d71c7e17e",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "b170550c-fc60-9424-8c19-62707c6a7862",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "26319782-db12-3026-8540-ae7954495b84",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "5c8462e8-06be-1e49-5cdc-347aee6b5f98",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "1008642d-88fe-7654-2090-89b8b5f4c3a1",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "91764209-985e-174a-ff16-6ba367b039f4",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1898-04-07T15:56:17.0Z",
        "created_at": "1968-03-06T10:06:30.0Z",
        "updated_at": "1928-10-11T06:38:06.0Z",
        "deleted_at": "1907-01-25T18:59:47.0Z",
        "last_active_at": "1897-05-06T17:37:31.0Z",
        "email_verified_at": "1950-10-11T05:02:30.0Z",
        "last_check_in": {
          "checked_in_at": "1918-05-24T12:10:44.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "dd71c0f4-3171-adaf-5d09-1d99cb6fb0bf",
          "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": "elit minim"
      },
      "end_date": "1899-06-23T13:29:23.0Z",
      "external_ref": "aliquip",
      "members": [],
      "membership_number": "1234567890",
      "next_billing_date": "1930-07-31T13:23:48.0Z",
      "next_charge": {
        "id": "4b3167ee-b020-d7e2-e5d3-9efa2a099742",
        "amount": 3995,
        "currency": "GBP",
        "status": "awaiting_approval",
        "billing_period_from": "1907-08-24",
        "billing_period_to": "1956-08-18"
      },
      "payment_method": {
        "id": "fugiat occaecat",
        "type": "card",
        "status": "revoked",
        "card_brand": "amex"
      },
      "rate": {
        "id": "7268b952-b4f3-8321-5f1e-929c02adab04",
        "membership_type_id": "ea7a52af-66f1-1519-0e11-2a3d63323d03",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "proident in aliquip veniam anim",
          "voluptate sunt",
          "minim et ullamco incididunt"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1947-07-13T08:26:22.0Z",
        "updated_at": "1961-09-15T16:28:16.0Z"
      },
      "site_id": "2260d5c6-2be4-99ee-ae15-88a2fca0c338",
      "source": "app",
      "start_date": "1962-05-16T01:27:35.0Z",
      "status": "upcoming",
      "status_updated_at": "1917-02-27T13:05:06.0Z",
      "type": {
        "id": "f2121f98-554f-bc5c-0bfd-4982537b3fc2",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "voluptate",
        "brand_id": "f248c026-58fa-6049-5813-1c6c00386e87",
        "offline_payments": false,
        "disable_confirmation_email": false,
        "private": false,
        "visibility": "private",
        "minimum_start_date": "1923-06-10T15:28:30.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "036611fd-571d-e989-a5f7-62575b330670",
            "membership_type_id": "153d6fcd-0f20-95f8-e5a8-3103e9e06f09",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "in"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1935-06-13T05:56:11.0Z",
            "updated_at": "1906-12-10T02:48:47.0Z"
          },
          {
            "id": "654e4aeb-a949-e075-54ff-e25ecf690851",
            "membership_type_id": "06b269ba-ced0-2886-4ed1-1f4f2a185849",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "et laboris dolore",
              "minim Lorem nisi ut",
              "deserunt nisi nostrud sit"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1896-12-10T08:53:32.0Z",
            "updated_at": "1945-10-13T05:15:12.0Z"
          },
          {
            "id": "55a8f357-e3f8-7257-f04b-cd8a4b3e3549",
            "membership_type_id": "428c852a-ed8e-74cf-128a-a36d0b4756d9",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1911-10-13T01:55:23.0Z",
            "updated_at": "1911-10-26T19:49:36.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1900-08-27T09:04:11.0Z",
        "updated_at": "1891-03-26T20:55:54.0Z",
        "deleted_at": "1920-10-08T11:27:33.0Z"
      },
      "payment_details_url": "aliqua cupidatat",
      "created_at": "1921-09-19T02:31:12.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": "bec73906-2a2b-a2a3-66c6-194dd98486af",
    "attention_reason": "payment_outstanding",
    "basket_id": "699306c78cf5970137000069",
    "customer": {
      "id": "f148a5e5-8da2-d8a2-f3de-090c140e8850",
      "first_name": "Jane",
      "last_name": "Doe",
      "full_name": "Jane Doe",
      "phone": "+447900000000",
      "has_password": true,
      "dob": "1961-06-08",
      "brand_id": "0dc82eb7-92a3-2b34-ec0a-13fa6c77f930",
      "site_id": "fd1d4088-779e-2a5f-afa7-2637db91fb50",
      "stripe_id": "cus_1234567890",
      "express_stripe_id": "cus_1234567890",
      "email": "janedoe@example.com",
      "labels": [
        {
          "id": "83312fc5-2da7-048b-8050-61c111a13129",
          "value": "VIP",
          "colour": "ff6634"
        },
        {
          "id": "8ec619be-9896-206d-a879-ea10c79c31bc",
          "value": "VIP",
          "colour": "ff6634"
        },
        {
          "id": "37776f61-7187-5af8-4c03-78a964ba0dbb",
          "value": "VIP",
          "colour": "ff6634"
        }
      ],
      "preferred_locale": "en",
      "locked_at": "1937-10-15T02:27:15.0Z",
      "created_at": "1940-03-28T01:18:36.0Z",
      "updated_at": "1953-05-17T02:14:53.0Z",
      "deleted_at": "1946-11-11T08:25:23.0Z",
      "last_active_at": "1931-08-23T21:01:56.0Z",
      "email_verified_at": "1955-09-04T09:06:08.0Z",
      "last_check_in": {
        "checked_in_at": "1908-04-29T19:04:14.0Z",
        "method": "Scanned"
      },
      "avatar_id": "000000-000000-000000-000000",
      "avatar": {
        "id": "0ef4fa31-4853-a853-7fea-66a9189a3d52",
        "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": "aliqua qui quis"
    },
    "end_date": "1910-09-02T08:33:41.0Z",
    "external_ref": "officia",
    "members": [
      {
        "customer_id": "77c60a7d-d13c-f577-16b6-fc64c6ea1ce0",
        "is_lead": false,
        "membership_number": "1234567890"
      },
      {
        "customer_id": "0046845c-f870-9b18-9345-56d03526004f",
        "is_lead": false,
        "membership_number": "1234567890"
      },
      {
        "customer_id": "9a2f79c7-3804-cd6c-30ca-2e8b255b299f",
        "is_lead": true,
        "membership_number": "1234567890"
      }
    ],
    "membership_number": "1234567890",
    "next_billing_date": "1907-11-05T10:27:02.0Z",
    "next_charge": {
      "id": "3099df90-18fb-e7b1-a928-f61b1e30090f",
      "amount": 3995,
      "currency": "GBP",
      "status": "succeeded",
      "billing_period_from": "1963-11-24",
      "billing_period_to": "1907-02-18"
    },
    "payment_method": {
      "id": "non et Duis do ut",
      "type": "card",
      "last_4": "quis dolor irure aute",
      "status": "revoked",
      "card_brand": "amex"
    },
    "rate": {
      "id": "5647a5ab-9ea2-4ef0-8cc0-17c1f72d4bf2",
      "membership_type_id": "0473bfca-b2a0-74f8-1cfb-8d60fa24fdbd",
      "name": "Standard rate",
      "currency": "GBP",
      "price": 5000,
      "joining_fee": 1000,
      "billing_frequency": "P1M",
      "processors": [
        "adipisicing dolore magna pariatur ullamco",
        "enim cupidatat",
        "ea ex",
        "aliqua"
      ],
      "default_duration": "P1Y",
      "private": true,
      "created_at": "1903-08-31T10:18:04.0Z",
      "updated_at": "1917-10-29T04:04:51.0Z"
    },
    "site_id": "92392c8d-e18b-dc53-9f47-647f28b3ecb3",
    "source": "import",
    "start_date": "1920-08-18T19:58:30.0Z",
    "status": "needs_dd_mandate",
    "status_updated_at": "1900-09-29T20:41:56.0Z",
    "type": {
      "id": "3000da8e-715d-ee93-c75f-08681eacdbbe",
      "name": "Gold tier",
      "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
      "terms": "laboris irure pariatur ullamco",
      "brand_id": "87e8ccb5-0b3c-2977-4190-c0a00dd10887",
      "offline_payments": true,
      "disable_confirmation_email": true,
      "private": false,
      "minimum_start_date": "1940-06-11T08:45:59.0Z",
      "min_members": 2,
      "max_members": 4,
      "rates": [],
      "revenue_schedule": "FREQ=WEEKLY",
      "created_at": "1925-04-11T23:57:15.0Z",
      "updated_at": "1943-11-15T02:09:58.0Z",
      "deleted_at": "1894-08-28T18:19:14.0Z"
    },
    "payment_details_url": "deserunt veniam in commodo non",
    "created_at": "1948-12-28T08:30:59.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": "2a93a989-f5ab-9ad8-c9c5-e2a2bf42cd40",
    "membership": {
      "id": "107ebe7b-e223-ac97-89a6-0383f94d33ad",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "0c6800e0-fb5b-b271-2807-e8a1d50520d3"
    },
    "processor": "adyen",
    "processor_data": {
      "last_4": 4001,
      "processor_type_id": "699306c88cf597013700009e"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "amet Ut qui",
    "can_download_receipt": true,
    "amount_refunded": 19193931,
    "refunded": true,
    "refunds": [
      {
        "id": "0f9325c5-d67e-64e4-159e-6f7275d0bcd9",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "1d1398c9-e025-3042-127a-2aed5526edd9",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1890-11-09T06:30:21.0Z",
        "updated_at": "1893-05-16T02:33:17.0Z"
      },
      {
        "id": "26bdffe9-6a7a-ca9b-53e8-8b4f2b94aff1",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "dea8a5e5-6a6a-8ebf-438c-087ffb2e865d",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1891-12-13T16:01:02.0Z",
        "updated_at": "1968-05-17T02:27:06.0Z"
      }
    ],
    "site_id": "f747f382-6264-217b-8a5d-96016fb73422",
    "billing_period_from": "1942-02-09",
    "billing_period_to": "1964-08-16",
    "processing_at": "1936-10-03T11:09:37.0Z",
    "created_at": "1961-08-22T11:09:59.0Z",
    "updated_at": "1898-05-15T22:40:23.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": "57183085-73ab-bf6d-f4ef-c883d3d35d37",
    "membership": {
      "id": "88efc770-87cb-fc42-d1bf-8419b9f9e8e5",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "0468e969-0331-4776-41d3-7781ea6a8518",
      "customer_name": "Jane Jones"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "adipisicing do",
    "can_download_receipt": true,
    "amount_refunded": 88160058,
    "refunded": false,
    "refunds": [
      {
        "id": "35923f20-39fa-20af-d8a9-d136446048e6",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1940-06-15T14:26:14.0Z",
        "updated_at": "1911-06-21T15:04:02.0Z"
      },
      {
        "id": "7f7989a9-4afe-39e1-987c-3f66c270a769",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "e60e9b03-c7c9-e1d7-7908-7dc7d3dd2968",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1968-03-04T12:44:56.0Z",
        "updated_at": "1921-12-31T14:57:36.0Z"
      },
      {
        "id": "0b52c766-42b1-08cf-d46e-905bc811bedf",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "refunded_by": {
          "id": "1a955644-ad78-880f-838b-5c7ef5d5c663",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1911-03-09T23:47:39.0Z",
        "updated_at": "1896-01-12T14:14:25.0Z"
      },
      {
        "id": "38014c95-2be3-9928-14c7-bd5f768dfe21",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "46d3bc1b-2932-37d0-20a0-e77357bed220",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1962-07-23T15:25:13.0Z",
        "updated_at": "1921-07-12T01:40:07.0Z"
      }
    ],
    "site_id": "28617b2f-75d9-8ade-d3f4-4e4d1cbc56f4",
    "billing_period_from": "1962-11-08",
    "billing_period_to": "1949-09-17",
    "processing_at": "1924-11-15T18:55:44.0Z",
    "created_at": "1920-01-27T18:38:44.0Z",
    "updated_at": "1944-03-17T20:40:45.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": "2ec3bf57-df70-40ac-595e-05619fee8122",
    "membership": {
      "id": "b144892c-80b9-39ed-a19c-ddbd776cce6c",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "405fb110-3d4e-929d-d270-bfc4cf2a6fa8",
      "customer_name": "Jane Jones"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones",
      "last_4": 4001,
      "processor_type": "Cash",
      "processor_type_id": "699306c78cf597013700006a"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "id sit est fugiat",
    "can_download_receipt": true,
    "amount_refunded": 52993853,
    "refunded": false,
    "refunds": [
      {
        "id": "15a92028-01e3-5251-6e14-3c1dc81e3497",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "3eb35544-41b7-98f6-6a97-5dfdd73753c8",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1939-05-28T04:39:53.0Z",
        "updated_at": "1934-06-15T15:34:25.0Z"
      },
      {
        "id": "5ab5ed08-7dae-6a42-d0c3-e1b3f015ad4f",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "b6077621-9ef1-c1ac-36a0-ece2717fa7db",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1959-01-29T07:45:16.0Z",
        "updated_at": "1921-07-11T07:18:59.0Z"
      },
      {
        "id": "43da006b-804d-7245-1b63-5095a659dcfd",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "237fc1fc-fadb-09c2-0733-ba6449400819",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1908-08-25T19:15:52.0Z",
        "updated_at": "1928-09-30T09:44:21.0Z"
      },
      {
        "id": "f320fa63-e86f-416a-6c3a-912a3a3e942b",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "b62e3fbe-63a6-5bbf-3a10-c5fda64c1c85",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1947-02-01T16:04:47.0Z",
        "updated_at": "1918-01-12T04:45:52.0Z"
      }
    ],
    "site_id": "246f0a64-bf6a-e741-e0f6-bc5b3475bc68",
    "billing_period_from": "1962-04-26",
    "billing_period_to": "1959-10-10",
    "processing_at": "1933-04-13T15:40:33.0Z",
    "created_at": "1932-02-08T06:36:03.0Z",
    "updated_at": "1957-06-30T20:42:23.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": "699306c88cf597013700009f",
    "organisation_id": "1f308508-8436-9dce-45c9-3d9c3732ac03",
    "site_id": "d1208901-fdee-175b-3c1d-25f83e8d7c67",
    "customer_id": "6a76f979-a54b-cf3f-74ac-368c00e3a397",
    "membership_id": "f2531dd0-831e-6ccf-75ba-4d025858ee5f",
    "from": "Trybe",
    "to": "+447123456789",
    "message": "magna aute dolore enim",
    "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": {
    "sit_64": [
      "ullamco occaecat",
      "Excepteur reprehenderit ea",
      "anim incididunt commodo ad",
      "cupidatat nulla",
      "fugiat nisi laboris elit"
    ],
    "incididunt_319": [
      "nisi et quis",
      "Duis eiusmod",
      "cupidatat ut aliqua",
      "ut dolore aliqua"
    ],
    "Duis3f2": [
      "incididunt",
      "cupidatat Excepteur cillum deserunt sit",
      "occaecat commodo cupidatat deserunt"
    ]
  },
  "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": "b75e9351-9bcd-572c-55d3-515d6eef8c72",
    "organisation_id": "9b4767c3-129c-3aa6-d619-7dc6f8e59658"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}