availability

Braintree Auth is in closed beta. To express interest, contact our Business Development team.

If you support new Braintree signups through your platform, Braintree Auth allows you to add and list presentment currencies for a connected merchant.

important

Adding currencies is only supported for merchants who sign up through Braintree Auth. Attempting to add a currency for a merchant who did not sign up for their Braintree account via Braintree Auth (i.e. a merchant connecting an existing non-OAuth account to an OAuth application) will result in a validation error.

Adding a currency

Once you have completed the OAuth Flow and received an access_token for a merchant, you can use the merchant API to add a currency:

Ruby
Copy
Copied
gateway = Braintree::Gateway.new(
  :access_token => merchant_access_token
)

result = gateway.merchant_account.create_for_currency(
  :currency => "USD"
)

if result.success?
  puts result.merchant_account.currency_iso_code
end

If any of the merchant's payment_methods do not accept the provided currency, a validation error is returned and a new merchant account will not be created. For more information see currency support.

You can view the supported currencies for a merchant by inspecting their merchant accounts:

Ruby
Copy
Copied
gateway = Braintree::Gateway.new(
  :access_token => merchant_access_token
)

result = gateway.merchant_account.all

result.merchant_accounts.each do |merchant_account|
  puts merchant_account.currency_iso_code
end

Currency support

To add a currency for a merchant through MerchantAccount.create-for-currency(), all of the payment methods the merchant accepts must support the new currency. For details on which currencies are supported for each payment method, see the following references:

note

American Express presentment is currently limited to a small subset of currencies (GBP, EUR, SEK, USD); attempts to add an unsupported currency for Amex will succeed for other cards but not allow Amex presentment. Running an Amex transaction against these merchant accounts will result in a transaction validation error.

See also

Next Page: Testing and Go Live →

Still have questions?

If you can’t find an answer, contact our Support team