---
title: "Multi-Currency Pricing Rate Lookup"
method: POST
path: "/multi-currency-pricing-rates"
tags: ["Multi-Currency Pricing Rate Lookup"]
---

# Multi-Currency Pricing Rate Lookup

`POST /multi-currency-pricing-rates`

Performs a foreign currency exchange rate look-up, and secures that exchange rate for use in a subsequent Multi-Currency Pricing financial transaction. 
The exchange rate retrieved by this transaction request is represented in the response as the multiCurrencyPricingRateLookupId, and the underlying exchange rate is locked in for a limited time period.

## Request body

- MultiCurrencyPricingRateLookupRequest
  - `multiCurrencyPricingTransactionType` 'PAYMENT' | 'REFUND', required — Value representing the type of subsequent transaction request that the rate token will be used for
  - `multiCurrencyPricingRateInformationRequests` MultiCurrencyPricingRateInformationRequest[], required
    - union — Multi-Currency Pricing (MCP) Rate Information Request Object
      - MultiCurrencyPricingRateCardholderInformation — Multi-Currency Pricing (MCP) Rate Information Object
        - `amountType` 'CARDHOLDER', required — The type of rate lookup to perform.
        - `amount` Money, required — Monetary amount. Note: The value must be in cents. Therefore $10.59 must be sent as 1059.
          - `amount` integer, required — Amount
          - `currency` string, iso-4217, required — Provides the three letter currency code according the ISO 4217 standard. For a complete list of currency codes, visit: https://en.wikipedia.org/wiki/ISO_4217
      - MultiCurrencyPricingRateMerchantSettlementInformation — Multi-Currency Pricing (MCP) Rate Merchant Settlement Information Object
        - `amountType` 'MERCHANT_SETTLEMENT', required — The type of rate lookup to perform.
        - `amount` Money, required — Monetary amount. Note: The value must be in cents. Therefore $10.59 must be sent as 1059.
          - `amount` integer, required — Amount
          - `currency` string, iso-4217, required — Provides the three letter currency code according the ISO 4217 standard. For a complete list of currency codes, visit: https://en.wikipedia.org/wiki/ISO_4217
        - `cardholderCurrency` string, iso-4217, required — Provides the three letter currency code according the ISO 4217 standard. For a complete list of currency codes, visit: https://en.wikipedia.org/wiki/ISO_4217
  - `customData` CustomData, nullable — Merchant can send custom meta data with the transaction in this object. Moneris will echo these values back in response.

## Response `207`

Multi-Currency Pricing (MCP) Rate lookup Response

- MultiCurrencyPricingRateLookup
  - `multiCurrencyPricingRateLookupId` string, required — Used to identify API resources which may be required for future follow-on transactions; i.e. Refunds, Corrections, Completions, Reversals, etc.
  - `multiCurrencyPricingTransactionType` 'PAYMENT' | 'REFUND', required — Value representing the type of subsequent transaction request that the rate token will be used for
  - `rateValidityEndTime` string, date-time, required — Date & Time
  - `rateConversions` MultiCurrencyPricingRateConversion[], required
    - `cardholderAmount` Money, required — Monetary amount. Note: The value must be in cents. Therefore $10.59 must be sent as 1059.
      - `amount` integer, required — Amount
      - `currency` string, iso-4217, required — Provides the three letter currency code according the ISO 4217 standard. For a complete list of currency codes, visit: https://en.wikipedia.org/wiki/ISO_4217
    - `merchantSettlementAmount` object, required — The amount that will be paid to the merchant, in settlement currency
      - `amount` integer, required — Amount
      - `currency` string, iso-4217, required — Provides the three letter currency code according the ISO 4217 standard. For a complete list of currency codes, visit: https://en.wikipedia.org/wiki/ISO_4217
    - `multiCurrencyPricingExchangeRate` number, required — The foreign exchange rate (foreign currency to CAD) that will be used for the transaction
    - `multiCurrencyPricingStatusCode` integer, required — HTTP Status code of the MCP transaction
    - `multiCurrencyPricingStatusMessage` string, required — Message corresponding to the MCP Status Code
  - `customData` object, nullable — Merchant can send custom meta data with the transaction in this object. Moneris will echo these values back in response.
  - `createdAt` string, date-time, required — Time at which the object was created

## Other responses

- `400` — Bad Request.
- `401` — Not authorized. The user does not have a valid API Key or Access Token.
- `403` — Forbidden. The user does not have permission to access the requested resource.
- `422` — The API cannot complete the requested action due to semantic or business validation errors.
- `429` — Too Many Requests
- `500` — Unexpected error.
- `503` — Service Temporarily Unavailable

---

[API](https://skmtc.net/moneris/apis/moneris-api.md) · [All operations](https://skmtc.net/moneris/apis/moneris-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moneris/moneris-api/revisions/edefcc925b74/schema)