# Personalize Benefits source: https://developer.mastercard.com/mastercard-benefits-and-experiences-portal/documentation/use-cases/use-cases-2/index.md ## Benefit Selection Sequence {#benefit-selection-sequence} This API allows to select benefits available to the cardholder. The cardholder can select benefits from the list of selectable benefits available. API Reference: `GET /benefit-selections` The following sequence diagram shows the sequence of API calls between the different entities in this scenario. Diagram use-case-2 Note: Benefit selection is only permitted once per selection window or once per cycle. The selection window automatically adjusts to the next window when the selections are posted for the first time. Please advise your card holders that once selections are posted, they will not be able to change the selections for that cycle and will only be able to change the selections when the next cycle opens. ## Sample Request and Response {#sample-request-and-response} Use your own `partnerId` to make test calls to Sandbox API endpoints. ### Post the list of benefits selected by the cardholder in the "selectedBenefits" object. {#post-the-list-of-benefits-selected-by-the-cardholder-in-the-selectedbenefits-object} Make a POST call with two benefits with productIds from the sample response in the [Search Benefits](https://developer.mastercard.com/mastercard-benefits-and-experiences-portal/documentation/use-cases/use-cases-1/index.md) use case, passing the same `partnerUUID` and `segmentCode` as in the call to `/searches`: `POST https://sandbox.api.mastercard.com/the-portal/benefit-selections` ```json { "payment": { "creditCard": { "cardHolderName": "John Doe", "cardNumber": 5437873451234563, "expirationMonth": 1, "expirationYear": 2023, "cvv": "535" } }, "countryCode": "US", "firstName": "John", "lastName": "Doe", "partnerUUID": "DGH234", "segmentCode": "Black", "preferredLanguageCode": "en-US", "emailAddress": "mastercard@priceless.com", "partnerId": 659, "selectedBenefits": [ { "productId": 175477 }, { "productId": 175485 } ] } ``` ```json { "msg": "OK", "data": { "partnerUUID": "DGH234", "segmentCode": "Black", "selectionWindow": { "startDate": "2023-03-23", "endDate": "2023-04-21", "registrationDate": "2022-04-22" }, "emailAddress": "mastercard@priceless.com", "canMakeSelections": false, "numberOfRequiredSelections": 0, "initialSelection": false, "products": { "fixedBenefits": [ { "id": 175541, "name": "Enjoy your set of Black Benefits", "description": "Available for marketing text providing the Issuer an opportunity to sell the benefits of the consumers card", "longDescription": "", "price": 0, "locale": "en_US", "categories": [ { "id": 1717, "name": "Concierge" } ], "currencyCode": "USD", "displayName": "Enjoy your set of Black Benefits", "primaryCategory": { "id": 1717, "name": "Concierge" }, "benefitBundleId": "8ab8d236-d285-4176-b937-e5bcf60d50f3", "formattedPrice": "US$0", "childData": [ { "id": 175469, "name": "IDTheft ", "description": "Rest assured that Mastercard will cover your eligible expenses should your digital identification be compromised.", "longDescription": "Long Description BI", "faqPDF": "https:\/\/d5xydlzdo08s0.cloudfront.net\/media\/celebrities\/17194\/products\/008cd7c267d842c891f50c598c5fe227.pdf", "termsPDF": "https:\/\/d5xydlzdo08s0.cloudfront.net\/media\/celebrities\/17194\/products\/9159cd8adb6443bf941e77d08aac61b5.pdf", "privacyPDF": "https:\/\/d5xydlzdo08s0.cloudfront.net\/media\/celebrities\/17194\/products\/e8f05bc03de14002a0a67e2e5d379502.pdf", "displayName": "IDTheft ", "primaryCategory": { "id": 1717, "name": "Concierge" }, "benefitInstanceId": "d08fe95e-b644-455d-95a1-7409f0f6b6fa", "displayWidgets": [], "imageURL": "https:\/\/d5xydlzdo08s0.cloudfront.net\/media\/celebrities\/17194\/products\/fd7ad0ebf8ba43eeb80961e965fe49ba__L.jpeg" } ], "imageURL": "https:\/\/d5xydlzdo08s0.cloudfront.net\/media\/celebrities\/17194\/products\/fdf84fee05b045eda7d9fd17d1e36fb3__L.jpeg", "additionalBenefitSelectionFields": [] } ], "selectableBenefits": [], "tieredBenefits": [], "selectedBenefits": [ { "id": 175477, "name": "Door Dash DN ", "description": "Discover local, on-demand delivery or Pickup from restaurants, nearby grocery and convenience stores, and more", "longDescription": "", "price": 0, "locale": "en_US", "categories": [ { "id": 1717, "name": "Concierge" } ], "currencyCode": "USD", "displayName": "Door Dash (DN)", "primaryCategory": { "id": 1717, "name": "Concierge" }, "benefitBundleId": "48a6aa54-82a6-45c5-b8d3-e4e8dc540639", "formattedPrice": "US$0", "childData": [ { "id": 175457, "name": "bundle description", "description": "bundle description This is the shorter description of the Door Dash benefit that only needs to be used as a brief into to the service. STOP", "longDescription": "bundle description Long Descripton for Door Dash is Lorem ipsum dolor sit amet, consectetur adipiscing elit. Etiam eu lacus a eros eleifend sagittis. In vestibulum, felis aliquet sodales iaculis, felis ex mollis velit, pulvinar viverra massa ante sit amet diam. Donec vestibulum iaculis purus sit amet suscipit. Proin tempor libero non iaculis molestie. Aliquam nec eros vitae purus semper molestie sit amet at nibh. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Phasellus neque mauris, placerat et turpis eu, sagittis mattis orci. Proin luctus velit ligula. Pellentesque vehicula massa et ligula malesuada commodo. In sagittis massa sed metus faucibus molestie. In quis metus vel justo vehicula tincidunt non at erat. Vestibulum feugiat orci in orci laoreet blandit \nVestibulum at est est. Etiam pulvinar tortor at porta suscipit. In diam elit, aliquet cursus posuere ut, dignissim a nisl. Vivamus lorem tellus, commodo et ullamcorper id, accumsan vitae nisl. Aenean purus nibh, feugiat id mauris ac, auctor vestibulum est. Nam fermentum eu dolor posuere scelerisque. Donec ac sem ac turpis cursus sodales quis ac leo. Aenean id arcu eget purus sagittis fermentum sit amet id neque. Fusce at mauris rhoncus, pharetra tortor ac, pretium metus. Nulla nec ullamcorper mauris. Ut elementum, nunc in vestibulum placerat, nibh augue facilisis libero, vel auctor magna nibh ullamcorper lectus. Quisque gravida tincidunt nibh ut lobortis. Proin iaculis fringilla metus, sed laoreet nulla viverra vel.\nAliquam augue velit, scelerisque vel sem in, facilisis convallis neque. Vivamus a mauris id quam eleifend pharetra sit amet in felis. Proin et tincidunt nisl. Aliquam molestie erat nec augue condimentum, eget condimentum nibh laoreet. Nulla sit amet auctor nunc, nec varius enim. Proin congue mi quis viverra fermentum. Vivamus vehicula, lectus eu auctor rutrum, justo elit dapibus nunc, convallis feugiat metus erat in nibh. Phasellus vitae arcu eu arcu aliquet euismod vestibulum quis neque. Nam lacus nisi, mollis non lectus at, pharetra maximus libero. Sed molestie ipsum sit amet elementum lobortis. Suspendisse vitae justo auctor, ornare sapien hendrerit, mattis mi. Phasellus id turpis massa. Donec tincidunt nisi eu purus pharetra aliquet. Nulla condimentum dictum vulputate. Morbi fermentum vehicula dignissim. Donec eu accumsan est.\nUt nibh dui, mattis et tortor a, euismod laoreet nibh. Quisque ullamcorper massa id tincidunt auctor. Quisque lobortis porttitor magna, ut hendrerit dui placerat non. In eu rutrum diam, a dapibus libero. Maecenas id arcu tellus. Praesent aliquam molestie metus, quis efficitur est. Sed id purus eleifend, lobortis ipsum at, volutpat nisl. In hac habitasse platea dictumst. Pellentesque venenatis libero mi, vel varius nisl fringilla ut. Etiam non eros nisl. Duis euismod turpis in est malesuada dignissim.\nSuspendisse sollicitudin, tortor vel elementum porttitor, ligula nibh porttitor lectus, non sodales felis quam vitae orci. Quisque enim lectus, rutrum eget porttitor non, varius et lacus. Quisque elementum lorem bibendum, pulvinar nisl in, tincidunt sapien. Sed magna risus, ultrices nec eros dictum, pulvinar faucibus nisl. Vivamus nisl sapien, finibus eget laoreet fringilla, lobortis non neque. Sed commodo egestas neque in venenatis. Mauris at sollicitudin dolor. Aenean faucibus interdum eros, fermentum egestas elit blandit a\nProin velit lorem, faucibus sit amet erat ut, ultricies ullamcorper lorem. Maecenas aliquam vehicula suscipit. Etiam pretium libero a velit", "faqPDF": "https:\/\/d5xydlzdo08s0.cloudfront.net\/media\/celebrities\/17194\/products\/d9ac8b5baab0458aaea5b5d7a85c29c2.pdf", "termsPDF": "https:\/\/d5xydlzdo08s0.cloudfront.net\/media\/celebrities\/17194\/products\/c3bc960918744160bb8040e078ae4010.pdf", "privacyPDF": "https:\/\/d5xydlzdo08s0.cloudfront.net\/media\/celebrities\/17194\/products\/425b7748e05a423383a201150ac423c2.pdf", "displayName": "bundle description", "primaryCategory": { "id": 1717, "name": "Concierge" }, "benefitInstanceId": "2564e121-4acf-46fc-8d04-b775654f678d", "displayWidgets": [], "imageURL": "https:\/\/d5xydlzdo08s0.cloudfront.net\/media\/celebrities\/17194\/products\/927e1ffe71dc4f71bb665a7e73b47620__L.jpg" } ], "imageURL": "https:\/\/d5xydlzdo08s0.cloudfront.net\/media\/celebrities\/17194\/products\/426146bb438f44e5a6254feeb8117cf9__L.jpg", "additionalBenefitSelectionFields": [] }, { "id": 175485, "name": "Fandango DN ", "description": "Buy movie tickets in advance, and more at Fandango with your Mastercard.", "longDescription": "", "price": 0, "locale": "en_US", "categories": [ { "id": 1717, "name": "Concierge" } ], "currencyCode": "USD", "displayName": "Fandango (DN)", "primaryCategory": { "id": 1717, "name": "Concierge" }, "benefitBundleId": "61e32b9c-f818-4b0b-a466-58ad313bebd6", "formattedPrice": "US$0", "childData": [ { "id": 175405, "name": "Fandango DN ", "description": "This is the shorter description of the Fandango benefit that only needs to be used as a brief into to the service. STOP", "longDescription": "Long Descripton for Fandango is Lorem ipsum dolor sit amet, consectetur adipiscing elit. Etiam eu lacus a eros eleifend sagittis. In vestibulum, felis aliquet sodales iaculis, felis ex mollis velit, pulvinar viverra massa ante sit amet diam. Donec vestibulum iaculis purus sit amet suscipit. Proin tempor libero non iaculis molestie. Aliquam nec eros vitae purus semper molestie sit amet at nibh. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Phasellus neque mauris, placerat et turpis eu, sagittis mattis orci. Proin luctus velit ligula. Pellentesque vehicula massa et ligula malesuada commodo. In sagittis massa sed metus faucibus molestie. In quis metus vel justo vehicula tincidunt non at erat. Vestibulum feugiat orci in orci laoreet blandit \nVestibulum at est est. Etiam pulvinar tortor at porta suscipit. In diam elit, aliquet cursus posuere ut, dignissim a nisl. Vivamus lorem tellus, commodo et ullamcorper id, accumsan vitae nisl. Aenean purus nibh, feugiat id mauris ac, auctor vestibulum est. Nam fermentum eu dolor posuere scelerisque. Donec ac sem ac turpis cursus sodales quis ac leo. Aenean id arcu eget purus sagittis fermentum sit amet id neque. Fusce at mauris rhoncus, pharetra tortor ac, pretium metus. Nulla nec ullamcorper mauris. Ut elementum, nunc in vestibulum placerat, nibh augue facilisis libero, vel auctor magna nibh ullamcorper lectus. Quisque gravida tincidunt nibh ut lobortis. Proin iaculis fringilla metus, sed laoreet nulla viverra vel.\nAliquam augue velit, scelerisque vel sem in, facilisis convallis neque. Vivamus a mauris id quam eleifend pharetra sit amet in felis. Proin et tincidunt nisl. Aliquam molestie erat nec augue condimentum, eget condimentum nibh laoreet. Nulla sit amet auctor nunc, nec varius enim. Proin congue mi quis viverra fermentum. Vivamus vehicula, lectus eu auctor rutrum, justo elit dapibus nunc, convallis feugiat metus erat in nibh. Phasellus vitae arcu eu arcu aliquet euismod vestibulum quis neque. Nam lacus nisi, mollis non lectus at, pharetra maximus libero. Sed molestie ipsum sit amet elementum lobortis. Suspendisse vitae justo auctor, ornare sapien hendrerit, mattis mi. Phasellus id turpis massa. Donec tincidunt nisi eu purus pharetra aliquet. Nulla condimentum dictum vulputate. Morbi fermentum vehicula dignissim. Donec eu accumsan est.\nUt nibh dui, mattis et tortor a, euismod laoreet nibh. Quisque ullamcorper massa id tincidunt auctor. Quisque lobortis porttitor magna, ut hendrerit dui placerat non. In eu rutrum diam, a dapibus libero. Maecenas id arcu tellus. Praesent aliquam molestie metus, quis efficitur est. Sed id purus eleifend, lobortis ipsum at, volutpat nisl. In hac habitasse platea dictumst. Pellentesque venenatis libero mi, vel varius nisl fringilla ut. Etiam non eros nisl. Duis euismod turpis in est malesuada dignissim.\nSuspendisse sollicitudin, tortor vel elementum porttitor, ligula nibh porttitor lectus, non sodales felis quam vitae orci. Quisque enim lectus, rutrum eget porttitor non, varius et lacus. Quisque elementum lorem bibendum, pulvinar nisl in, tincidunt sapien. Sed magna risus, ultrices nec eros dictum, pulvinar faucibus nisl. Vivamus nisl sapien, finibus eget laoreet fringilla, lobortis non neque. Sed commodo egestas neque in venenatis. Mauris at sollicitudin dolor. Aenean faucibus interdum eros, fermentum egestas elit blandit a\nProin velit lorem, faucibus sit amet erat ut, ultricies ullamcorper lorem. Maecenas aliquam vehicula suscipit. Etiam pretium libero a velit", "faqPDF": "https:\/\/d5xydlzdo08s0.cloudfront.net\/media\/celebrities\/17194\/products\/48c3a776251b400abaa0beb92ad830d4.pdf", "termsPDF": "https:\/\/d5xydlzdo08s0.cloudfront.net\/media\/celebrities\/17194\/products\/2001d82c53ec46d7b42f6b10e2c5adcc.pdf", "privacyPDF": "https:\/\/d5xydlzdo08s0.cloudfront.net\/media\/celebrities\/17194\/products\/4a043bd7d445434a9d5f73ff460a5a25.pdf", "displayName": "Fandango (DN)", "primaryCategory": { "id": 1717, "name": "Concierge" }, "benefitInstanceId": "2f8f5cb8-8863-46ed-b06a-235d1be38b3c", "displayWidgets": [], "imageURL": "https:\/\/d5xydlzdo08s0.cloudfront.net\/media\/celebrities\/17194\/products\/9eb286c6cb65939db3d7abfa255cd9d8__L.jpg" } ], "imageURL": "https:\/\/d5xydlzdo08s0.cloudfront.net\/media\/celebrities\/17194\/products\/8da597e25e4144d8bd0702ae58304bbe__L.jpg", "additionalBenefitSelectionFields": [] } ], "futureSelectedBenefits": [] }, "orderId": 83649 } } ``` The `orderId` at the end indicates that the benefits have been personalized (selected) successfully.