LoyaltyApi (Square 20.0.0.20220512 API)

All Known Implementing Classes:

DefaultLoyaltyApi
```
public interface LoyaltyApi
```
This interface lists all the endpoints of the group. This can be overridden for the mock calls.

Method Summary

All Methods Instance Methods Abstract Methods Deprecated Methods
Modifier and Type	Method and Description
`AccumulateLoyaltyPointsResponse`	`accumulateLoyaltyPoints(String accountId, AccumulateLoyaltyPointsRequest body)` Adds points to a loyalty account.
`CompletableFuture<AccumulateLoyaltyPointsResponse>`	`accumulateLoyaltyPointsAsync(String accountId, AccumulateLoyaltyPointsRequest body)` Adds points to a loyalty account.
`AdjustLoyaltyPointsResponse`	`adjustLoyaltyPoints(String accountId, AdjustLoyaltyPointsRequest body)` Adds points to or subtracts points from a buyer's account.
`CompletableFuture<AdjustLoyaltyPointsResponse>`	`adjustLoyaltyPointsAsync(String accountId, AdjustLoyaltyPointsRequest body)` Adds points to or subtracts points from a buyer's account.
`CalculateLoyaltyPointsResponse`	`calculateLoyaltyPoints(String programId, CalculateLoyaltyPointsRequest body)` Calculates the points a purchase earns.
`CompletableFuture<CalculateLoyaltyPointsResponse>`	`calculateLoyaltyPointsAsync(String programId, CalculateLoyaltyPointsRequest body)` Calculates the points a purchase earns.
`CreateLoyaltyAccountResponse`	`createLoyaltyAccount(CreateLoyaltyAccountRequest body)` Creates a loyalty account.
`CompletableFuture<CreateLoyaltyAccountResponse>`	`createLoyaltyAccountAsync(CreateLoyaltyAccountRequest body)` Creates a loyalty account.
`CreateLoyaltyRewardResponse`	`createLoyaltyReward(CreateLoyaltyRewardRequest body)` Creates a loyalty reward.
`CompletableFuture<CreateLoyaltyRewardResponse>`	`createLoyaltyRewardAsync(CreateLoyaltyRewardRequest body)` Creates a loyalty reward.
`DeleteLoyaltyRewardResponse`	`deleteLoyaltyReward(String rewardId)` Deletes a loyalty reward by doing the following: - Returns the loyalty points back to the loyalty account.
`CompletableFuture<DeleteLoyaltyRewardResponse>`	`deleteLoyaltyRewardAsync(String rewardId)` Deletes a loyalty reward by doing the following: - Returns the loyalty points back to the loyalty account.
`ListLoyaltyProgramsResponse`	`listLoyaltyPrograms()` Deprecated.
`CompletableFuture<ListLoyaltyProgramsResponse>`	`listLoyaltyProgramsAsync()` Deprecated.
`RedeemLoyaltyRewardResponse`	`redeemLoyaltyReward(String rewardId, RedeemLoyaltyRewardRequest body)` Redeems a loyalty reward.
`CompletableFuture<RedeemLoyaltyRewardResponse>`	`redeemLoyaltyRewardAsync(String rewardId, RedeemLoyaltyRewardRequest body)` Redeems a loyalty reward.
`RetrieveLoyaltyAccountResponse`	`retrieveLoyaltyAccount(String accountId)` Retrieves a loyalty account.
`CompletableFuture<RetrieveLoyaltyAccountResponse>`	`retrieveLoyaltyAccountAsync(String accountId)` Retrieves a loyalty account.
`RetrieveLoyaltyProgramResponse`	`retrieveLoyaltyProgram(String programId)` Retrieves the loyalty program in a seller's account, specified by the program ID or the keyword `main`.
`CompletableFuture<RetrieveLoyaltyProgramResponse>`	`retrieveLoyaltyProgramAsync(String programId)` Retrieves the loyalty program in a seller's account, specified by the program ID or the keyword `main`.
`RetrieveLoyaltyRewardResponse`	`retrieveLoyaltyReward(String rewardId)` Retrieves a loyalty reward.
`CompletableFuture<RetrieveLoyaltyRewardResponse>`	`retrieveLoyaltyRewardAsync(String rewardId)` Retrieves a loyalty reward.
`SearchLoyaltyAccountsResponse`	`searchLoyaltyAccounts(SearchLoyaltyAccountsRequest body)` Searches for loyalty accounts in a loyalty program.
`CompletableFuture<SearchLoyaltyAccountsResponse>`	`searchLoyaltyAccountsAsync(SearchLoyaltyAccountsRequest body)` Searches for loyalty accounts in a loyalty program.
`SearchLoyaltyEventsResponse`	`searchLoyaltyEvents(SearchLoyaltyEventsRequest body)` Searches for loyalty events.
`CompletableFuture<SearchLoyaltyEventsResponse>`	`searchLoyaltyEventsAsync(SearchLoyaltyEventsRequest body)` Searches for loyalty events.
`SearchLoyaltyRewardsResponse`	`searchLoyaltyRewards(SearchLoyaltyRewardsRequest body)` Searches for loyalty rewards.
`CompletableFuture<SearchLoyaltyRewardsResponse>`	`searchLoyaltyRewardsAsync(SearchLoyaltyRewardsRequest body)` Searches for loyalty rewards.

