# Quote Confirmation APIs source: https://developer.mastercard.com/cross-border-services/documentation/api-ref/transaction-apis/quote-confirmation-apis/index.md Alert: If you are a Customer contracted with MTS EU or MTS UK, refer to the corresponding EU and UK specification inside the swagger file to ensure compliance with the relevant jurisdiction based Regulatory Technical Standards (either EU or UK) derived from the Revised Payment Services Directive (PSD2). ## Quote Confirmation API Suite {#quote-confirmation-api-suite} Enrolling in the Quote Confirmation suite API includes the following APIs: Note: If you would like real time Payment and Quote status updates then enroll in the [Status Change Push Notification](https://developer.mastercard.com/cross-border-services/documentation/api-ref/transaction-apis/status-change-api/index.md). ## Environment Domains {#environment-domains} ### Quote Confirmation {#quote-confirmation} * Sandbox/MTF * Sandbox-EU * Sandbox-UK * MTF-EU * MTF-UK * Production * Production-EU * Production-UK ```Sandbox/MTF https://sandbox.api.mastercard.com/send/partners/{partner-id}/crossborder/quotes/confirmations ``` ```Sandbox-EU https://sandbox.api.xbs.mastercard.eu/send/partners/{partner-id}/crossborder/quotes/confirmations ``` ```Sandbox-UK https://sandbox.api.xbs.mastercard.uk/send/partners/{partner-id}/crossborder/quotes/confirmations ``` ```MTF-EU https://mtf.api.xbs.mastercard.eu/send/partners/{partner-id}/crossborder/quotes/confirmations ``` ```MTF-UK https://mtf.api.xbs.mastercard.uk/send/partners/{partner-id}/crossborder/quotes/confirmations ``` ```Production https://api.mastercard.com/send/partners/{partner-id}/crossborder/quotes/confirmations ``` ```Production-EU https://api.xbs.mastercard.eu/send/partners/{partner-id}/crossborder/quotes/confirmations ``` ```Production-UK https://api.xbs.mastercard.uk/send/partners/{partner-id}/crossborder/quotes/confirmations ``` ### Cancel Confirmed Quote {#cancel-confirmed-quote} * Sandbox/MTF * Sandbox-EU * Sandbox-UK * MTF-EU * MTF-UK * Production * Production-EU * Production-UK ```Sandbox/MTF https://sandbox.api.mastercard.com/send/partners/{partner-id}/crossborder/quotes/cancellations ``` ```Sandbox-EU https://sandbox.api.xbs.mastercard.eu/send/partners/{partner-id}/crossborder/quotes/cancellations ``` ```Sandbox-UK https://sandbox.api.xbs.mastercard.uk/send/partners/{partner-id}/crossborder/quotes/cancellations ``` ```MTF-EU https://mtf.api.xbs.mastercard.eu/send/partners/{partner-id}/crossborder/quotes/cancellations ``` ```MTF-UK https://mtf.api.xbs.mastercard.uk/send/partners/{partner-id}/crossborder/quotes/cancellations ``` ```Production https://api.mastercard.com/send/partners/{partner-id}/crossborder/quotes/cancellations ``` ```Production-EU https://api.xbs.mastercard.eu/send/partners/{partner-id}/crossborder/quotes/cancellations ``` ```Production-UK https://api.xbs.mastercard.uk/send/partners/{partner-id}/crossborder/quotes/cancellations ``` ### Retrieve Confirmed Quote {#retrieve-confirmed-quote} * Sandbox/MTF * Sandbox-EU * Sandbox-UK * MTF-EU * MTF-UK * Production * Production-EU * Production-UK ```Sandbox/MTF https://sandbox.api.mastercard.com/send/partners/{partner-id}/crossborder/quotes/{transaction-reference}/proposals/{proposal-id} ``` ```Sandbox-EU https://sandbox.api.xbs.mastercard.eu/send/partners/{partner-id}/crossborder/quotes/{transaction-reference}/proposals/{proposal-id} ``` ```Sandbox-UK https://sandbox.api.xbs.mastercard.uk/send/partners/{partner-id}/crossborder/quotes/{transaction-reference}/proposals/{proposal-id} ``` ```MTF-EU https://mtf.api.xbs.mastercard.eu/send/partners/{partner-id}/crossborder/quotes/{transaction-reference}/proposals/{proposal-id} ``` ```MTF-UK https://mtf.api.xbs.mastercard.uk/send/partners/{partner-id}/crossborder/quotes/{transaction-reference}/proposals/{proposal-id} ``` ```Production https://api.mastercard.com/send/partners/{partner-id}/crossborder/quotes/{transaction-reference}/proposals/{proposal-id} ``` ```Production-EU https://api.xbs.mastercard.eu/send/partners/{partner-id}/crossborder/quotes/{transaction-reference}/proposals/{proposal-id} ``` ```Production-UK https://api.xbs.mastercard.uk/send/partners/{partner-id}/crossborder/quotes/{transaction-reference}/proposals/{proposal-id} ``` Note: **Sandbox** and **MTF** environments share the same url but are differentiated by partner id. ## API {#api} [****Open Specification****](https://static.developer.mastercard.com/content/cross-border-services/swagger/cross_border-swagger.yaml) Enrolling in the Quote Confirmation Service includes the following APIs: Note: If you would like real time Payment and Quote status updates then enroll in the [Status Change Push](https://developer.mastercard.com/cross-border-services/documentation/api-ref/transaction-apis/status-change-api/index.md). ### Quote Confirmation API {#quote-confirmation-api} This API is used to confirm the FX rate quote that you received in the Quotes API. This confirmation is mandatory prior to submitting a payment transaction. The Quote Confirmation needs to be done within the 'confirmationExpiryTime' that is received in the Quotes API response. Getting a successful Quote Confirmation incurs a reserve of funds. If you opt-in 'Late Quote Confirmation policy' and you confirm the quote after `confirmationExpiryTime`, the original quote will be considered as 'Expired' and new quote will be sent in the Quote Confirmation API response. You can now confirm the new quote within the `ConfirmationExpirytime`. The late confirmation will be allowed for maximum of three (3) attempts; afterwards, the confirmation will be declined. API Reference: `GET /send/partners/{partner_id}/crossborder/quotes/confirmations` ### Cancel Confirmed Quote API {#cancel-confirmed-quote-api} This API is used to cancel a confirmed FX rate quote/proposal. If Confirmed Quote cancellation is sent before the payment initiation, the cancellation will result in return of reserved funds. If cancellation is sent after payment initiation, the Confirmed Quote Cancellation will be declined. API Reference: `GET /send/partners/{partner_id}/crossborder/quotes/cancellations` ### Retrieve Confirmed Quote API {#retrieve-confirmed-quote-api} If you opt-in in Quote Confirmation Suite, you can use this API to retrieve quote details requested for payment utilization. API Reference: `GET /send/partners/{partner_id}/crossborder/quotes/{transaction_reference}/proposals/{proposal_id}` ## API Convention {#api-convention} Take a look at the [API Conventions](https://developer.mastercard.com/cross-border-services/documentation/api-basics/index.md#api-conventions) for general guidelines. ## Payload Encryption {#payload-encryption} All the request payload sent by you to Mastercard must be encrypted. And you will need to decrypt the payload sent by Mastercard. For more detailed information on payload **Encryption/ Decryption** , please see [here](https://developer.mastercard.com/cross-border-services/documentation/api-basics/index.md#transport-encryption) ## Next step {#next-step} Proceed to [Quote Confirmation APIs: Sandbox Testing](https://developer.mastercard.com/cross-border-services/documentation/testing/quote-confirmation-apis/index.md) to test the Quote Confirmation APIs in the Sandbox environment.