Sign in

v1

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

Replace user card number

Replaces user card number associated. The old card benefits are cancelled, and the same benefit set is applied to the new card.

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/cards/replace

Headers

x-customer-idinteger required

Pismo customer ID

Request body

old_card_idinteger required

Pismo old card ID

new_card_idinteger required

Pismo new card ID

effective_datestring required

Card effective date. Format = yyyy-mm-dd

Example request

{
  "old_card_id": 123456,
  "new_card_id": 987654,
  "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"
}