- Method Detail
  - createLoyaltyAccount
```
CreateLoyaltyAccountResponse createLoyaltyAccount(CreateLoyaltyAccountRequest body)
                                           throws ApiException,
                                                  IOException
```
    Creates a loyalty account. To create a loyalty account, you must provide the `program_id` and a `mapping` with the `phone_number` of the buyer.
    
    Parameters:
    
    body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.
    
    Returns:
    
    Returns the CreateLoyaltyAccountResponse response from the API call
    
    Throws:
    
    ApiException - Represents error response from the server.
    
    IOException - Signals that an I/O exception of some sort has occurred.
  - createLoyaltyAccountAsync
```
CompletableFuture<CreateLoyaltyAccountResponse> createLoyaltyAccountAsync(CreateLoyaltyAccountRequest body)
```
    Creates a loyalty account. To create a loyalty account, you must provide the `program_id` and a `mapping` with the `phone_number` of the buyer.
    
    Parameters:
    
    body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.
    
    Returns:
    
    Returns the CreateLoyaltyAccountResponse response from the API call
  - searchLoyaltyAccounts
```
SearchLoyaltyAccountsResponse searchLoyaltyAccounts(SearchLoyaltyAccountsRequest body)
                                             throws ApiException,
                                                    IOException
```
    Searches for loyalty accounts in a loyalty program. You can search for a loyalty account using the phone number or customer ID associated with the account. To return all loyalty accounts, specify an empty `query` object or omit it entirely. Search results are sorted by `created_at` in ascending order.
    
    Parameters:
    
    body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.
    
    Returns:
    
    Returns the SearchLoyaltyAccountsResponse response from the API call
    
    Throws:
    
    ApiException - Represents error response from the server.
    
    IOException - Signals that an I/O exception of some sort has occurred.
  - searchLoyaltyAccountsAsync
```
CompletableFuture<SearchLoyaltyAccountsResponse> searchLoyaltyAccountsAsync(SearchLoyaltyAccountsRequest body)
```
    Searches for loyalty accounts in a loyalty program. You can search for a loyalty account using the phone number or customer ID associated with the account. To return all loyalty accounts, specify an empty `query` object or omit it entirely. Search results are sorted by `created_at` in ascending order.
    
    Parameters:
    
    body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.
    
    Returns:
    
    Returns the SearchLoyaltyAccountsResponse response from the API call
  - retrieveLoyaltyAccount
