Get member's wallet details

GET /api/members/{memberId}/wallet/gladstonepay

Success: 200 OK

• Products: Operator (FOH), Consumer (CONSUMER) (any one of these products, not all)
• Features: Online Bookings (ONLINEBOOK), Online Joining (ONLINEJOIN), Front of House Generic Access (FOHGENERIC) (any one of these features, not all)

Overview

Lists every payment card held in a member's wallet at the payment provider.

Gladstone does not store card details itself. It links each member to a single wallet held by GladstonePay — Gladstone's integration with the CardStream payment gateway — and this endpoint fetches that wallet's cards from the provider. Every call goes out to the provider and asks for a freshly refreshed view rather than a stored copy, so treat it as a network round trip, not a cheap lookup.

Reach for it when you want to show a member their saved cards, and when you need the cardID values that the rest of the wallet API is defined in terms of: the id you pass to DELETE /api/members/{memberId}/wallet/gladstonepay/{cardId}, and the id you compare with rcpCardId from GET /api/members/{memberId}/rcp-card to work out which stored card is used for recurring payments.

The response body is the payment provider's own payload, passed through unchanged. The provider's wallet-cards response comes back with the same field names — no renaming, no filtering, no validation, no defaults. Gladstone holds no documentation for most of those fields, which is why most rows in the response table below are left blank rather than guessed at. None of the identifiers in the payload are Gladstone identifiers; they are the provider's own, and only cardID means anything to another Gladstone endpoint.

Treat every card entry as cardholder data. In particular, Gladstone does not document what number, token and mask actually contain for a given provider account — a masked number, a full number, or a provider token. Do not log them, do not persist them, and do not build a display or a comparison on an assumption about their contents until you have confirmed it against your own provider account and your PCI DSS scope.

What this endpoint does not do: it does not create a wallet — a member has no wallet until their first card is saved through POST /api/members/{memberId}/wallet/card, and until then this returns 404. It does not tell you which card is designated for recurring payments; that designation is held by Gladstone rather than by the provider, so neither data[].default nor the rtus… fields answer it and GET /api/members/{memberId}/rcp-card does. It accepts no paging, filtering or sorting parameters. And if a member somehow has more than one wallet linked, only the first one is used.

Endpoint

GET {base_url}/api/members/{memberId}/wallet/gladstonepay

{base_url} is the environment URL issued to your integration. See Authenticating with Gladstone APIs.

Path parameters

Sample request

curl -X GET '{base_url}/api/members/{memberId}/wallet/gladstonepay' \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'X-Use-SSO: true'

Response fields

Sample response

{
  "success": "string",
  "id": "string",
  "data": [
    {
      "id": 12345,
      "pid": 12345,
      "type": "string",
      "ptype": "string",
      "uri": "string",
      "puri": "string",
      "path": "string",
      "text": "string",
      "cardID": 12345,
      "cardUri": "string",
      "cardName": "string",
      "walletID": 12345,
      "walletUri": "string",
      "walletName": "string",
      "customerID": 12345,
      "customerUri": "string",
      "customerName": "string",
      "resellerID": 12345,
      "resellerUri": "string",
      "resellerName": "string",
      "description": "string",
      "typeCode": "string",
      "typeName": "string",
      "holder": "string",
      "number": "string",
      "token": "string",
      "mask": "string",
      "expiryDate": "string",
      "startDate": "string",
      "issueNumber": "string",
      "duplicatesAllowed": "string",
      "data": "string",
      "default": "string",
      "transactionID": 12345,
      "transactionUri": "string",
      "supersededByCardID": 12345,
      "supersededByCardUri": "string",
      "rtusEnabled": "string",
      "rtusLastDate": "string",
      "rtusNextDate": "string",
      "rtusFrequency": 1,
      "rtusMerchantID": 12345,
      "rtusPolicyRef": "string",
      "rtusMerchantUri": "string",
      "rtusMerchantName": "string",
      "rtusUpdated": "string",
      "rtusAcquirerResponseCode": "string",
      "rtusSchemeResponseCode": "string",
      "rtusResponseCode": 1,
      "rtusResponseMessage": "string",
      "rtusState": "string",
      "rtusFileID": 12345,
      "rtusFileUri": "string",
      "billingAddressID": 12345,
      "billingAddressUri": "string",
      "billingAddressName": "string",
      "createdByUserID": 12345,
      "createdByUserUri": "string",
      "createdByUserName": "string",
      "updatedByUserID": 12345,
      "updatedByUserUri": "string",
      "updatedByUserName": "string",
      "createTime": "string",
      "modifyTime": "string",
      "status": "string",
      "perm": 1
    }
  ],
  "count": 1,
  "total": 1,
  "message": "string"
}

Errors

This page as markdown · All pages · llms.txt