{"title":"Set up tokenization","category":"default","creationDate":1682081040,"content":"<p>Adyen's plugin allows you to securely store the payment details of shoppers, giving your returning shoppers a faster checkout experience. We refer to these saved payment details as tokens and storing a shopper's payment details as tokenization.<\/p>\n<p>Tokenization can be done for card, Google Pay, Apple Pay, SEPA, Klarna, PayPal, iDEAL, Payconiq by Bancontact and in-person payments. For additional payment methods to be tokenized, <a href=\"https:\/\/github.com\/Adyen\/adyen-magento2\/issues\/new\/choose\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">request a new feature on our GitHub page<\/a>.<\/p>\n<h2>How it works<\/h2>\n<p>When a shopper is making a payment, a <strong>Save for my next payment<\/strong> checkbox will appear. If the checkbox is selected, shopper payment details will be securely stored. The plugin uses the <a href=\"https:\/\/developer.adobe.com\/commerce\/php\/development\/payments-integrations\/vault\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Adobe Commerce Vault<\/a> to store the token information.<\/p>\n<p>The shopper can choose express checkout, by selecting an <strong>Instant purchase<\/strong> button right next to the product. The shopper will be asked to provide their <a href=\"\/pt\/get-started-with-adyen\/adyen-glossary\/#card-security-code-cvc-cvv-cid\">CVC<\/a> to complete the payment.<\/p>\n<h2>Requirements<\/h2>\n<ul>\n<li><a href=\"\/pt\/development-resources\/webhooks\/webhook-types#non-default-event-codes\">Enable <strong>RECURRING_CONTRACT<\/strong> webhooks<\/a> in your Customer Area.<\/li>\n<\/ul>\n<h2 id=\"set-up-vault\">Step 1: Set up the Vault in Adobe Commerce<\/h2>\n<ol>\n<li>Log in to your Adobe Commerce admin panel.<\/li>\n<li>In the left navigation bar, go to <strong>Stores<\/strong> &gt; <strong>Configuration<\/strong>.<\/li>\n<li>In the menu, go to <strong>Sales<\/strong> &gt; <strong>Payment Methods<\/strong>.<\/li>\n<li>Select <strong>Configure<\/strong> next to <strong>Adyen Payments<\/strong>.<\/li>\n<li>Go to <strong>Payment Optimization<\/strong> &gt; <strong>Tokenization<\/strong> and fill in the following fields for each payment method you want to tokenize:<\/li>\n<\/ol>\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>Payment method<\/strong><\/td>\n<td>The payment method that you want to tokenize.<\/td>\n<\/tr>\n<tr>\n<td><strong>Enabled<\/strong><\/td>\n<td>Select <strong>Yes<\/strong> to enable tokenization for the payment method.<\/td>\n<\/tr>\n<tr>\n<td><strong>Recurring Processing Model<\/strong><\/td>\n<td>Set to <strong>CardOnFile<\/strong>, <strong>UnscheduledCardOnFile<\/strong>, or <strong>Subscription<\/strong> depending on <a href=\"\/pt\/online-payments\/tokenization\/#recurring-payment-types\">how you want to use tokenization<\/a>. <div class=\"notices green\">If you want to use more than one type of recurring processing model, complete your set up with the type that is most relevant for your business. In the subsequent transactions, you can specify another applicable type.<\/div><\/td>\n<\/tr>\n<tr>\n<td><strong>Require CVC for card payments<\/strong><\/td>\n<td>Whether your shoppers are required to provide the CVC for payments with stored card details. Default is <strong>Yes<\/strong>. When set to <strong>No<\/strong>, processing recurring card payments require additional configuration on our end. Reach out to our <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a> to set this up.<\/td>\n<\/tr>\n<tr>\n<td><strong>Allow multistore tokens<\/strong><\/td>\n<td>Select <strong>Yes<\/strong> to allow shoppers to use their tokenized payment details from a different Magento storefront when making a payment.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<ol start=\"6\">\n<li>Select <strong>Save Config<\/strong> in the upper right corner.<\/li>\n<\/ol>\n<h2>Step 2: Set up recurring contracts in Adyen<\/h2>\n<ol>\n<li>Log in to your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, and switch to your merchant account.<\/li>\n<li>Go to <strong>Developers<\/strong>\u00a0&gt;\u00a0<strong>Additional data<\/strong>.<\/li>\n<li>Under <strong>Card<\/strong>, select the following fields:\n<ul>\n<li><strong>Cardholder name<\/strong><\/li>\n<li><strong>Card bin<\/strong><\/li>\n<li><strong>Card summary<\/strong><\/li>\n<li><strong>Expiry date<\/strong><\/li>\n<li><strong>Variant<\/strong><\/li>\n<\/ul><\/li>\n<li>Under <strong>Payment<\/strong>, select the following field:\n<ul>\n<li><strong>Recurring details<\/strong><\/li>\n<\/ul><\/li>\n<li>Select <strong>Save configuration<\/strong>.<\/li>\n<\/ol>\n<h2>Step 3 (optional): Configure risk settings in Adyen Customer Area<\/h2>\n<p>Optionally, you can apply risk rules to tokenized payments. To configure risk settings that apply to tokenized payments:<\/p>\n<ol>\n<li>Log in to your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, and switch to your merchant account.<\/li>\n<li>Go to <strong>Revenue &amp; risk<\/strong> &gt; <strong>Settings<\/strong>.<\/li>\n<li>Turn on <strong>Exclude recurring transactions from risk evaluation<\/strong>.<\/li>\n<li>Turn off <strong>IP-based risk checks for recurring transactions<\/strong> and <strong>Velocity risk checks for recurring transactions<\/strong>.<\/li>\n<\/ol>\n<h2 id=\"vault-subscription\">Subscription payments<\/h2>\n<p>Adyen's tokens are valued for automatic subscription payments. However, there is no functionality native to Adobe Commerce that supports automatic transactions where the shopper is not present. Implementing subscription payments therefore requires additional integration effort.<\/p>\n<p>Shopper tokens are stored in the <code>vault_payment_token<\/code> database table. For each token, this table includes:<\/p>\n<ul>\n<li><code>shopperReference<\/code>: Stored in Adobe Commerce as the <code>customer_id<\/code>.<\/li>\n<li><code>storedPaymentMethodId<\/code>: Stored in Adobe Commerce as the <code>gateway_token<\/code>.<\/li>\n<\/ul>\n<p>For more information on how to implement automatic subscription payments with Adyen's API, refer to our <a href=\"\/pt\/online-payments\/tokenization\/make-token-payments\">Tokenization guide<\/a>.<\/p>\n<h2>In-person payments<\/h2>\n<p>If you want to save the payments details for payments made in-person, <a href=\"\/pt\/plugins\/adobe-commerce\/set-up-in-person-payments\/#step-5-optional-set-up-recurring-payments\">set up recurring payments for In-person payments<\/a>.<\/p>\n<h2>See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/online-payments\/tokenization\"\n                        target=\"_self\"\n                        >\n                    Tokenization\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/plugins\/adobe-commerce\/set-up-tokenization","articleFields":{"description":"Store your shopper's payment details for later payments.","feedback_component":true,"filters_component":false,"last_edit_on":"14-07-2023 17:27"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/plugins\/adobe-commerce\/set-up-tokenization","title":"Set up tokenization","content":"Adyen's plugin allows you to securely store the payment details of shoppers, giving your returning shoppers a faster checkout experience. We refer to these saved payment details as tokens and storing a shopper's payment details as tokenization.\nTokenization can be done for card, Google Pay, Apple Pay, SEPA, Klarna, PayPal, iDEAL, Payconiq by Bancontact and in-person payments. For additional payment methods to be tokenized, request a new feature on our GitHub page.\nHow it works\nWhen a shopper is making a payment, a Save for my next payment checkbox will appear. If the checkbox is selected, shopper payment details will be securely stored. The plugin uses the Adobe Commerce Vault to store the token information.\nThe shopper can choose express checkout, by selecting an Instant purchase button right next to the product. The shopper will be asked to provide their CVC to complete the payment.\nRequirements\n\nEnable RECURRING_CONTRACT webhooks in your Customer Area.\n\nStep 1: Set up the Vault in Adobe Commerce\n\nLog in to your Adobe Commerce admin panel.\nIn the left navigation bar, go to Stores &gt; Configuration.\nIn the menu, go to Sales &gt; Payment Methods.\nSelect Configure next to Adyen Payments.\nGo to Payment Optimization &gt; Tokenization and fill in the following fields for each payment method you want to tokenize:\n\n\n\n\nField\nDescription\n\n\n\n\nPayment method\nThe payment method that you want to tokenize.\n\n\nEnabled\nSelect Yes to enable tokenization for the payment method.\n\n\nRecurring Processing Model\nSet to CardOnFile, UnscheduledCardOnFile, or Subscription depending on how you want to use tokenization. If you want to use more than one type of recurring processing model, complete your set up with the type that is most relevant for your business. In the subsequent transactions, you can specify another applicable type.\n\n\nRequire CVC for card payments\nWhether your shoppers are required to provide the CVC for payments with stored card details. Default is Yes. When set to No, processing recurring card payments require additional configuration on our end. Reach out to our Support Team to set this up.\n\n\nAllow multistore tokens\nSelect Yes to allow shoppers to use their tokenized payment details from a different Magento storefront when making a payment.\n\n\n\n\nSelect Save Config in the upper right corner.\n\nStep 2: Set up recurring contracts in Adyen\n\nLog in to your Customer Area, and switch to your merchant account.\nGo to Developers\u00a0&gt;\u00a0Additional data.\nUnder Card, select the following fields:\n\nCardholder name\nCard bin\nCard summary\nExpiry date\nVariant\n\nUnder Payment, select the following field:\n\nRecurring details\n\nSelect Save configuration.\n\nStep 3 (optional): Configure risk settings in Adyen Customer Area\nOptionally, you can apply risk rules to tokenized payments. To configure risk settings that apply to tokenized payments:\n\nLog in to your Customer Area, and switch to your merchant account.\nGo to Revenue &amp; risk &gt; Settings.\nTurn on Exclude recurring transactions from risk evaluation.\nTurn off IP-based risk checks for recurring transactions and Velocity risk checks for recurring transactions.\n\nSubscription payments\nAdyen's tokens are valued for automatic subscription payments. However, there is no functionality native to Adobe Commerce that supports automatic transactions where the shopper is not present. Implementing subscription payments therefore requires additional integration effort.\nShopper tokens are stored in the vault_payment_token database table. For each token, this table includes:\n\nshopperReference: Stored in Adobe Commerce as the customer_id.\nstoredPaymentMethodId: Stored in Adobe Commerce as the gateway_token.\n\nFor more information on how to implement automatic subscription payments with Adyen's API, refer to our Tokenization guide.\nIn-person payments\nIf you want to save the payments details for payments made in-person, set up recurring payments for In-person payments.\nSee also\n\n\n                    Tokenization\n                \n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Plugins","lvl2":"Adobe Commerce","lvl3":"Set up tokenization"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/plugins","lvl2":"https:\/\/docs.adyen.com\/pt\/plugins\/adobe-commerce","lvl3":"\/pt\/plugins\/adobe-commerce\/set-up-tokenization"},"levels":4,"category":"Plugins","category_color":"green","tags":["tokenization"]}}