```
RetrieveLoyaltyAccountResponse retrieveLoyaltyAccount(String accountId)
                                               throws ApiException,
                                                      IOException
```
    Retrieves a loyalty account.
    
    Parameters:
    
    accountId - Required parameter: The ID of the [loyalty account]($m/LoyaltyAccount) to retrieve.
    
    Returns:
    
    Returns the RetrieveLoyaltyAccountResponse response from the API call
    
    Throws:
    
    ApiException - Represents error response from the server.
    
    IOException - Signals that an I/O exception of some sort has occurred.
  - retrieveLoyaltyAccountAsync
```
CompletableFuture<RetrieveLoyaltyAccountResponse> retrieveLoyaltyAccountAsync(String accountId)
```
    Retrieves a loyalty account.
    
    Parameters:
    
    accountId - Required parameter: The ID of the [loyalty account]($m/LoyaltyAccount) to retrieve.
    
    Returns:
    
    Returns the RetrieveLoyaltyAccountResponse response from the API call
  - accumulateLoyaltyPoints
```
AccumulateLoyaltyPointsResponse accumulateLoyaltyPoints(String accountId,
                                                        AccumulateLoyaltyPointsRequest body)
                                                 throws ApiException,
                                                        IOException
```
    Adds points to a loyalty account. - If you are using the Orders API to manage orders, you only provide the `order_id`. The endpoint reads the order to compute points to add to the buyer's account. - If you are not using the Orders API to manage orders, you first perform a client-side computation to compute the points. For spend-based and visit-based programs, you can first call [CalculateLoyaltyPoints]($e/Loyalty/CalculateLoyaltyPoints) to compute the points that you provide to this endpoint.
    
    Parameters:
    
    accountId - Required parameter: The [loyalty account]($m/LoyaltyAccount) ID to which to add the points.
    
    body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.
    
    Returns:
    
    Returns the AccumulateLoyaltyPointsResponse response from the API call
    
    Throws:
    
    ApiException - Represents error response from the server.
    
    IOException - Signals that an I/O exception of some sort has occurred.
  - accumulateLoyaltyPointsAsync
```
CompletableFuture<AccumulateLoyaltyPointsResponse> accumulateLoyaltyPointsAsync(String accountId,
                                                                                AccumulateLoyaltyPointsRequest body)
```
    Adds points to a loyalty account. - If you are using the Orders API to manage orders, you only provide the `order_id`. The endpoint reads the order to compute points to add to the buyer's account. - If you are not using the Orders API to manage orders, you first perform a client-side computation to compute the points. For spend-based and visit-based programs, you can first call [CalculateLoyaltyPoints]($e/Loyalty/CalculateLoyaltyPoints) to compute the points that you provide to this endpoint.
    
    Parameters:
    
    accountId - Required parameter: The [loyalty account]($m/LoyaltyAccount) ID to which to add the points.
    
    body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.
    
    Returns:
    
    Returns the AccumulateLoyaltyPointsResponse response from the API call
  - adjustLoyaltyPoints
```
AdjustLoyaltyPointsResponse adjustLoyaltyPoints(String accountId,
                                                AdjustLoyaltyPointsRequest body)
                                         throws ApiException,
                                                IOException
```
    Adds points to or subtracts points from a buyer's account. Use this endpoint only when you need to manually adjust points. Otherwise, in your application flow, you call [AccumulateLoyaltyPoints]($e/Loyalty/AccumulateLoyaltyPoints) to add points when a buyer pays for the purchase.
    
    Parameters:
    
    accountId - Required parameter: The ID of the [loyalty account]($m/LoyaltyAccount) in which to adjust the points.
    
    body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.
    
    Returns:
    
    Returns the AdjustLoyaltyPointsResponse response from the API call
    
    Throws:
    
    ApiException - Represents error response from the server.
    
    IOException - Signals that an I/O exception of some sort has occurred.
  - adjustLoyaltyPointsAsync
