Loyalty Management Developer Guide

Loyalty Management Standard Objects
Loyalty Management Fields on Standard Objects
Coupon Objects in Loyalty Management
Loyalty Management Associated Objects
Apex Reference
Loyalty Management Business APIs
REST Reference
Resources
Request Bodies
Cart Input
Account Identifier Input
Contact Identifier Input
Enrollment Details Input
Enrollment Input
Offer Identifier Input
Promotion Identifier Input
Cart Input Map
Channel Input
Clone Promotion Input
Club Member Enrollment Input
Club Membership Renewal Input
Corporate Member Enrollment Input
Coupon Usage Input
Eligible Clubs Input
Eligible Coupon Input
Eligible Enrollment Period Input
Eligible Loyalty Tiers Input
Events Detail Input
Individual Member Enrollment Input
Link Program Member Partner Input
Loyalty Engine Input
Loyalty Engine Input Map
Loyalty Engine Run Settings Input
Loyalty Account Input
Loyalty Contact Input
Loyalty Process Input
Loyalty Process Input Options
Loyalty Process Parameter Map Input
Loyalty View Transaction Journal History Input
Name and ID Input
Product Details
Promotion Eligible Channel Input
Promotion Eligibility Input
Promotion Input
Promotion Limit Input
Promotion Recommendation Input
Redeem Voucher Input
Related Promotion Records Input
Unified Promotions Input
Unified Promotion Template Input
Unlink Program Member Partner Input
Promotion Reward Application Input
Response Bodies
Loyalty Management Connect API Interchangeable Request Fields
Loyalty Management Standard Invocable Actions
Loyalty Management Custom Invocable Actions
Loyalty Management Metadata API Types
Loyalty Management Tooling API Objects
Loyalty Management Mobile SDK
Gamification Mobile SDK
Data Processing Engine, Batch Management, and Monitor Workflow Services
StandardValueSet Names and Standard Picklist Fields for Loyalty Management
PDF

Cart Input

The details of a cart and its line items that's used to evaluate and execute promotions.
JSON example
1{
2  "cart": {
3    "cartDetails": [
4      {
5        "cartHeaderId__std": "01ddf0000003kfMAAW",
6        "activityStartDate": "2023-06-14T12:45:19Z",
7        "contactId/contactEmail/contactLastName/loyaltyProgramMemberId/membershipNumber/accountId": "003xx000004WjzAAAS",
8        "transactionAmount": 110,
9        "currencyISOCode": "USD",
10        "engagementChannelId": "0eFxx0000000008EAA",
11        "sourceLocationId/sourceLocation": "0YQxx0000000001GAA",
12        "cartPromotionAdditionalInformation__std": [
13          {
14            "cartCouponCode__std": "CART5"
15          }
16        ],
17        "cartLineDetails": [
18          {
19            "cartLineProductId": "01txx0000006kfMAAQ",
20            "cartLineItemQuantity": 2,
21            "cartLineItemAmount": 100,
22            "cartLineItemId": "abcd1",
23            "cartLineNetUnitPrice__std": 50,
24            "cartLinePromotionAdditionalInformation__std": [
25              {
26                "cartLineCouponCode__std": "PIZZA5"
27              }
28            ]
29          },
30          {
31            "cartLineProductId": "01txx0000006kfNAAQ",
32            "cartLineItemQuantity": 2,
33            "cartLineItemAmount": 10,
34            "cartLineItemId": "abcd2",
35            "cartLineNetUnitPrice__std": 5
36          }
37        ]
38      }
39    ]
40  }
41}
Properties
Name Type Description Required or Optional Available Version
cart Map<String, Object> Details of a cart and its line items used to evaluate and execute promotions.

The payload must include cartHeaderId__std, which uniquely identifies the cart and is required for promotion evaluation and execution.

Specify the applicable currencyISOCode for the transaction.

To evaluate or execute coupon-based promotions, include the couponCode, which must match an active coupon or promotion configured in the system.

Along with the required parameters, provide cart-level details such as the total transaction amount, and cart line item details such as line item quantity and amount, cartLineNetUnitPrice__std (required for evaluation of line-level and cross-line promotions), and product ID.

 Required 65.0