Contact Us
Skip Navigation LinksHome > Exchange Rates > Submit Exchange Rate Request  

Submit Exchange Rate Request

Use this method to request a real time Exchange Rate from PayFac.

Given input of two currencies, a direction and an amount, PayFac will return an exchange rate and a converted amount.

Use the HTTP POST method with the url below:

https://api.payfac.com/api.svc/exchangeRateRequest

  • An Authorisation header is required in the following format:  Authorization : username:AccountKey
  • The certificate used for mTLS authentication must be included in the request
  • The request schema and request example show the XML format required by this method
  • The response schema and response example define the XML format that is returned for this method

Element Descriptions

Field Name  Type   Length Description
<Amount>  Decimal  8.6 Required. The amount of CurrencyCode1 that you wish to Buy or Sell
<ConvertedAmount>  Decimal 8.6 Ignored for input. The amount of CurrencyCode2 after the exchange rate has been applied
<CurrencyCode1>  String 3 Required. The Currency Code of the currency you wish to Buy or Sell
<CurrencyCode2>  String  3 Required.The Currency Code that you are requesting a rate for
<DirectionCode>  String 3 Required. Indicates if the customer is buying or selling currency. Valid codes are BUY or SEL
<ExchangeRate>  Decimal   8.6 Ignored for Input. The exchange rate for the currency pair requested