{"title":"Card-on-file network tokens","category":"default","creationDate":1776961628,"content":"<p>Card-on-file network tokens, also called merchant network tokens, occurs when your cardholder saves the card details with a merchant. For example, consider the case when a cardholder enters the card details on a website to complete a purchase or subscribe to a service with recurring payments. <\/p>\n<p>Unless the merchant is PCI compliant, the merchant does not store the raw card details. Instead, the merchant makes a network token request that is forwarded to Adyen.<\/p>\n<h2>Requirements<\/h2>\n<p>Before you begin, make sure that you fulfill the following requirements:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Requirement<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Integration type<\/strong><\/td>\n<td style=\"text-align: left;\">You must have an integration that supports Issuing.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Webhooks<\/strong><\/td>\n<td style=\"text-align: left;\">In your Customer Area, subscribe to the following webhook: <ul><li><span translate=\"no\"><strong>Network token webhook<\/strong><\/span><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Setup steps<\/strong><\/td>\n<td style=\"text-align: left;\">Reach out to your Adyen contact to make sure that you have set up a card manufacturing profile.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>Overview<\/h2>\n<p>The process to create and activate card-on-file network tokens is as follows:<\/p>\n<ol>\n<li>Your cardholder provides the card details to the merchant.<\/li>\n<li>The merchant sends a network token request to the card scheme.<\/li>\n<li>The card scheme sends the network token request to Adyen.<\/li>\n<li>Adyen analyzes and approves the request if all the information in the request is correct.<\/li>\n<li>Adyen sends the network token and the corresponding card details to the card scheme.<\/li>\n<li>The card scheme stores the network token and the corresponding card details.<\/li>\n<li>The card scheme sends the network token to the merchant.<\/li>\n<li>The merchant stores the network token. <\/li>\n<\/ol>\n<p>The following diagram shows the process to create and activate card-on-file network tokens.<\/p>\n<p><a rel=\"lightbox\" href=\"\/user\/pages\/docs\/07.issuing\/19.card-on-file-tokens\/card-on-file-flow.svg\" src=\"\">\n  <img alt=\"\" src=\"\/user\/pages\/docs\/07.issuing\/19.card-on-file-tokens\/card-on-file-flow.svg\" \/>\n<\/a><\/p>\n<p>When your cardholder tries to make a purchase using the stored card details, the process is as follows: <\/p>\n<ol>\n<li>Your cardholder selects the stored card as a payment method.<\/li>\n<li>The merchant sends the network token to the card scheme.<\/li>\n<li>The card scheme sends a request to Adyen to validate the status of the network token.<\/li>\n<li>Adyen validates the status of the network token.<\/li>\n<li>Adyen sends the result of the validation to the card scheme.<\/li>\n<li>If the network token is valid, the card scheme approves the transaction.<\/li>\n<li>The card scheme sends the approval to the merchant.<\/li>\n<\/ol>\n<p>The following diagram shows the payment flow using a card-on-file network token.<\/p>\n<p><a rel=\"lightbox\" href=\"\/user\/pages\/docs\/07.issuing\/19.card-on-file-tokens\/card-on-file-payment.svg\" src=\"\">\n  <img alt=\"\" src=\"\/user\/pages\/docs\/07.issuing\/19.card-on-file-tokens\/card-on-file-payment.svg\" \/>\n<\/a><\/p>\n<h2>Provisioning for card-on-file network tokens<\/h2>\n<p>Provisioning is the process of creating a network token. Provisioning is initiated when a merchant tries to save your cardholder's data for card-on-file payments. <\/p>\n<p>The initial part of the provisioning flow is as follows:<\/p>\n<ol>\n<li>Your user provides the card details to the merchant.<\/li>\n<li>The merchant sends a request to the card scheme to create a network token for the card.<\/li>\n<li>The card scheme forwards the network token request to Adyen.<\/li>\n<\/ol>\n<p>After receiving the request, Adyen creates a network token with status <span translate=\"no\"><strong>inactive<\/strong><\/span>. Adyen then verify the merchant's information with the card scheme. Based on the outcome of the verification, Adyen decides whether to activate the network token.<\/p>\n<p>After receiving the request, Adyen creates an inactive network token. To decide whether to activate the network token, Adyen verify the merchant's information with the card scheme.<\/p>\n<h3>Verification process for provisioning<\/h3>\n<p>Card schemes maintain allowlists of approved merchants that are authorized to use card-on-file network tokens. When Adyen receives a network token request, Adyen verifies that the merchant is on the allowlist of the corresponding card scheme.<\/p>\n<p>The verification results in one of the following outcomes:<\/p>\n<ul>\n<li>If the merchant is on the allowlist, Adyen automatically approves the network token.<\/li>\n<li>If the merchant is <strong>not<\/strong> on the allowlist, Adyen automatically closes the network token and ends the provisioning process.<\/li>\n<\/ul>\n<p>The outcome of the verification process determines the flow of the provisioning process. The following tabs describe the possible flows.<\/p>\n\n<div id=\"tabkmJyK\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Token approved automatically&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;When Adyen approves the network token automatically, the provisioning flow is as follows:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;The provisioning process is initiated.&lt;\\\/li&gt;\\n&lt;li&gt;Adyen creates the network token with an &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;inactive&lt;\\\/strong&gt;&lt;\\\/span&gt; status.&lt;\\\/li&gt;\\n&lt;li&gt;Adyen sends a webhook to inform your server that a network token was created. &lt;\\\/li&gt;\\n&lt;li&gt;Adyen verifies that the merchant is on the allowlist of the card scheme.&lt;\\\/li&gt;\\n&lt;li&gt;If the merchant is on the allowlist, Adyen activates the network token.&lt;\\\/li&gt;\\n&lt;li&gt;Adyen sends a webhook to inform you about the outcome.&lt;\\\/li&gt;\\n&lt;li&gt;Adyen sends the network token and the card details to the card scheme.&lt;\\\/li&gt;\\n&lt;li&gt;The card scheme stores the network token and the card details.&lt;\\\/li&gt;\\n&lt;li&gt;The card scheme sends the network token to the merchant.&lt;\\\/li&gt;\\n&lt;li&gt;The merchant stores the network token.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;The following diagram shows the provisioning flow:&lt;\\\/p&gt;\\n&lt;p&gt;&lt;a rel=\\&quot;lightbox\\&quot; href=\\&quot;\\\/user\\\/pages\\\/docs\\\/07.issuing\\\/19.card-on-file-tokens\\\/cof-token-approved-automatically.svg\\&quot; src=\\&quot;\\&quot;&gt;\\n  &lt;img alt=\\&quot;\\&quot; src=\\&quot;\\\/user\\\/pages\\\/docs\\\/07.issuing\\\/19.card-on-file-tokens\\\/cof-token-approved-automatically.svg\\&quot; \\\/&gt;\\n&lt;\\\/a&gt;&lt;\\\/p&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;token_approved_automatically_0_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Token closed automatically&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;When Adyen closes the network token automatically, the provisioning flow is as follows:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;The provisioning process is initiated.&lt;\\\/li&gt;\\n&lt;li&gt;Adyen creates the network token with an &lt;span translate=\\&quot;no\\&quot;&gt;&lt;strong&gt;inactive&lt;\\\/strong&gt;&lt;\\\/span&gt; status.&lt;\\\/li&gt;\\n&lt;li&gt;Adyen sends a webhook to inform your server that a network token was created.&lt;\\\/li&gt;\\n&lt;li&gt;Adyen verifies that the merchant is on the allowlist of the card scheme.&lt;\\\/li&gt;\\n&lt;li&gt;If the merchant is not on the allowlist, Adyen closes the network token.&lt;\\\/li&gt;\\n&lt;li&gt;Adyen sends a webhook to inform you about the outcome.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;The following diagram shows a provisioning flow that ends after closing a network token.&lt;\\\/p&gt;\\n&lt;p&gt;&lt;a rel=\\&quot;lightbox\\&quot; href=\\&quot;\\\/user\\\/pages\\\/docs\\\/07.issuing\\\/19.card-on-file-tokens\\\/cof-token-closed-automatically.svg\\&quot; src=\\&quot;\\&quot;&gt;\\n  &lt;img alt=\\&quot;\\&quot; src=\\&quot;\\\/user\\\/pages\\\/docs\\\/07.issuing\\\/19.card-on-file-tokens\\\/cof-token-closed-automatically.svg\\&quot; \\\/&gt;\\n&lt;\\\/a&gt;&lt;\\\/p&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;token_closed_automatically_1_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/issuing\/card-on-file-tokens","articleFields":{"description":"Learn the process of creating a network token through card-on-file tokenization.","feedback_component":true,"filters_component":false,"next_steps":[{"title":"Manage network tokens","description":"Learn how to manage network tokens for cards added to digital wallets.","url":"\/issuing\/manage-network-tokens","required":true}],"parameters":{"directoryPath":"\/issuing"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/issuing\/card-on-file-tokens","title":"Card-on-file network tokens","content":"Card-on-file network tokens, also called merchant network tokens, occurs when your cardholder saves the card details with a merchant. For example, consider the case when a cardholder enters the card details on a website to complete a purchase or subscribe to a service with recurring payments. \nUnless the merchant is PCI compliant, the merchant does not store the raw card details. Instead, the merchant makes a network token request that is forwarded to Adyen.\nRequirements\nBefore you begin, make sure that you fulfill the following requirements:\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nYou must have an integration that supports Issuing.\n\n\nWebhooks\nIn your Customer Area, subscribe to the following webhook: Network token webhook\n\n\nSetup steps\nReach out to your Adyen contact to make sure that you have set up a card manufacturing profile.\n\n\n\nOverview\nThe process to create and activate card-on-file network tokens is as follows:\n\nYour cardholder provides the card details to the merchant.\nThe merchant sends a network token request to the card scheme.\nThe card scheme sends the network token request to Adyen.\nAdyen analyzes and approves the request if all the information in the request is correct.\nAdyen sends the network token and the corresponding card details to the card scheme.\nThe card scheme stores the network token and the corresponding card details.\nThe card scheme sends the network token to the merchant.\nThe merchant stores the network token. \n\nThe following diagram shows the process to create and activate card-on-file network tokens.\n\n  \n\nWhen your cardholder tries to make a purchase using the stored card details, the process is as follows: \n\nYour cardholder selects the stored card as a payment method.\nThe merchant sends the network token to the card scheme.\nThe card scheme sends a request to Adyen to validate the status of the network token.\nAdyen validates the status of the network token.\nAdyen sends the result of the validation to the card scheme.\nIf the network token is valid, the card scheme approves the transaction.\nThe card scheme sends the approval to the merchant.\n\nThe following diagram shows the payment flow using a card-on-file network token.\n\n  \n\nProvisioning for card-on-file network tokens\nProvisioning is the process of creating a network token. Provisioning is initiated when a merchant tries to save your cardholder's data for card-on-file payments. \nThe initial part of the provisioning flow is as follows:\n\nYour user provides the card details to the merchant.\nThe merchant sends a request to the card scheme to create a network token for the card.\nThe card scheme forwards the network token request to Adyen.\n\nAfter receiving the request, Adyen creates a network token with status inactive. Adyen then verify the merchant's information with the card scheme. Based on the outcome of the verification, Adyen decides whether to activate the network token.\nAfter receiving the request, Adyen creates an inactive network token. To decide whether to activate the network token, Adyen verify the merchant's information with the card scheme.\nVerification process for provisioning\nCard schemes maintain allowlists of approved merchants that are authorized to use card-on-file network tokens. When Adyen receives a network token request, Adyen verifies that the merchant is on the allowlist of the corresponding card scheme.\nThe verification results in one of the following outcomes:\n\nIf the merchant is on the allowlist, Adyen automatically approves the network token.\nIf the merchant is not on the allowlist, Adyen automatically closes the network token and ends the provisioning process.\n\nThe outcome of the verification process determines the flow of the provisioning process. The following tabs describe the possible flows.\n\n\n    \n        \n        \n    \n\n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Adyen Issuing","lvl2":"Card-on-file network tokens"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/issuing","lvl2":"\/pt\/issuing\/card-on-file-tokens"},"levels":3,"category":"Issuing","category_color":"green","tags":["Card-on-file","network","tokens"]},"articleFiles":{"card-on-file-flow.svg":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/07.issuing\/19.card-on-file-tokens\/card-on-file-flow.svg\" \/>","card-on-file-payment.svg":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/07.issuing\/19.card-on-file-tokens\/card-on-file-payment.svg\" \/>","cof-token-approved-automatically.svg":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/07.issuing\/19.card-on-file-tokens\/cof-token-approved-automatically.svg\" \/>","cof-token-closed-automatically.svg":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/07.issuing\/19.card-on-file-tokens\/cof-token-closed-automatically.svg\" \/>"}}
