Change membership balance

Request

Modifies the remaining visit count for a subscription (membership).

For unified balance subscriptions:

Use united_balance_services_count to set total visits

For separate balance subscriptions:

Use services_balance_count array with service_id and balance for each service/category

Use cases:

Adjust balance after administrative changes
Correct errors in visit counts
Add bonus visits

Note: Requires chain-level permissions.

Security

BearerPartnerUser

Path

chain_idintegerrequired

Chain ID

Example:706028

membership_idintegerrequired

Membership ID

Example:123

Acceptstringrequired

Default:"application/vnd.api.v2+json"

Content-Typestringrequired

Default:"application/json"

Authorizationstringrequired

Bearer {partner_token}, User {user_token}

Bodyapplication/jsonrequired

united_balance_services_countinteger

New visit count for unified balance subscriptions

Example:10

services_balance_countArray of objects

New balance for separate balance subscriptions (per service/category)

Example:

[
  {
    "service_id": 13160808,
    "balance": 5
  },
  {
    "service_id": 13160809,
    "balance": 3
  }
]

curl -i -X POST \
  https://developer.alteg.io/_mock/en/b2b-v1/openapi/chains/706028/loyalty/abonements/123/set_balance \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "united_balance_services_count": 10,
    "services_balance_count": [
      {
        "service_id": 13160808,
        "balance": 5
      },
      {
        "service_id": 13160809,
        "balance": 3
      }
    ]
  }'

Responses

Balance updated successfully

Bodyapplication/json

successboolean

Example:true

dataobject

metaArray of any

Example:

[]

Response

{
  "success": true,
  "data": {
    "id": 123,
    "united_balance_services_count": 10,
    "balance_container": {}
  },
  "meta": []
}