availability

OAuth is in closed beta in production, and open beta in sandbox. To express interest in the production beta release, contact our Business Development team.

The Shared Vault scope of OAuth allows you, as the platform owner, to store all credit cards and customer data in your own Braintree Vault. You can then use that data to create a transaction for a connected merchant. This Shared Vault model delivers a network benefit to all your connected merchants, helping boost checkout conversion.

Creating a Shared Vault transaction

The shared_vault_transactions right allows you to use tokens and IDs from your own Vault when creating a transaction for a connected merchant. The full list of parameters that can be used when creating a Shared Vault transaction can be found in the transaction reference.

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

result = gateway.transaction.sale(
  :shared_payment_method_token => your_payment_method_token,
  :amount => "100.00"
)

Payment methods used to create Shared Vault transactions can never be updated by the connected merchant, and they can't be stored in the connected merchant’s Vault.

The resulting transaction will have both facilitated_details and facilitator_details.

Still have questions?

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