What is the «Instant Purchase» (`Magento_InstantPurchase`) module for?


Instant Purchase feature allows the Customer to place the order in seconds without going through full checkout. Once clicked, system places the order using default shipping and billing addresses and stored payment method. Order is placed and customer gets confirmation message in notification area.

Prerequisites to display the Instant Purchase button:

  1. Instant purchase enabled for a store at Store / Configurations / Sales / Sales / Instant Purchase
  • Customer is logged in
  • Customer has default shipping and billing address defined
  • Customer has valid stored payment method with instant purchase support


In addition to a typical file structure for a Magento 2 module PaymentMethodsIntegration directory contains interfaces and basic implementation of integration vault payment method to the instant purchase.


Instant purchase customization

Almost all aspects of instant purchase may be customized. See comments to classes and interfaces marked with @api tag.

All payments created for instant purchase also have 'instant-purchase' => true in addition information. Use this only if all other customization points not suitable,

Payment method integration

Instant purchase support may be implemented for any payment method with vault support.
Basic implementation provided in Magento\InstantPurchase\PaymentMethodIntegration should be enough in most cases. It is not enabled by default to avoid issues on production sites and authors of vault payment method should verify correct work for instant purchase manually.
To enable basic implementation just add single option to configuration of payemnt method in config.xml:


Basic implementation is a good start point but it’s recommended to provide own implementation to improve user experience. If instant purchase integration has customization then supported option is not required.

  • Magento\InstantPurchase\PaymentMethodIntegration\AvailabilityCheckerInterface - allows programmatically defines if instant purchase supported (e.g. support may not be available if some payment method option switched on/off). Basic implementation always returns true.
  • Magento\InstantPurchase\PaymentMethodIntegration\PaymentTokenFormatterInterface - creates string that describes stored payment method. Basic implementation returns payment method name. It is highly recommended to implement own formatter.
  • Magento\InstantPurchase\PaymentMethodIntegration\PaymentAdditionalInformationProviderInterface - allows to add some extra values to payment additional information array. Default implementation returns empty array.

Additional information

Backward incompatible changes

The Magento_InstantPurchase module does not introduce backward incompatible changes.

You can track backward incompatible changes in patch releases.

The source: github.com/magento/magento2/blob/5e00970c/app/code/Magento/InstantPurchase/README.md

See also: