# Replace Bundles
source: https://developer.mastercard.com/benefit-allocation-service-mtls/documentation/use-cases/bundle-operations/replace_bundles/index.md

#### Overview {#overview}

**Actors:** Issuer developer, Mastercard Global Benefits Platform  

**Preconditions:** The old bundle is currently assigned to the card; the new bundle is pre-configured for the ICA; the effective date is today or a future date (past dates are not allowed)  

**Outcome:** The old bundle is expired the day before the effective date; the new bundle is assigned from the effective date  

**Endpoint:** `PUT /card-bundles-replacements` --- use this endpoint to swap one active bundle for a different one; use [Update Bundles](https://developer.mastercard.com/benefit-allocation-service-mtls/documentation/use-cases/bundle-operations/update_bundles/index.md) if you only need to change the dates without changing the bundle code

Replaces the existing benefit bundles with the new set of benefits bundles by taking a card number, an array of bundles with old bundle code, new bundle code and effective date in the input. The existing benefit bundles are expired, and new benefit bundles are assigned with the effective date. The response is an array of bundles that are newly assigned to the card. The benefit allocation replace bundle service can
Diagram replace_bundles
API Reference: `PUT /card-bundles-replacements`

### Use Case 1: replace bundle associated with a card {#use-case-1-replace-bundle-associated-with-a-card}

1. Cardholder requests a new benefit be associated with their card.
2. Issuer sends a request with a card number, old bundle code, new bundle code and effective date as an input parameter
3. Benefit Allocation Service API returns the benefit bundle codes assigned during replace with effective and expiration dates.

### Use Case 2: replace bundle code that has a bundle with future effective date {#use-case-2-replace-bundle-code-that-has-a-bundle-with-future-effective-date}

1. Cardholder requests a new benefit be associated with their card.
2. Issuer sends request with a card number, old bundle code, new bundle code and effective date as an input parameter
3. Benefit Allocation Service API returns the benefit bundle codes assigned during replace with effective and expiration dates. bundle codes with the future effective date will be applied with the future effective date

### Use Case 3: replace bundle code that has a bundle that has been expired in the past {#use-case-3-replace-bundle-code-that-has-a-bundle-that-has-been-expired-in-the-past}

1. Cardholder requests a new benefit be associated with their card.
2. Issuer sends request with a card number, old bundle code, new bundle code and effective date as an input parameter
3. Benefit Allocation Service API returns the benefit bundle codes assigned during replace with effective and expiration dates, the bundle expired bundle is not added.

### Use Case 4: replace bundle code that has a bundle with a future expiry date {#use-case-4-replace-bundle-code-that-has-a-bundle-with-a-future-expiry-date}

1. Cardholder requests a new benefit be associated with their card.
2. Issuer sends request with a card number, old bundle code, new bundle code and effective date as an input parameter
3. Benefit Allocation Service API returns the benefit bundle codes assigned during replace with effective and expiration dates, future expiration dates will get the future expiration date applied.

## Additional Information {#additional-information}

1. Look at the [API Reference](https://developer.mastercard.com/benefit-allocation-service-mtls/documentation/api-reference/index.md) for information on how to implement this use case.
2. Look at the [Code and Formats](https://developer.mastercard.com/benefit-allocation-service-mtls/documentation/code-and-formats/index.md) for acknowledgement responses.