This page has moved and will be redirected soon. See Migrated topics for the complete list.
The Payment Provider Gateway documentation uses the Magento 2.3 (now Adobe Commerce and Magento Open Source) of the Braintree module as a reference application. The Braintree module was removed in version 2.4.0. The concepts described in this guide are still applicable to version 2.4.0, but the code samples are not supported.

Adding vault integration

Vault as a payment method provides store customers with ability to use the previously saved credit card information for checkout. This information is stored safely on the side of trusted payments gateways (Braintree, PayPal). Not storing the sensitive credit card information is one of the PCI compliance requirements.

The Magento Vault is implemented using the Magento payment gateway. It is used in the out-of-the-box vault implementation for the Braintree payment method. Third party developers can use it to add vault to their custom payment provider integration.

The following diagram shows a simplified interaction flow between Magento sales management, vault, payment integration and external payment service provider.

Vault Interaction

The flow is similar to usual Magento payment gateway interaction flow.

The main difference is that when vault is used, it defines what command is required and when it must be called.

Adding vault: general steps

Magento vault implementation provides that vault is available as a separate payment method during order creation (storefront or admin). But technically it is tightly related to the corresponding payment provider integration. You do not need to create a new module for vault implementation. All required configuration and entities are added to the module of the payment provider integration.

The topics of this chapter describe how to add the vault functionality to a payment method (the payment method must be implemented using Magento payment gateway):

  1. Add vault to module dependencies.
  2. Configure vault general parameters.
  3. Add vault and payment methods entities using dependency injection configuration.
  4. Implement the ability for customers to choose whether to use vault.
  5. Storing and processing the payment related data.
  6. Adding and using UI_Vault component to place orders on the storefront.
  7. Display stored tokens for customer and process their deleting.
  8. Using stored tokens to place an order from Admin panel.