Memberships

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

Schema

Attributes

  • The ID of the membership

  • The ID of the site this membership belongs to

  • 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.

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

  • Where the membership was created

    Possible values are self_signup, app, import and unknown

  • 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 date which the membership starts

  • The date which the membership ends

  • The datetime which the membership was created

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

  • An external reference for this membership.

  • 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.

  • 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

""
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": "19f50a56-c43b-5830-24eb-66beb8feb076",
      "site_id": "6a7769dd-366f-d582-cb1a-9a8b61eea91c",
      "membership_number": "1234567890",
      "customer": {
        "id": "0d127060-7aff-ea94-197f-587656da2d0d",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1899-05-22",
        "brand_id": "53a60e94-1695-3d60-2aab-d1c21ed3c0f0",
        "site_id": "839da911-f47d-6f36-5f0b-ed77b61e01b4",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "4a020490-b312-8b38-689a-c6ad3a72ae8a",
            "name": "VIP",
            "color": "ff6634"
          },
          {
            "id": "2e76110a-9f0b-2b6d-900f-4cfb0a938873",
            "name": "VIP",
            "color": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1893-08-24T05:09:49.0Z",
        "created_at": "1933-09-25T03:33:35.0Z",
        "updated_at": "1918-09-25T02:17:58.0Z",
        "deleted_at": "1891-02-04T18:28:43.0Z",
        "last_active_at": "1909-12-24T23:44:56.0Z",
        "email_verified_at": "1963-08-11T11:47:35.0Z",
        "last_check_in": {
          "checked_in_at": "1906-12-11T22:55:31.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "74e64027-1e56-861e-7745-30be4a5c46e7",
          "file_name": "super-cool-photo.jpg",
          "mime_type": "image/jpeg",
          "size": 84256,
          "url": "https://example.com/media/super-cool-photo.jpg"
        },
        "external_ref": "enim amet"
      },
      "members": [],
      "type": {
        "id": "e9fdf620-f0a9-508a-8ab3-4f341eb0e0fa",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "id cupidatat in",
        "brand_id": "b5d8a663-51d6-284a-7f48-3fd4f48d5771",
        "offline_payments": true,
        "disable_confirmation_email": true,
        "private": true,
        "visibility": "private",
        "minimum_start_date": "1965-05-13T06:31:41.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "194aea71-82d1-0330-d8b2-5fbad14f5607",
            "membership_type_id": "93386765-8a69-2a4a-53bb-c06abf703075",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "tax": 1250,
            "billing_frequency": "P1M",
            "processors": [],
            "default_duration": "P1Y",
            "private": true,
            "updated_at": "1952-03-22T20:04:26.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1904-01-20T18:10:41.0Z",
        "updated_at": "1910-02-26T19:28:25.0Z",
        "deleted_at": "1968-12-16T11:11:08.0Z"
      },
      "end_date": "1918-09-02T14:15:36.0Z",
      "basket_id": "693167497c381e01250000c3",
      "next_charge": {
        "id": "0af26679-621c-beb6-869f-aa6c8b121a13",
        "amount": 3995,
        "currency": "GBP",
        "status": "pending",
        "billing_period_from": "1915-06-19",
        "billing_period_to": "1919-03-05"
      }
    },
    {
      "id": "52c9f1e8-8cd1-1043-5898-a531f31cba84",
      "site_id": "475ce735-6561-9eea-2849-93266a0d6b1b",
      "membership_number": "1234567890",
      "customer": {
        "id": "6d34676c-2a55-e942-6756-f8119af04b78",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1926-09-30",
        "brand_id": "cf75c625-0cef-f068-6f48-048ac2772bdf",
        "site_id": "2658c492-5089-8284-80b1-18af3f7b4292",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "ba1160f9-0cbe-bc3f-cc86-3dabb929d1a1",
            "name": "VIP",
            "color": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1925-09-11T22:42:34.0Z",
        "created_at": "1960-11-27T08:07:01.0Z",
        "updated_at": "1942-06-23T20:05:51.0Z",
        "deleted_at": "1915-11-29T08:05:39.0Z",
        "last_active_at": "1965-11-08T16:53:11.0Z",
        "email_verified_at": "1905-01-13T23:18:20.0Z",
        "last_check_in": {
          "checked_in_at": "1926-04-14T11:14:13.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "598eef68-b481-a357-cf2a-5c82a5517a18",
          "file_name": "super-cool-photo.jpg",
          "mime_type": "image/jpeg",
          "size": 84256,
          "url": "https://example.com/media/super-cool-photo.jpg"
        },
        "external_ref": "ipsum"
      },
      "members": [
        {
          "customer_id": "bdc671af-037d-8d9c-767e-c9672d835d80",
          "membership_number": "1234567890"
        }
      ],
      "type": {
        "id": "f1064d9b-326c-8c76-7555-61e80333ac13",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "Lorem",
        "brand_id": "8482a2f6-d56b-613e-8e90-f77d02de9fb7",
        "offline_payments": false,
        "disable_confirmation_email": false,
        "private": false,
        "visibility": "private",
        "minimum_start_date": "1932-09-29T02:46:06.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "8e4ee75f-139a-b5f6-3364-7cb96d0597aa",
            "membership_type_id": "98949513-9fc9-fd1a-83ef-1627e621680a",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "tax": 1250
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1917-04-26T03:01:54.0Z",
        "updated_at": "1931-12-29T01:35:41.0Z",
        "deleted_at": "1942-02-15T16:10:26.0Z"
      },
      "rate": {
        "id": "aa24f4e6-bbac-f492-946e-28b70e47b481",
        "membership_type_id": "1b51b177-1565-92dd-870e-59c1f652bba5",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "tax": 1250,
        "billing_frequency": "P1M",
        "processors": [
          "Excepteur enim",
          "quis Lorem in Duis",
          "cillum",
          "id"
        ],
        "default_duration": "P1Y",
        "private": true,
        "updated_at": "1949-09-28T17:27:18.0Z"
      },
      "status": "upcoming",
      "source": "import",
      "payment_method": {
        "id": "commodo ullamco sed",
        "type": "direct_debit",
        "last_4": "reprehenderit",
        "status": "revoked"
      },
      "start_date": "1968-12-26T10:08:17.0Z",
      "end_date": "1910-07-01T14:34:37.0Z",
      "created_at": "1961-04-27T06:42:11.0Z",
      "basket_id": "693167497c381e01250000c4",
      "external_ref": "do qui esse cillum Ut",
      "next_charge": {
        "id": "374a24cc-6129-b7b4-05c4-6140746e4ded",
        "amount": 3995,
        "currency": "GBP",
        "status": "failed",
        "billing_period_from": "1945-10-17",
        "billing_period_to": "1893-01-03"
      },
      "attention_reason": "payment_disputed"
    },
    {
      "id": "58d19e6c-2222-aed1-edec-747a17bfddbb",
      "site_id": "b6e85576-0171-b248-3718-e6a3f76d073a",
      "membership_number": "1234567890",
      "customer": {
        "id": "af16f99d-f0ec-359d-df24-129b7bf1cc76",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1902-09-14",
        "brand_id": "4580e7b6-540f-9770-4551-7e68b63da3e0",
        "site_id": "e77e1ff3-7d4c-aa8b-9f3f-b75486d6e2ec",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "683b93d1-995f-d061-52a2-d2c12f138409",
            "name": "VIP",
            "color": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1931-10-28T07:06:01.0Z",
        "created_at": "1923-05-07T07:50:26.0Z",
        "updated_at": "1931-05-14T20:25:41.0Z",
        "deleted_at": "1913-12-02T08:45:30.0Z",
        "last_active_at": "1955-03-31T14:19:29.0Z",
        "email_verified_at": "1943-06-04T16:49:06.0Z",
        "last_check_in": {
          "checked_in_at": "1948-06-12T20:07:29.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "10db16f8-0ec1-bef6-b592-524cd2b86a34",
          "file_name": "super-cool-photo.jpg",
          "mime_type": "image/jpeg",
          "size": 84256,
          "url": "https://example.com/media/super-cool-photo.jpg"
        },
        "external_ref": "eiusmod tempor commodo"
      },
      "members": [
        {
          "customer_id": "a344373b-69d6-8aad-4be0-92b878ea3380",
          "is_lead": true
        }
      ],
      "type": {
        "id": "0d328545-c562-b753-4143-e354839c864c",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "dolore voluptate non sed ipsum",
        "brand_id": "34afb40f-d028-0056-1569-9e006c5d833c",
        "offline_payments": false,
        "disable_confirmation_email": false,
        "private": true,
        "visibility": "public",
        "minimum_start_date": "1956-09-19T08:22:34.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1944-02-24T07:41:28.0Z",
        "updated_at": "1906-05-28T18:01:05.0Z",
        "deleted_at": "1951-04-03T03:14:27.0Z"
      },
      "rate": {
        "id": "e6e663cc-f624-37df-50dc-e53013eeed34",
        "membership_type_id": "46251d14-bc53-0b61-1341-599eeb9f2901",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "tax": 1250,
        "processors": [
          "deserunt ex in quis",
          "consequat incididunt",
          "tempor dolore dolor mollit elit",
          "reprehenderit cillum consequat ad fugiat"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1918-08-17T23:24:53.0Z",
        "updated_at": "1902-10-09T23:24:58.0Z"
      },
      "status": "expired",
      "source": "unknown",
      "payment_method": {
        "id": "aute ut aliquip velit qui",
        "type": "card",
        "last_4": "sunt",
        "status": "revoked",
        "card_brand": "amex"
      },
      "start_date": "1967-04-02T15:22:02.0Z",
      "end_date": "1918-03-18T08:39:15.0Z",
      "created_at": "1959-08-15T15:16:36.0Z",
      "basket_id": "693167497c381e01250000c5",
      "external_ref": "pariatur occaecat",
      "next_billing_date": "1958-09-19T21:57:30.0Z",
      "next_charge": {
        "id": "2f9b0b41-9c86-e1bc-794b-07dd2647334e",
        "amount": 3995,
        "currency": "GBP",
        "status": "processing",
        "billing_period_from": "1925-12-04",
        "billing_period_to": "1895-11-06"
      }
    },
    {
      "id": "88632d03-d046-3435-3471-5c1e6a0bbf55",
      "site_id": "d3dab198-00e4-3dc1-9108-d78549f9d2eb",
      "membership_number": "1234567890",
      "customer": {
        "id": "b8442c73-eaa3-1cdc-598a-69cb6f032717",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1938-05-07",
        "brand_id": "853a28fd-ff72-39ff-00d2-a6e01c354783",
        "site_id": "1f98e863-6f08-728a-d924-4e95c5cd89e7",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "6411c9cf-4e2d-9889-01a8-00ef81546811",
            "name": "VIP",
            "color": "ff6634"
          },
          {
            "id": "b991610c-8f4b-f2cc-ccef-3c64444e623d",
            "name": "VIP",
            "color": "ff6634"
          },
          {
            "id": "a9345a5a-0b96-cd59-224e-c7332971db13",
            "name": "VIP",
            "color": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1901-03-31T16:53:50.0Z",
        "created_at": "1916-09-11T15:31:56.0Z",
        "updated_at": "1956-01-04T13:54:20.0Z",
        "deleted_at": "1896-04-04T23:26:55.0Z",
        "last_active_at": "1935-12-08T09:28:20.0Z",
        "email_verified_at": "1944-07-26T09:20:52.0Z",
        "last_check_in": {
          "checked_in_at": "1931-11-21T19:31:23.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "94d6dc13-aa14-1aa6-0888-40ee2784a94f",
          "file_name": "super-cool-photo.jpg",
          "mime_type": "image/jpeg",
          "size": 84256,
          "url": "https://example.com/media/super-cool-photo.jpg"
        },
        "external_ref": "non mollit sit Lorem"
      },
      "members": [
        {
          "membership_number": "1234567890"
        }
      ],
      "type": {
        "id": "3ac10260-b7dc-9384-4ac9-47037a87d8c9",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "quis occaecat minim ut",
        "brand_id": "0fa02933-1762-b3b3-40fc-c7e12a191f02",
        "offline_payments": true,
        "disable_confirmation_email": false,
        "private": false,
        "visibility": "link_only",
        "minimum_start_date": "1944-07-24T08:22:51.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1954-12-17T14:10:08.0Z",
        "updated_at": "1909-08-23T07:11:07.0Z",
        "deleted_at": "1960-10-03T07:22:57.0Z"
      },
      "rate": {
        "id": "30931a2d-3f25-3d23-fe2e-0280d34a9af6",
        "membership_type_id": "39e022d3-9c50-2a01-6c60-fe2070b7b2bb",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "tax": 1250,
        "billing_frequency": "P1M",
        "processors": [],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1905-09-09T01:48:21.0Z",
        "updated_at": "1968-08-22T21:58:10.0Z"
      },
      "status": "needs_dd_mandate",
      "source": "import",
      "payment_method": {
        "id": "et nisi",
        "last_4": "nisi voluptate dolore sed ex"
      },
      "start_date": "1917-10-25T14:04:56.0Z",
      "end_date": "1920-08-08T06:09:39.0Z",
      "created_at": "1918-03-28T02:57:10.0Z",
      "basket_id": "693167497c381e01250000c6",
      "external_ref": "veniam qui commodo sit ut"
    }
  ],
  "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": "12e13a14-de02-e99f-75a8-1ee58fe98cd9",
    "site_id": "6c61bd59-8be7-edd7-a79d-f27d1e193ec5",
    "membership_number": "1234567890",
    "customer": {
      "id": "832ec45e-89e9-6ee9-a81a-77fe852332cf",
      "first_name": "Jane",
      "last_name": "Doe",
      "full_name": "Jane Doe",
      "phone": "+447900000000",
      "has_password": true,
      "dob": "1965-11-09",
      "brand_id": "31054b5c-9a81-08b0-21d7-6c4e6f31342d",
      "site_id": "415a8000-eb70-4e00-fa30-41d03e7eebee",
      "stripe_id": "cus_1234567890",
      "express_stripe_id": "cus_1234567890",
      "email": "janedoe@example.com",
      "labels": [
        {
          "id": "601f6ae6-80d5-3639-8caa-390236d14328",
          "name": "VIP",
          "color": "ff6634"
        },
        {
          "id": "e532afd6-7d2e-5c25-84f4-6d7eddd7af81",
          "name": "VIP",
          "color": "ff6634"
        },
        {
          "id": "a1749103-9b49-b2ba-5c8c-6619ade4c608",
          "name": "VIP",
          "color": "ff6634"
        }
      ],
      "preferred_locale": "en",
      "locked_at": "1946-01-23T01:13:55.0Z",
      "created_at": "1913-11-24T05:47:27.0Z",
      "updated_at": "1890-09-18T20:38:39.0Z",
      "deleted_at": "1897-10-09T07:44:13.0Z",
      "last_active_at": "1940-02-07T19:31:02.0Z",
      "email_verified_at": "1913-05-18T23:06:12.0Z",
      "last_check_in": {
        "checked_in_at": "1952-07-02T16:28:15.0Z",
        "method": "Scanned"
      },
      "avatar_id": "000000-000000-000000-000000",
      "avatar": {
        "id": "eff2efb4-07e3-c0fa-7e42-1940fe3bf747",
        "file_name": "super-cool-photo.jpg",
        "mime_type": "image/jpeg",
        "size": 84256,
        "url": "https://example.com/media/super-cool-photo.jpg"
      },
      "external_ref": "commodo"
    },
    "members": [
      {
        "is_lead": false
      }
    ],
    "type": {
      "id": "c6a9bb64-5cd4-4e31-143a-df549d79691e",
      "name": "Gold tier",
      "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
      "terms": "officia",
      "brand_id": "922cb315-f056-b788-8f5c-25124927765d",
      "offline_payments": false,
      "disable_confirmation_email": true,
      "private": false,
      "visibility": "private",
      "minimum_start_date": "1899-01-14T07:12:19.0Z",
      "min_members": 2,
      "max_members": 4,
      "rates": [
        {
          "id": "e885f709-4889-4262-040c-71844cd6df16",
          "membership_type_id": "f347e3b6-0009-7efd-d3db-146a4bb2a50e",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "processors": [
            "in labore cupidatat dolor"
          ]
        },
        {
          "membership_type_id": "fb5c0702-1c77-64ce-c061-977eeb5fa379",
          "price": 5000,
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1950-02-24T22:37:25.0Z",
          "updated_at": "1965-05-23T23:59:04.0Z"
        },
        {
          "id": "f2517291-9957-9d2f-fc70-e0d1515d51f3",
          "joining_fee": 1000,
          "tax": 1250,
          "billing_frequency": "P1M",
          "private": true,
          "updated_at": "1895-12-11T21:11:30.0Z"
        },
        {
          "id": "e8d622ea-4abe-5370-74c0-f54d2311c9db",
          "membership_type_id": "d92644cd-0fa8-0191-6cb9-e0d9e1f6af95",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "private": true
        },
        {
          "id": "8af10850-1126-d10f-c2ca-a5815054e742",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "tax": 1250,
          "created_at": "1904-03-16T09:27:20.0Z"
        }
      ],
      "revenue_schedule": "FREQ=WEEKLY",
      "created_at": "1903-08-11T12:49:17.0Z",
      "updated_at": "1901-01-06T19:45:32.0Z",
      "deleted_at": "1954-10-24T12:59:23.0Z"
    },
    "rate": {
      "id": "b8af50f4-fb41-1a7e-9676-eb0cdb41c021",
      "membership_type_id": "468a8f92-2368-76bb-d5d4-e271001e8570",
      "name": "Standard rate",
      "currency": "GBP",
      "price": 5000,
      "joining_fee": 1000,
      "tax": 1250,
      "billing_frequency": "P1M",
      "processors": [
        "dolore officia adipisicing"
      ],
      "default_duration": "P1Y",
      "private": true,
      "created_at": "1898-05-25T15:12:31.0Z"
    },
    "status": "expired",
    "source": "app",
    "payment_method": {
      "id": "dolore culpa amet labore in",
      "type": "direct_debit",
      "last_4": "anim in",
      "status": "revoked",
      "card_brand": "amex"
    },
    "start_date": "1896-11-06T17:04:57.0Z",
    "end_date": "1920-06-29T16:07:39.0Z",
    "created_at": "1964-02-16T17:17:35.0Z",
    "basket_id": "693167497c381e01250000c7",
    "external_ref": "Lorem qui dolor dolore veniam",
    "next_billing_date": "1897-03-17T02:09:17.0Z",
    "next_charge": {
      "id": "bef3fe18-953c-7f50-179e-e3000f4ba8b0",
      "amount": 3995,
      "currency": "GBP",
      "status": "succeeded",
      "billing_period_from": "1906-02-07",
      "billing_period_to": "1954-02-25"
    },
    "attention_reason": "setup_unpaid"
  }
}
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
    Required

    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": "9190def5-d450-bc61-47c9-3b3ab02dd442",
    "membership": {
      "id": "76300f9b-adab-ec86-e65d-463fb0d994f8",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "07874722-bbd3-fd10-f6c3-fb063e10b419",
      "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": "nulla aute aliquip",
    "can_download_receipt": false,
    "amount_refunded": "mollit proident Ut incididunt deserunt",
    "refunded": "amet officia",
    "refunds": [
      {
        "id": "ae380c3e-52e5-ac9a-beda-3d1616eeb4c0",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "cb74a8fb-e0b4-3588-7d55-aa744aaca6df",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1936-03-18T16:28:57.0Z",
        "updated_at": "1931-09-22T14:36:33.0Z"
      }
    ],
    "site_id": "67287d4c-4297-ec60-7e85-d619432ec575",
    "billing_period_from": "1916-12-11",
    "billing_period_to": "1895-11-03",
    "processing_at": "1969-02-21T03:01:49.0Z",
    "created_at": "1894-12-16T21:43:42.0Z",
    "updated_at": "1935-04-21T11:21:29.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": "5c1bd844-b9d3-e200-2c54-ace4053ff1ff",
    "membership": {
      "id": "fc29a8e9-7f36-5b22-d47b-4378d40e0d57",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "b1076b28-04dc-e3ae-b7f6-5321c9e22c3e",
      "customer_name": "Jane Jones"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones",
      "last_4": 4001,
      "processor_type_id": "693167497c381e01250000c8"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "mollit et esse adipisicing non",
    "can_download_receipt": true,
    "amount_refunded": "irure non reprehenderit",
    "refunded": "dolor anim Excepteur tempor aliqua",
    "refunds": [
      {
        "id": "95827ba8-2bc9-f6e0-963d-1fea72b4174c",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "refunded_by": {
          "id": "6dc161e4-5575-38f1-e769-00d8646a557e",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1927-12-16T18:33:40.0Z",
        "updated_at": "1913-04-05T04:12:26.0Z"
      },
      {
        "id": "b67a27c7-f172-47b1-b3b9-eb23e9b7ab6d",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "b1a1f554-e02a-fbf8-a23b-d4a2e177f37b",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1938-01-12T17:01:18.0Z",
        "updated_at": "1905-11-14T08:59:35.0Z"
      }
    ],
    "site_id": "732f7996-2bb7-4604-b5fa-12c54836d733",
    "billing_period_from": "1919-10-23",
    "billing_period_to": "1964-08-09",
    "processing_at": "1896-04-07T01:21:37.0Z",
    "created_at": "1905-08-29T04:14:31.0Z",
    "updated_at": "1961-03-11T18:56:29.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": "fb712f37-2e12-70c5-3183-aa8575855651",
    "membership": {
      "id": "ea6296ee-d704-5ac9-1fcc-602319146535",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "745c1f62-af2a-a469-7ef2-b3953c0b490b",
      "customer_name": "Jane Jones"
    },
    "processor": "adyen",
    "processor_data": {
      "last_4": 4001,
      "processor_type": "Cash"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "in",
    "can_download_receipt": true,
    "amount_refunded": "nostrud",
    "refunded": "occaecat",
    "refunds": [
      {
        "id": "a72d2a27-25cd-7842-57ae-1c9f1db082b9",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "be00f09d-1a7d-66ee-478b-2b5da5992763",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1906-09-15T22:29:38.0Z",
        "updated_at": "1958-09-14T21:26:15.0Z"
      },
      {
        "id": "82b5b338-872c-dd27-5043-578c6c5130e2",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "793a3cf1-1a9f-ce76-a1f7-33a2f308295d",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1955-07-01T07:05:25.0Z",
        "updated_at": "1893-02-14T11:40:36.0Z"
      },
      {
        "id": "a84a0e5c-0e91-d405-cad5-c226215273f8",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "99d909e1-9f47-4b4f-0393-93c75aa0862c",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1890-12-15T12:19:20.0Z",
        "updated_at": "1947-05-08T12:04:01.0Z"
      },
      {
        "id": "91863e38-60f3-2fbd-8f63-3d012315a13e",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "1855685d-cafe-713d-136e-0443aaaf536a",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1958-05-06T16:26:42.0Z",
        "updated_at": "1950-10-12T03:39:20.0Z"
      },
      {
        "id": "ba5e277e-0cb7-92c0-f3d4-ae42a2c17262",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "07097756-8fd8-779b-52da-6451bfc56076",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1941-12-31T05:54:10.0Z",
        "updated_at": "1941-02-10T06:14:26.0Z"
      }
    ],
    "site_id": "79342a3a-8fa2-858c-0826-477909632d15",
    "billing_period_from": "1930-04-02",
    "billing_period_to": "1944-06-11",
    "processing_at": "1949-04-14T10:50:36.0Z",
    "created_at": "1897-04-16T06:31:43.0Z",
    "updated_at": "1910-01-08T11:08:45.0Z"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}