```
CompletableFuture<AdjustLoyaltyPointsResponse> adjustLoyaltyPointsAsync(String accountId,
                                                                        AdjustLoyaltyPointsRequest body)
```
    Adds points to or subtracts points from a buyer's account. Use this endpoint only when you need to manually adjust points. Otherwise, in your application flow, you call [AccumulateLoyaltyPoints]($e/Loyalty/AccumulateLoyaltyPoints) to add points when a buyer pays for the purchase.
    
    Parameters:
    
    accountId - Required parameter: The ID of the [loyalty account]($m/LoyaltyAccount) in which to adjust the points.
    
    body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.
    
    Returns:
    
    Returns the AdjustLoyaltyPointsResponse response from the API call
  - searchLoyaltyEvents
```
SearchLoyaltyEventsResponse searchLoyaltyEvents(SearchLoyaltyEventsRequest body)
                                         throws ApiException,
                                                IOException
```
    Searches for loyalty events. A Square loyalty program maintains a ledger of events that occur during the lifetime of a buyer's loyalty account. Each change in the point balance (for example, points earned, points redeemed, and points expired) is recorded in the ledger. Using this endpoint, you can search the ledger for events. Search results are sorted by `created_at` in descending order.
    
    Parameters:
    
    body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.
    
    Returns:
    
    Returns the SearchLoyaltyEventsResponse response from the API call
    
    Throws:
    
    ApiException - Represents error response from the server.
    
    IOException - Signals that an I/O exception of some sort has occurred.
  - searchLoyaltyEventsAsync
```
CompletableFuture<SearchLoyaltyEventsResponse> searchLoyaltyEventsAsync(SearchLoyaltyEventsRequest body)
```
    Searches for loyalty events. A Square loyalty program maintains a ledger of events that occur during the lifetime of a buyer's loyalty account. Each change in the point balance (for example, points earned, points redeemed, and points expired) is recorded in the ledger. Using this endpoint, you can search the ledger for events. Search results are sorted by `created_at` in descending order.
    
    Parameters:
    
    body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.
    
    Returns:
    
    Returns the SearchLoyaltyEventsResponse response from the API call
  - listLoyaltyPrograms
```
@Deprecated
ListLoyaltyProgramsResponse listLoyaltyPrograms()
                                                     throws ApiException,
                                                            IOException
```
    Deprecated.
    
    Returns a list of loyalty programs in the seller's account. Loyalty programs define how buyers can earn points and redeem points for rewards. Square sellers can have only one loyalty program, which is created and managed from the Seller Dashboard. For more information, see [Loyalty Program Overview](https://developer.squareup.com/docs/loyalty/overview). Replaced with [RetrieveLoyaltyProgram]($e/Loyalty/RetrieveLoyaltyProgram) when used with the keyword `main`.
    
    Returns:
    
    Returns the ListLoyaltyProgramsResponse response from the API call
    
    Throws:
    
    ApiException - Represents error response from the server.
    
    IOException - Signals that an I/O exception of some sort has occurred.
  - listLoyaltyProgramsAsync
```
@Deprecated
CompletableFuture<ListLoyaltyProgramsResponse> listLoyaltyProgramsAsync()
```
    Deprecated.
    
    Returns a list of loyalty programs in the seller's account. Loyalty programs define how buyers can earn points and redeem points for rewards. Square sellers can have only one loyalty program, which is created and managed from the Seller Dashboard. For more information, see [Loyalty Program Overview](https://developer.squareup.com/docs/loyalty/overview). Replaced with [RetrieveLoyaltyProgram]($e/Loyalty/RetrieveLoyaltyProgram) when used with the keyword `main`.
    
    Returns:
    
    Returns the ListLoyaltyProgramsResponse response from the API call
  - retrieveLoyaltyProgram
