LoyaltyAPIManager | Loyalty Management Developer Guide

Use this signature to define the LoyaltyAPIManager class.

1public final class LoyaltyAPIManager

Method Summary

Modifier and Type	Definition	Description
`final Result<EnrollmentResponse>`	final Result<EnrollmentResponse> postEnrollment(String firstName, String lastName, String email, Map<String, Object> additionalContactAttributes, Boolean emailNotification, MemberStatus memberStatus, Boolean createTransactionJournals, TransactionalJournalStatementFrequency transactionalJournalStatementFrequency, TransactionalJournalStatementMethod transactionalJournalStatementMethod, EnrollmentChannel enrollmentChannel, Boolean canReceivePromotions, Boolean canReceivePartnerPromotions)	Creates an individual enrollment for the loyalty program.
`final Result<MemberBenefitsResponse>`	`getMemberBenefits(String memberId, String membershipNumber)`	Retrieves benefits related to the member ID.
`final Result<MemberProfileResponse>`	`getMemberProfile(String memberId, String memberShipNumber, String programCurrencyName)`	Retrieves profile details related to the member ID.
`final Result<TransactionsResponse>`	`getTransactions(String membershipNumber, Integer pageNumber, String journalTypeName, String journalSubTypeName, String periodStartDate, String periodEndDate)`	Retrieves transactions related to the member. Makes an asynchronous request for transaction history from Salesforce APIs.
`final Result<PromotionsResponse>`	`getEligiblePromotions(String membershipNumber, String memberId)`	Retrieves promotions that a promotion is eligible to enroll for.
`final Result<EnrollPromotionsResponse>`	`enrollInPromotions(String membershipNumber, String promotionName)`	Enrolls member in a promotion.
`final Result<UnenrollPromotionResponse>`	`unEnrollPromotion(String membershipNumber, String promotionName)`	Opts out a member from an available promotion.
`final Result<VoucherResult>`	`getVouchers(String membershipNumber, Array<String> voucherStatus, Integer pageNumber, Array<String> productId, Array<String> productCategoryId, Array<String> productName, Array<String> productCategoryName)`	Retrieves vouchers are available to the program member.

enrollInPromotions Method

Enroll a loyalty member to a promotion, while asynchronously sending data to the Enroll for Promotions API. Use this code to enroll a member.

1final Result<EnrollPromotionsResponse> enrollInPromotions(String membershipNumber, String promotionName)

Parameter	Type	Description	Required or Optional
`memberShipNumber`	String	The membership number of the loyalty program member.	Required
promotionName	String	The promotion name the member is being enrolled to

getEligiblePromotions Method

Get promotions that a member is eligible to enroll for. Use this code to get eligible promotions.

1final Result<PromotionsResponse> getEligiblePromotions(String membershipNumber, String memberId)

Parameter	Type	Description	Required or Optional
`memberId`	Boolean	The identifier of the member whose eligible promotions are being retrieved.	Optional
`memberShipNumber`	String	The membership number of the loyalty program member.	Required

getMemberBenefits Method

Retrieve the benefits associated with a loyalty program member for the specified API version, while asynchronously requesting data from the Member Benefits API. Use this code to get member benefits.

1final Result<MemberBenefitsResponse> getMemberBenefits(String memberId, String membershipNumber)

Parameter	Type	Description	Required or Optional
`memberId`	Boolean	Identifier of the member whose benefits are being retrieved.	Optional
`memberShipNumber`	String	The membership number of the loyalty program member.	Required

getMemberProfile Method

Get the profile details of a loyalty program member by using this code.

1final Result<MemberProfileResponse> getMemberProfile(String memberId, String memberShipNumber, String programCurrencyName)

Parameter	Type	Description	Required or Optional
`memberId`	Boolean	Identifier of the member whose profile is being retrieved.	Optional
`memberShipNumber`	String	The membership number of the loyalty program member.	Required
`programCurrencyName`	String	The name of the loyalty program currency associated with the member.	Optional

getTransactions Method

Get transaction journals of a loyalty member. Obtain either accrual or redemption transaction journal records. Use this code to get transactions.

