v1
latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MBMastercard benefits
Assign card segment
Assigns segment to a card. An array of bundles are then assigned to the card.
A Mastercard card segment is a specific cardholder grouping (e.g., premium, business, or travel-focused) that issuers use to allocate tailored benefit bundles such as travel insurance, concierge services, or concierge access to particular cards. These segments allow for personalized, dynamic, and targeted rewards assigned to cardholders via API.
A Mastercard card segment bundle is a targeted package of benefits, rewards, or services assigned to specific carholder groups based on need.
This endpoint generates a Cards benefits allocation updated event.
Note: This is a PCI endpoint, use the https://gw-pci.pismolabs.io environment.
post/pcicards/v1/pcicards/benefits/segments/assign
Request body
Example request
{
"card_id": 6743052,
"segments": [
{
"code": "LAC_BBC",
"effective_date": "2025-07-31"
}
]
}Response
Success
Example response
{
"bundles": [
{
"code": "LAC_BBC",
"effective_date": "2025-07-31",
"expiry_date": "2026-01-20"
}
],
"network_correlation_id": "fe1bf855f651810629107cfbce5b09d2"
}