```
RetrieveLoyaltyProgramResponse retrieveLoyaltyProgram(String programId)
                                               throws ApiException,
                                                      IOException
```
    Retrieves the loyalty program in a seller's account, specified by the program ID or the keyword `main`. Loyalty programs define how buyers can earn points and redeem points for rewards. Square sellers can have only one loyalty program, which is created and managed from the Seller Dashboard. For more information, see [Loyalty Program Overview](https://developer.squareup.com/docs/loyalty/overview).
    
    Parameters:
    
    programId - Required parameter: The ID of the loyalty program or the keyword `main`. Either value can be used to retrieve the single loyalty program that belongs to the seller.
    
    Returns:
    
    Returns the RetrieveLoyaltyProgramResponse response from the API call
    
    Throws:
    
    ApiException - Represents error response from the server.
    
    IOException - Signals that an I/O exception of some sort has occurred.
  - retrieveLoyaltyProgramAsync
```
CompletableFuture<RetrieveLoyaltyProgramResponse> retrieveLoyaltyProgramAsync(String programId)
```
    Retrieves the loyalty program in a seller's account, specified by the program ID or the keyword `main`. Loyalty programs define how buyers can earn points and redeem points for rewards. Square sellers can have only one loyalty program, which is created and managed from the Seller Dashboard. For more information, see [Loyalty Program Overview](https://developer.squareup.com/docs/loyalty/overview).
    
    Parameters:
    
    programId - Required parameter: The ID of the loyalty program or the keyword `main`. Either value can be used to retrieve the single loyalty program that belongs to the seller.
    
    Returns:
    
    Returns the RetrieveLoyaltyProgramResponse response from the API call
  - calculateLoyaltyPoints
```
CalculateLoyaltyPointsResponse calculateLoyaltyPoints(String programId,
                                                      CalculateLoyaltyPointsRequest body)
                                               throws ApiException,
                                                      IOException
```
    Calculates the points a purchase earns. - If you are using the Orders API to manage orders, you provide the `order_id` in the request. The endpoint calculates the points by reading the order. - If you are not using the Orders API to manage orders, you provide the purchase amount in the request for the endpoint to calculate the points. An application might call this endpoint to show the points that a buyer can earn with the specific purchase. For spend-based and visit-based programs, the `tax_mode` setting of the accrual rule indicates how taxes should be treated for loyalty points accrual.
    
    Parameters:
    
    programId - Required parameter: The [loyalty program]($m/LoyaltyProgram) ID, which defines the rules for accruing points.
    
    body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.
    
    Returns:
    
    Returns the CalculateLoyaltyPointsResponse response from the API call
    
    Throws:
    
    ApiException - Represents error response from the server.
    
    IOException - Signals that an I/O exception of some sort has occurred.
  - calculateLoyaltyPointsAsync
```
CompletableFuture<CalculateLoyaltyPointsResponse> calculateLoyaltyPointsAsync(String programId,
                                                                              CalculateLoyaltyPointsRequest body)
```
    Calculates the points a purchase earns. - If you are using the Orders API to manage orders, you provide the `order_id` in the request. The endpoint calculates the points by reading the order. - If you are not using the Orders API to manage orders, you provide the purchase amount in the request for the endpoint to calculate the points. An application might call this endpoint to show the points that a buyer can earn with the specific purchase. For spend-based and visit-based programs, the `tax_mode` setting of the accrual rule indicates how taxes should be treated for loyalty points accrual.
    
    Parameters:
    
    programId - Required parameter: The [loyalty program]($m/LoyaltyProgram) ID, which defines the rules for accruing points.
    
    body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.
    
    Returns:
    
    Returns the CalculateLoyaltyPointsResponse response from the API call
  - createLoyaltyReward
```
CreateLoyaltyRewardResponse createLoyaltyReward(CreateLoyaltyRewardRequest body)
                                         throws ApiException,
                                                IOException
```
    Creates a loyalty reward. In the process, the endpoint does following: - Uses the `reward_tier_id` in the request to determine the number of points to lock for this reward. - If the request includes `order_id`, it adds the reward and related discount to the order. After a reward is created, the points are locked and not available for the buyer to redeem another reward.
    
    Parameters:
    
    body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.
    
    Returns:
    
    Returns the CreateLoyaltyRewardResponse response from the API call
    
    Throws:
    
    ApiException - Represents error response from the server.
    
    IOException - Signals that an I/O exception of some sort has occurred.
  - createLoyaltyRewardAsync
