Skip to content

Exchange Rates

Get Paying Currency Exchange Rate#

getPayingExhangeRate

This method retrieves the exchange rate for the paying currency to USD.

Request Inputs#

Field Type Size Mandatory Description
agentCode String 5 Yes Agent code assigned by SHIFT
userId String 20 Yes User ID assigned by SHIFT
userPassword String 30 Yes User password assigned by SHIFT
serviceType String 20 Yes See the service types table
payingCurrencyCode String 3 Yes ISO Alpha3
sendCountryCode String 3 Yes ISO Alpha3
destinationCountryCode String 3 Yes ISO Alpha3

Response Outputs#

Field Type Description
resultCode String See the Result Codes and Messages table
resultMessage String
ExchangeRate Object Exchange rate information object.
See below ExchangeRate

ExchangeRate#

ExchangeRate Object fields (for getPayingExhangeRate)
Field Type Description
payingCurrencyCode String
payingExchangeRate Decimal
payingExchangeRateInverse Decimal

SOAP Request#

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice/">
   <soapenv:Header/>
   <soapenv:Body>
      <web:getPayingExhangeRate>
         <serviceType>CASH</serviceType>
         <payingCurrencyCode>EUR</payingCurrencyCode>
         <sendCountryCode>LTU</sendCountryCode>
         <destinationCountryCode>QAT</destinationCountryCode>
         <agentCode>*****</agentCode>
         <userId>*****</userId>
         <userPassword>*****</userPassword>
      </web:getPayingExhangeRate>
   </soapenv:Body>
</soapenv:Envelope>

SOAP Response#

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns3:getPayingExhangeRateResponse xmlns:ns2="http://xml.netbeans.org/schema/ApiSchema" xmlns:ns3="http://webservice/">
         <return>
            <ns2:resultCode>9000</ns2:resultCode>
            <ns2:resultMessage>Operation successfully</ns2:resultMessage>
            <ns2:ExchangeRate>
               <ns2:payingExchangeRate>0.83</ns2:payingExchnageRate>
               <ns2:payingExchangeRateInverse>1.204819</ns2:payingExchnageRateInverse>
               <ns2:payingCurrencyCode>EUR</ns2:payingCurrencyCode>
            </ns2:ExchangeRate>
         </return>
      </ns3:getPayingExhangeRateResponse>
   </S:Body>
</S:Envelope>

Get Payout Currency Exchange Rate#

getPayoutExhangeRate

This method retrieves the exchange rate for the payout currency to USD.

Request Inputs#

Field Type Size Mandatory Description
agentCode String 5 Yes Agent code assigned by SHIFT
userId String 20 Yes User ID assigned by SHIFT
userPassword String 30 Yes User password assigned by SHIFT
serviceType String 20 Yes See the service types table
payoutCurrencyCode String 3 Yes ISO Alpha3
sendCountryCode String 3 Yes ISO Alpha3
destinationCountryCode String 3 Yes ISO Alpha3

Response Outputs#

Field Type Description
resultCode String See the Result Codes and Messages table
resultMessage String
ExchangeRate Object Exchange rate information object.
See below ExchangeRate

ExchangeRate#

ExchangeRate Object fields (for getPayoutExhangeRate)
Field Type Description
payoutCurrencyCode String
payoutExchangeRate Decimal
payoutExchangeRateInverse Decimal

SOAP Request#

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice/">
   <soapenv:Header/>
   <soapenv:Body>
      <web:getPayoutExhangeRate>
         <serviceType>CASH</serviceType>
         <payoutCurrencyCode>EUR</payoutCurrencyCode>
         <sendCountryCode>QAT</sendCountryCode>
         <destinationCountryCode>LTU</destinationCountryCode>
         <agentCode>*****</agentCode>
         <userId>*****</userId>
         <userPassword>*****</userPassword>
      </web:getPayoutExhangeRate>
   </soapenv:Body>
</soapenv:Envelope>

SOAP Response#

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns3:getPayoutExhangeRateResponse xmlns:ns2="http://xml.netbeans.org/schema/ApiSchema" xmlns:ns3="http://webservice/">
         <return>
            <ns2:resultCode>9000</ns2:resultCode>
            <ns2:resultMessage>Operation successfully</ns2:resultMessage>
            <ns2:ExchangeRate>
               <ns2:payoutExchangeRate>0.83</ns2:payoutExchnageRate>
               <ns2:payoutExchangeRateInverse>1.204819</ns2:payoutExchnageRateInverse>
               <ns2:payoutCurrencyCode>EUR</ns2:payoutCurrencyCode>
            </ns2:ExchangeRate>
         </return>
      </ns3:getPayoutExhangeRateResponse>
   </S:Body>
</S:Envelope>