final Result<MemberBenefitsResponse> getMemberBenefits(String memberId, String membershipNumber)

Parameter	Type	Description	Required or Optional
`journalSubTypeName`	String	The subtype of the transaction journal record.	Optional
`journalTypeName`	String	The type of the transaction journal record. Possible values are: `Accrual` `Redemption`	Optional
`pageNumber`	Integer	The page number to be returned. If you don’t specify a value, the first page is returned. Each page contains 200 transactions, sorted by their date of creation.	Optional
`memberShipNumber`	String	The membership number of the loyalty program member.	Required
`periodStartDate`	String	Retrieve transaction journals starting on this date.	Optional
`periodEndDate`	String	Retrieve transaction journals until this date.	Optional

getVouchers Method

Retrieve the vouchers issued to a loyalty member by using this code.

1final Result<VoucherResult> getVouchers(String membershipNumber, Array<String> voucherStatus, Integer pageNumber, Array<String> productId, Array<String> productCategoryId, Array<String> productName, Array<String> productCategoryName)

This table shows the parameters in the getVouchers method.

Parameter	Description
`membershipNumber`	Membership number of the member whose vouchers are being retrieved.
`voucherStatus`	The status of a voucher.
`pageNumber`	Number of the page you want returned. If you don’t specify a value, the first page is returned. By default, each page contains 200 vouchers, which are sorted based on the voucher creation date.
`productId`	The ID of the product related to the vouchers that you want to retrieve. You can specify the ID of up to 20 products.
`productCategoryId`	The ID of the product categories related to the vouchers that you want to retrieve. You can specify the ID of up to 20 product categories.
`productName`	The product name related to the voucher.
`productCategoryName`	The name of the product categories related to the vouchers that you want to retrieve. You can specify the ID of up to 20 product category names.

postEnrollment Method

Enroll a member to a loyalty program, while asynchronously sending data to the Individual Member Enrollments API. Use this code to enroll a member.

1final Result<EnrollmentResponse> postEnrollment(String firstName, String lastName, String email, Map<String, Object> additionalContactAttributes, Boolean emailNotification, MemberStatus memberStatus, Boolean createTransactionJournals, TransactionalJournalStatementFrequency transactionalJournalStatementFrequency, TransactionalJournalStatementMethod transactionalJournalStatementMethod, EnrollmentChannel enrollmentChannel, Boolean canReceivePromotions, Boolean canReceivePartnerPromotions)

This table shows the parameters in the postEnrollment method.

Parameter	Description
additionalContactAttributes	The person account record details of the individual type member.
canReceivePartnerPromotions	Indicates whether the member can receive partner promotions for the program (`true`) or not (`false`).
canReceivePromotions	Indicates whether the loyalty program member can receive promotions.
createTransactionJournals	Indicates whether to create the transaction journal records `true`) or not (`false`).
`email`	The email address of the member being enrolled.
`emailNotification`	Indicates whether the member wants to receive email notifications.
enrollmentChannel	The channel used to by loyalty program members to enroll in to the loyalty program. Possible values are: `Pos` `Web` `Email` `CallCenter` `Social` `Mobile` `Store` `Franchise` `Partner` `Print`
`firstName`	The first name of the member being enrolled.
`lastName`	The last name of the member being enrolled.
`memberStatus`	The status of the loyalty program member. Possible values are: `Active` `Inactive` `Custom`
`transactionalJournalStatementFrequency`	The frequency at which transaction journal statements must be delivered to the member. Possible values are: `Monthly` `Quarterly`
`transactionalJournalStatementMethod`	The method used to deliver transaction journal statements to the member. Possible values are: `Mail` `Email`

unEnrollPromotion Method

Opt out a loyalty member from a promotion. Use this code to opt out of a promotion.

1final Result<UnenrollPromotionResponse> unEnrollPromotion(String membershipNumber, String promotionName)

Parameter	Type	Description	Required or Optional
`memberShipNumber`	String	Unique identifier of the member who wants to opt out of a promotion	Required
promotionName	String	Name of the promotion that the member wants to opt out of.	Required