# Payment with Carded Rate
source: https://developer.mastercard.com/cross-border-services/documentation/use-cases/payment-with-carded-rate/index.md

Carded Rate is offered as an opt-in functionality to obtain the FX rates for all the currency pairs that you support, for a valid period of time. Once opted in for the service, carded rate can be obtained via following mechanism:

1. API ([FX Pull/ FX Push](https://developer.mastercard.com/cross-border-services/documentation/api-ref/carded-rate-api/index.md)) based delivery

2. File based delivery

A carded rate include the dealable FX rate, rate ID, effective time, as well as other information for the currency pair. The Carded Rate Id for the desired currency pair can be sent within a payment transaction request to avail the provided FX rate, while the carded rate is valid. For the complete list of supported transaction types, see [Use Cases.](https://developer.mastercard.com/cross-border-services/documentation/use-cases/index.md)  

Ask your Mastercard Representative for more information on how to opt-in for the carded rate service and choose the best suitable delivery mechanism.

This payment option is mainly for the Customer Managed Sender Pricing (CMSP) Model. Learn more about the [Pricing Model](https://developer.mastercard.com/cross-border-services/documentation/use-cases/pricing-model/index.md).
Note: Unlike single quote, carded rate once obtained can be used across multiple transactions as long as the rate Id is valid.

Payment with Carded Rate can be achieved in three different ways:

## 1. Forward Payment (fees included) with carded rate: {#1-forward-payment-fees-included-with-carded-rate}

With this type, the sender specifies the Sending amount and currency for a payment including any applicable service fees and the amount received by recipient in the receiver currency is calculated.

As an example, below sequence shows a forward payment of 100 USD to Phillippines including the service fees with a carded rate obtained via FX pull API.  

**Note**: Carded rate can be also obtained using the FX Push API or file based approach.
Diagram send-fwd-with-carded-rate-fees-sequence

## 2. Forward Payment (fees not included) with carded rate {#2-forward-payment-fees-not-included-with-carded-rate}

The sender specifies the Sending amount and currency for a payment and Mastercard calculates the the amount received by the end recipient and also the amount charged to the sender with the service fees applied on top of the request send amount.

As an example, below sequence shows a forward payment transaction of 100 USD to Phillippines as and the service fees applied on top of the sending amount; with a carded rate obtained via FX pull API.  

**Note**: Carded rate can be also obtained using the FX Push API or file based approach.
Diagram send-fwd-with-carded-rate-wo-fees-sequence

## 3. Reverse Payment with carded rate {#3-reverse-payment-with-carded-rate}

With this type, the receiving amount in receiver currency is specified by the sender and the total amount charged to the sender is calculated; with a carded rate obtained via API or file approach.

As an example, below sequence shows a payment transaction of 5000 PHP as a reverse payment based on the carded rate obtained via FX pull API.  

**Note**: Carded rate can be also obtained using the FX Push API or file based approach.
Diagram send-rvs-with-carded-rate-sequence

### APIs that you will use for this payment model: {#apis-that-you-will-use-for-this-payment-model}

1. [FX Rate Push / FX Rate Pull API](https://developer.mastercard.com/cross-border-services/documentation/api-ref/carded-rate-api/index.md) to obtain the carded rate.
2. [Payment API](https://developer.mastercard.com/cross-border-services/documentation/api-ref/payment-api/index.md) POST request to submit a payment transaction to transfer funds to the cross border recipient (by providing the carded rate Id obtained in the FX Rate Push/ Pull API response).

### Some of the other APIs that are available as added functionality are: {#some-of-the-other-apis-that-are-available-as-added-functionality-are}

1. [Retrieve Payment API](https://developer.mastercard.com/cross-border-services/documentation/api-ref/retrieve-payment-api/index.md) GET request to retrieve a payment transaction that was previously submitted.
2. [Status Change API](https://developer.mastercard.com/cross-border-services/documentation/api-ref/status-change-api/index.md) POST request to get an update on the status change of the transaction that was previously submitted.
3. [Cancel Payment API](https://developer.mastercard.com/cross-border-services/documentation/api-ref/cancel-payment-api/index.md) POST request to cancel a PENDING payment transaction that was previously submitted.