Loyalty memberships
Last updated
Was this helpful?
Last updated
Was this helpful?
Returns all loyalty memberships of the enterprise, optionally filtered by specific loyalty membership identifiers, activity states, or other filter parameters. Note this operation uses and supports .
[PlatformAddress]/api/connector/v1/loyaltyMemberships/getAll
ClientToken
string
required
Token identifying the client application.
AccessToken
string
required
Access token of the client application.
Client
string
required
Name and version of the client application.
ChainIds
array of string
optional, max 1000 items
Unique identifiers of the chain. If not specified, the operation returns data for all chains within scope of the Access Token.
CreatedUtc
optional, max length 3 months
The time interval during which the membership was created.
UpdatedUtc
optional, max length 3 months
The time interval during which the membership was last updated.
LoyaltyMembershipIds
array of string
optional, max 1000 items
AccountIds
array of string
optional, max 1000 items
LoyaltyProgramIds
array of string
optional, max 1000 items
MembershipStates
optional
States of the loyalty memberships.
ActivityStates
optional
Whether to return only active, only deleted or both records.
Codes
array of string
optional, max 1000 items
List of loyalty membership codes, such as identification numbers printed on loyalty cards visible to the customer.
ProviderMembershipIds
array of string
optional, max 1000 items
List of unique loyalty membership identifiers assigned and managed by the external loyalty provider's system.
Limitation
required
Limitation on the quantity of data returned.
LoyaltyMemberships
required
The loyalty memberships of the enterprise.
Cursor
string
optional
Unique identifier of the item one newer in time order than the items to be returned. If Cursor is not specified, i.e. null, then the latest or most recent items will be returned.
Id
string
required
Unique identifier of the loyalty membership.
ChainId
string
required
Unique identifier of the chain.
AccountId
string
required
Unique identifier of the account.
LoyaltyProgramId
string
required
Unique identifier of the loyalty program.
State
required
State of the loyalty membership.
IsPrimary
boolean
required
Defines the primary loyalty membership.
ProviderMembershipId
string
optional
Unique identifier for the loyalty membership in the loyalty provider's system.
Code
string
optional
Code of the loyalty membership.
Points
integer
optional
The loyalty points for the account in that membership.
ExpirationDate
string
optional
Expiration date of the loyalty membership in UTC timezone in ISO 8601 format.
Url
string
optional
Url of the loyalty membership.
LoyaltyTierId
string
optional
Unique identifier of the loyalty tier.
CreatorProfile
required
The profile data of the user who created or last updated the record.
UpdaterProfile
required
The profile data of the user who created or last updated the record.
New
Pending
Enrolled
Canceled
Declined
[PlatformAddress]/api/connector/v1/loyaltyMemberships/add
ClientToken
string
required
Token identifying the client application.
AccessToken
string
required
Access token of the client application.
Client
string
required
Name and version of the client application.
ChainId
string
optional
LoyaltyMemberships
required, max 1000 items
Loyalty memberships to be added.
AccountId
string
required
Unique identifier of the customer account.
LoyaltyProgramId
string
required
Unique identifier of the loyalty program.
IsPrimary
boolean
required
Defines the primary loyalty membership for the account.
State
optional
State of the loyalty membership. The default is Enrolled
.
Code
string
optional, max length 255 characters
Loyalty membership code, such as an identification number printed on a loyalty card visible to the customer.
Points
integer
optional
The loyalty points for the account in that membership.
ExpirationDate
string
optional
Expiration date of the loyalty membership in UTC timezone in ISO 8601 format.
Url
string
optional
URL of the loyalty membership in external loyalty system.
LoyaltyTierId
string
optional
Unique identifier of the loyalty tier.
LoyaltyMemberships
required
The loyalty memberships of the enterprise.
Cursor
string
optional
Unique identifier of the item one newer in time order than the items to be returned. If Cursor is not specified, i.e. null, then the latest or most recent items will be returned.
[PlatformAddress]/api/connector/v1/loyaltyMemberships/update
ClientToken
string
required
Token identifying the client application.
AccessToken
string
required
Access token of the client application.
Client
string
required
Name and version of the client application.
ChainId
string
optional
LoyaltyMembershipUpdates
required, max 1000 items
Loyalty memberships to be updated.
LoyaltyMembershipId
string
required
Unique identifier of the loyalty membership.
LoyaltyProgramId
optional
Unique identifier of the loyalty program (or null
if the program should not be updated).
State
optional
State of the loyalty membership, (or null
if the state should not be updated).
IsPrimary
optional
Boolean value defining the primary loyalty membership for the account (or null
if the value should not be updated).
Code
optional
Code of the loyalty membership. (or null
if the code should not be updated).
Points
optional
The loyalty points the account has in the loyalty membership (or null
if the points should not be updated).
ExpirationDate
optional
Expiration date of the loyalty membership in UTC timezone in ISO 8601 format (or null
if the date should not be updated).
Url
optional
URL of the loyalty membership (or null
if the URL should not be updated).
LoyaltyTierId
optional
Unique identifier of the loyalty tier (or null
if the tier should not be updated).
Value
required
Value which is to be updated.
LoyaltyMemberships
required
The loyalty memberships of the enterprise.
Cursor
string
optional
Unique identifier of the item one newer in time order than the items to be returned. If Cursor is not specified, i.e. null, then the latest or most recent items will be returned.
Deletes loyalty memberships.
[PlatformAddress]/api/connector/v1/loyaltyMemberships/delete
ClientToken
string
required
Token identifying the client application.
AccessToken
string
required
Access token of the client application.
Client
string
required
Name and version of the client application.
LoyaltyMembershipIds
array of string
required, max 1000 items
Unique identifier of the loyalty memberships to be deleted.
Unique identifiers of .
Unique identifiers of accounts (for example or ) the membership is associated with.
Unique identifiers of .
array of
array of
array of
Adds loyalty memberships to the enterprise. Note this operation supports .
Unique identifier of the chain. Required when using , ignored otherwise.
array of
array of
Updates information about the specified loyalty memberships. Note this operation supports .
Unique identifier of the chain. Required when using , ignored otherwise.
array of
array of