# Unlock Redemptions
source: https://developer.mastercard.com/easy-savings-specials/documentation/use-cases/use-cases-4/index.md

## Overview {#overview}

The `POST/redemptions` endpoint allows the issuer, on behalf of the SME business cardholder, to initiate an unlock redemption request. Upon successful processing, it returns a unique transaction identifier (`orderId`) and an optional voucher code. The system uses the voucher code according to the redemption instructions associated with the offer.

## Pre-requisites {#pre-requisites}

1. The issuer provides a mechanism for SMEs to request a specific offer from the list of eligible offers.
2. The issuer provides a secure method to display or communicate the voucher code and redemption instructions to the SME business cardholder.

## User journey {#user-journey}

Diagram use-case-unlock-redem

## Workflow {#workflow}

**1. Request initiation.**

* The SME business cardholder selects an available offer from the list returned by the `GET/offers` endpoint.
* The SME business cardholder submits a redemption request to the issuer.
* The issuer captures the associated BIN and `offerId` to initiate the redemption process.

**2. Unlocking offer details.**

* The issuer sends a `POST/redemptions` request to Mastercard using the captured BIN and `offerId`.
* Key considerations:
  * Ensure that the BIN is correctly mapped to the SME business cardholder's account.
  * Validate that the `offerId` corresponds to a currently active offer.
* Mastercard verifies the request, unlocks the offer, and returns:
  * Offer details.
  * A unique `orderId`.
  * Issues an optional voucher code with each offer.
* The issuer shares the returned offer details with the SME business cardholder.

**3. Provision redemption details.**

* The issuer communicates the following to the SME business cardholder:
  * Redemption status (for example, pending, successful, failed).
  * Associated `orderId` for tracking purposes.
  * Voucher code, if applicable.
  * Additional information (for example, offer description, redemptionURL), which can be retrieved through `GET/offers` using the `offerId`.

## Use case examples {#use-case-examples}

### Unlocking a discount voucher for a business travel offer {#unlocking-a-discount-voucher-for-a-business-travel-offer}

An SME business cardholder wants to redeem a **10% discount on hotel bookings** available through the Easy Savings Specials program. The SME business cardholder requests the offer through the issuer. The issuer, on behalf of the SME business cardholder, calls the unlock redemption API using the selected offer ID (for example, "*HOTEL10* ") and the SME business cardholder's credentials. Upon successful processing, the API returns a unique `orderId` and a voucher code (for example, "*TRAVEL2025*"). The SME business cardholder uses the voucher code when booking through the partner's platform.

### Unlocking access to a premium software subscription {#unlocking-access-to-a-premium-software-subscription}

An SME business cardholder is eligible for **one month of free cloud storage** under an ongoing offer. The SME business cardholder requests the offer through the issuer. The issuer initiates an unlock redemption request for the selected offer. The API returns a unique `orderId`. No voucher code is returned, as the redemption is processed automatically through link-based instructions. The SME business cardholder follows the provided redemption instructions to activate and benefit from the offer.

## Unlock redemptions endpoint {#unlock-redemptions-endpoint}

See the API structure:

API Reference: `POST /redemptions`