Sign in

v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Mastercard benefits

Replace card segment and benefits

Replaces the segment and existing benefits with a new benefit set assigned via a new segment code. The existing benefits are cancelled, and new benefits are assigned. An array of newly-assigned bundles is returned in the response.

This endpoint generates a Cards benefits allocation updated event.

Note: This is a PCI endpoint, use the https://gw-pci.pismolabs.io environment.

put/pcicards/v1/pcicards/benefits/segments/replace

Request body

card_idinteger required

ID of card to create relationship for

old_segment_codestring required

Old segment code

new_segment_codestring required

New segment code

effective_datestring required

Card effective date. Format = yyyy-mm-dd

Example request

{
  "card_id": 6743052,
  "old_segment_code": "LAC_BBC",
  "new_segment_code": "LAC_BBD",
  "effective_date": "2025-07-31"
}

Response

Success

network_correlation_idstring

Network correlation ID

Example response

{
  "bundles": [
    {
      "code": "LAC_BBC",
      "effective_date": "2025-07-31",
      "expiry_date": "2026-01-20"
    }
  ],
  "network_correlation_id": "fe1bf855f651810629107cfbce5b09d2"
}