```
CompletableFuture<CreateLoyaltyRewardResponse> createLoyaltyRewardAsync(CreateLoyaltyRewardRequest body)
```
    Creates a loyalty reward. In the process, the endpoint does following: - Uses the `reward_tier_id` in the request to determine the number of points to lock for this reward. - If the request includes `order_id`, it adds the reward and related discount to the order. After a reward is created, the points are locked and not available for the buyer to redeem another reward.
    
    Parameters:
    
    body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.
    
    Returns:
    
    Returns the CreateLoyaltyRewardResponse response from the API call
  - searchLoyaltyRewards
```
SearchLoyaltyRewardsResponse searchLoyaltyRewards(SearchLoyaltyRewardsRequest body)
                                           throws ApiException,
                                                  IOException
```
    Searches for loyalty rewards. This endpoint accepts a request with no query filters and returns results for all loyalty accounts. If you include a `query` object, `loyalty_account_id` is required and `status` is optional. If you know a reward ID, use the [RetrieveLoyaltyReward]($e/Loyalty/RetrieveLoyaltyReward) endpoint. Search results are sorted by `updated_at` in descending order.
    
    Parameters:
    
    body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.
    
    Returns:
    
    Returns the SearchLoyaltyRewardsResponse response from the API call
    
    Throws:
    
    ApiException - Represents error response from the server.
    
    IOException - Signals that an I/O exception of some sort has occurred.
  - searchLoyaltyRewardsAsync
```
CompletableFuture<SearchLoyaltyRewardsResponse> searchLoyaltyRewardsAsync(SearchLoyaltyRewardsRequest body)
```
    Searches for loyalty rewards. This endpoint accepts a request with no query filters and returns results for all loyalty accounts. If you include a `query` object, `loyalty_account_id` is required and `status` is optional. If you know a reward ID, use the [RetrieveLoyaltyReward]($e/Loyalty/RetrieveLoyaltyReward) endpoint. Search results are sorted by `updated_at` in descending order.
    
    Parameters:
    
    body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.
    
    Returns:
    
    Returns the SearchLoyaltyRewardsResponse response from the API call
  - deleteLoyaltyReward
```
DeleteLoyaltyRewardResponse deleteLoyaltyReward(String rewardId)
                                         throws ApiException,
                                                IOException
```
    Deletes a loyalty reward by doing the following: - Returns the loyalty points back to the loyalty account. - If an order ID was specified when the reward was created (see [CreateLoyaltyReward]($e/Loyalty/CreateLoyaltyReward)), it updates the order by removing the reward and related discounts. You cannot delete a reward that has reached the terminal state (REDEEMED).
    
    Parameters:
    
    rewardId - Required parameter: The ID of the [loyalty reward]($m/LoyaltyReward) to delete.
    
    Returns:
    
    Returns the DeleteLoyaltyRewardResponse response from the API call
    
    Throws:
    
    ApiException - Represents error response from the server.
    
    IOException - Signals that an I/O exception of some sort has occurred.
  - deleteLoyaltyRewardAsync
```
CompletableFuture<DeleteLoyaltyRewardResponse> deleteLoyaltyRewardAsync(String rewardId)
```
    Deletes a loyalty reward by doing the following: - Returns the loyalty points back to the loyalty account. - If an order ID was specified when the reward was created (see [CreateLoyaltyReward]($e/Loyalty/CreateLoyaltyReward)), it updates the order by removing the reward and related discounts. You cannot delete a reward that has reached the terminal state (REDEEMED).
    
    Parameters:
    
    rewardId - Required parameter: The ID of the [loyalty reward]($m/LoyaltyReward) to delete.
    
    Returns:
    
    Returns the DeleteLoyaltyRewardResponse response from the API call
  - retrieveLoyaltyReward
