availability

Braintree Auth is in closed beta. To request access, email auth@braintreepayments.com.

The Shared Vault feature 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.

Next: Testing and Go Live →

Still have questions?

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