Tools/
Foreign Exchange as a Service/
Integration

Get StartedAnchorIcon

Braintree Foreign Exchange as a Service (FXaaS) is available to eligible merchants in the UK and EU. To get started, contact your Braintree Account Manager, who will guide you through eligibility, contracting, and account setup. Once your account is activated and your FXaaS contract is signed, your Account Manager will provide the credentials and integration details needed to proceed.

To integrate BT FXaaS:

  1. Obtain an exchange rate quote
  2. Obtain an exchange rate quote
  3. Obtain an exchange rate quote
  4. Obtain an exchange rate quote

PrerequisiteAnchorIcon

  • Ensure your FXaaS contract is signed and your merchant account is activated by your Braintree account Manager.
  • Review your contract for key parameters: rate expiration interval, rate refresh time, FX fees, and other relevant terms.

Server-Side ImplementationAnchorIcon

Creating a transactionAnchorIcon

When creating a transaction, pass the exchange_rate_quote_id from the Python SDK.

The Exchange Rate Quote API is a GraphQL API, and the server-side implementation includes converting the below request passed to the API.

The client-side makes a request by passing the following variables:

  1. Python
attribute1 = {
    "base_currency": "USD",
    "quote_currency": "EUR",
    "base_amount": "12.19",
    "markup": "12.14"
}
request = ExchangeRateQuoteRequest().add_exchange_rate_quote_input(attribute1).done()

and invoking the API:

  1. Python
response = self.get_gateway().exchange_rate_quote.generate(request)

the response:

  1. Python
result = gateway.transaction.sale(
    {
        "amount": "10.00",
        "payment_method_nonce": nonce_from_the_client,
        "exchange_rate_quote_id": exchangeRateQuoteIdFromTheClient,
        "device_data": device_data_from_the_client,
        "options": {
            "submit_for_settlement": True
        }
    }
)