Set up Braintree as a payment service in Xero

Accept online payments for your invoices using Braintree. To set this up, add Braintree as a payment service, then apply to a branding theme.

Add Braintree on the payment services screen

  1. In the Settings menu, select General Settings.
  2. Under Connect, click Payment Services.
  3. Click Add Payment Service.
  4. Select Braintree.
  5. Complete the fields.
  6. Click Save.

Apply to a branding theme

  1. On the Payment Services screen, click Manage Themes.
  2. Select this payment service as credit card service. You can also select a PayPal service you've already set up.
  3. Click Save.

Payment service fields explained


Enter a name as you'd like it to appear in Xero. If using multiple currencies, include the currency in the name for each Braintree account you set up in Xero.

Merchant ID

Enter the Merchant ID for your Braintree gateway account.

API Credentials (Braintree website)

Merchant Account ID

Enter the Merchant account ID associated with your Braintree merchant account.

Merchant ID (Braintree website)

Public Key

Enter the public key for your Braintree account.

API Credentials (Braintree website)

Private Key

Enter the private key for your Braintree account.

API Credentials (Braintree website)

Credit card logos to appear on your invoice

Select the credit card logos to display on your invoice. The logos that can be displayed will depend on your merchant provider. VISA and MasterCard have been selected for you by default.


If you've enabled the multi-currency option, select the currency of the merchant account ID you entered. This currency must match the currency for your organization or bank account.

Each Braintree account in Xero can support a single currency. To use Braintree for another currency, set up another account in Payment Services.

When sending an invoice, you must select the same currency as the one selected for the Braintree account applied to the branding theme.

What is my base currency?

Currencies (Braintree website)

Payment account

Select the bank account to deposit the payment in.