```
RetrieveLoyaltyRewardResponse retrieveLoyaltyReward(String rewardId)
                                             throws ApiException,
                                                    IOException
```
    Retrieves a loyalty reward.
    
    Parameters:
    
    rewardId - Required parameter: The ID of the [loyalty reward]($m/LoyaltyReward) to retrieve.
    
    Returns:
    
    Returns the RetrieveLoyaltyRewardResponse response from the API call
    
    Throws:
    
    ApiException - Represents error response from the server.
    
    IOException - Signals that an I/O exception of some sort has occurred.
  - retrieveLoyaltyRewardAsync
```
CompletableFuture<RetrieveLoyaltyRewardResponse> retrieveLoyaltyRewardAsync(String rewardId)
```
    Retrieves a loyalty reward.
    
    Parameters:
    
    rewardId - Required parameter: The ID of the [loyalty reward]($m/LoyaltyReward) to retrieve.
    
    Returns:
    
    Returns the RetrieveLoyaltyRewardResponse response from the API call
  - redeemLoyaltyReward
```
RedeemLoyaltyRewardResponse redeemLoyaltyReward(String rewardId,
                                                RedeemLoyaltyRewardRequest body)
                                         throws ApiException,
                                                IOException
```
    Redeems a loyalty reward. The endpoint sets the reward to the `REDEEMED` terminal state. If you are using your own order processing system (not using the Orders API), you call this endpoint after the buyer paid for the purchase. After the reward reaches the terminal state, it cannot be deleted. In other words, points used for the reward cannot be returned to the account.
    
    Parameters:
    
    rewardId - Required parameter: The ID of the [loyalty reward]($m/LoyaltyReward) to redeem.
    
    body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.
    
    Returns:
    
    Returns the RedeemLoyaltyRewardResponse response from the API call
    
    Throws:
    
    ApiException - Represents error response from the server.
    
    IOException - Signals that an I/O exception of some sort has occurred.
  - redeemLoyaltyRewardAsync
```
CompletableFuture<RedeemLoyaltyRewardResponse> redeemLoyaltyRewardAsync(String rewardId,
                                                                        RedeemLoyaltyRewardRequest body)
```
    Redeems a loyalty reward. The endpoint sets the reward to the `REDEEMED` terminal state. If you are using your own order processing system (not using the Orders API), you call this endpoint after the buyer paid for the purchase. After the reward reaches the terminal state, it cannot be deleted. In other words, points used for the reward cannot be returned to the account.
    
    Parameters:
    
    rewardId - Required parameter: The ID of the [loyalty reward]($m/LoyaltyReward) to redeem.
    
    body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.
    
    Returns:
    
    Returns the RedeemLoyaltyRewardResponse response from the API call

Interface LoyaltyApi

Method Summary

Method Detail

createLoyaltyAccount

createLoyaltyAccountAsync

searchLoyaltyAccounts

searchLoyaltyAccountsAsync

retrieveLoyaltyAccount

retrieveLoyaltyAccountAsync

accumulateLoyaltyPoints

accumulateLoyaltyPointsAsync

adjustLoyaltyPoints

adjustLoyaltyPointsAsync

searchLoyaltyEvents

searchLoyaltyEventsAsync

listLoyaltyPrograms

listLoyaltyProgramsAsync

retrieveLoyaltyProgram

retrieveLoyaltyProgramAsync

calculateLoyaltyPoints

calculateLoyaltyPointsAsync

createLoyaltyReward

createLoyaltyRewardAsync

searchLoyaltyRewards

searchLoyaltyRewardsAsync

deleteLoyaltyReward

deleteLoyaltyRewardAsync

retrieveLoyaltyReward

retrieveLoyaltyRewardAsync

redeemLoyaltyReward

redeemLoyaltyRewardAsync