{"componentChunkName":"component---src-templates-article-template-tsx","path":"/cl/en/card-payments/network-tokens","result":{"data":{"article":{"title":"Network Tokens","subtitle":"How network tokens work in Kushki’s Card Payments API: bring your own token, or let Kushki create one during the charge.","fullWidth":null,"hero":null,"heroTextColor":null,"heroImg":null,"content":[{"body":{"childMdx":{"body":"var _excluded = [\"components\"];\nfunction _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }\nfunction _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }\nfunction _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }\n/* @jsxRuntime classic */\n/* @jsx mdx */\n\nvar _frontmatter = {};\nvar makeShortcode = function makeShortcode(name) {\n  return function MDXDefaultShortcode(props) {\n    console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\");\n    return mdx(\"div\", props);\n  };\n};\nvar CountryContent = makeShortcode(\"CountryContent\");\nvar Aside = makeShortcode(\"Aside\");\nvar NextStep = makeShortcode(\"NextStep\");\nvar layoutProps = {\n  _frontmatter: _frontmatter\n};\nvar MDXLayout = \"wrapper\";\nreturn function MDXContent(_ref) {\n  var components = _ref.components,\n    props = _objectWithoutProperties(_ref, _excluded);\n  return mdx(MDXLayout, _extends({}, layoutProps, props, {\n    components: components,\n    mdxType: \"MDXLayout\"\n  }), mdx(\"p\", null, \"A network token is a card number issued directly by the card network (Visa or Mastercard) that replaces the real card number (PAN) in a transaction. It is tied to the original card and updates automatically if the card expires or is reissued, so the merchant does not need to ask the cardholder for a new number when that happens.\"), mdx(\"p\", null, \"Kushki supports network tokens in Colombia, Chile, Peru, and Mexico in two independent ways, and a single integration can use one, both, or neither on a given transaction. Both paths apply to Kushki\\u2019s acquiring model.\"), mdx(\"h2\", {\n    \"id\": \"1-bring-your-own-network-token-transport\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#1-bring-your-own-network-token-transport\",\n    \"aria-label\": \"1 bring your own network token transport permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"1. Bring your own network token (Transport)\"), mdx(\"p\", null, \"\\uD83D\\uDEA7 \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"BETA\")), mdx(\"p\", null, \"If your integration already obtains network tokens on its own, for example from a digital wallet such as \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"/card-payments/apple-pay/configuration\"\n  }, \"Apple Pay\"), \", you can hand that token to Kushki so the transaction is processed with it instead of a traditional PAN. This feature is in BETA: contact your Kushki account manager before enabling it.\"), mdx(\"h3\", {\n    \"id\": \"step-1-send-the-network-token-when-requesting-a-kushki-token\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#step-1-send-the-network-token-when-requesting-a-kushki-token\",\n    \"aria-label\": \"step 1 send the network token when requesting a kushki token permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"Step 1. Send the network token when requesting a Kushki token\"), mdx(\"p\", null, \"It is sent in the Create a card token request (\", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"POST /card/v1/tokens\"), \"), with \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"card.number\"), \" set to the network token number, \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"card.cryptogram\"), \" set to the cryptogram, \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"isNetworkToken: true\"), \", and a \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"networkToken\"), \" object with the wallet and device metadata:\"), mdx(\"pre\", null, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-json\"\n  }, \"{\\n  \\\"card\\\": {\\n    \\\"name\\\": \\\"Luis Garc\\xEDa\\\",\\n    \\\"number\\\": \\\"4761923458201947\\\",\\n    \\\"expiryMonth\\\": \\\"08\\\",\\n    \\\"expiryYear\\\": \\\"28\\\",\\n    \\\"cvv\\\": \\\"121\\\",\\n    \\\"cryptogram\\\": \\\"AgAAAAAABk4DWZ4C28yUQAAAAAAA\\\"\\n  },\\n  \\\"isNetworkToken\\\": true,\\n  \\\"networkToken\\\": {\\n    \\\"deviceType\\\": \\\"MOBILE\\\",\\n    \\\"requestorId\\\": \\\"98987676501\\\",\\n    \\\"source\\\": \\\"01\\\",\\n    \\\"walletId\\\": \\\"01\\\",\\n    \\\"authenticationLevel\\\": \\\"02\\\"\\n  },\\n  \\\"totalAmount\\\": 150.00,\\n  \\\"currency\\\": \\\"PEN\\\"\\n}\\n\")), mdx(\"p\", null, \"Replace \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"currency\"), \" with your country\\u2019s currency: \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"COP\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"CLP\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"PEN\"), \", or \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"MXN\"), \".\"), mdx(\"table\", null, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Field\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Description\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"isNetworkToken\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Indicates that \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"card.number\"), \" is a network token and not a traditional PAN.\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"card.cryptogram\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Dynamic cryptogram of the network token, 20 to 28 alphanumeric characters. It is a separate field from the CVV.\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"deviceType\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Type of device originating the tokenized transaction.\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"requestorId\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Unique ID that the card network assigns to the token requestor.\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"source\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Source of the token.\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"walletId\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Digital wallet identifier: \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"01\"), \" for Apple Pay, \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"04\"), \" for other wallets.\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"authenticationLevel\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Authentication level performed during token provisioning.\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"mvv\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"10-digit Merchant Verification Value (Visa transactions only).\")))), mdx(\"p\", null, \"You can also send these fields directly in a tokenless charge (\", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"POST /card/v2/charges\"), \").\"), mdx(CountryContent, {\n    only: \"co\",\n    mdxType: \"CountryContent\"\n  }, mdx(\"p\", null, \"See the full reference in \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://api-docs.kushkipagos.com/colombia/online-payments/card-payments/token\"\n  }, \"Create a card token\"), \".\")), mdx(CountryContent, {\n    only: \"cl\",\n    mdxType: \"CountryContent\"\n  }, mdx(\"p\", null, \"See the full reference in \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://api-docs.kushkipagos.com/chile/online-payments/card-payments/token\"\n  }, \"Create a card token\"), \".\")), mdx(CountryContent, {\n    only: \"pe\",\n    mdxType: \"CountryContent\"\n  }, mdx(\"p\", null, \"See the full reference in \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://api-docs.kushkipagos.com/peru/online-payments/card-payments/token\"\n  }, \"Create a card token\"), \".\")), mdx(CountryContent, {\n    only: \"mx\",\n    mdxType: \"CountryContent\"\n  }, mdx(\"p\", null, \"See the full reference in \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://api-docs.kushkipagos.com/mexico/online-payments/card-payments/token\"\n  }, \"Create a card token\"), \".\")), mdx(Aside, {\n    title: \"Cryptogram and CVV\",\n    type: \"info\",\n    mdxType: \"Aside\"\n  }, mdx(\"p\", null, \"The cryptogram is sent in \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"card.cryptogram\"), \" and does not replace the CVV. We recommend also sending \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"card.cvv\"), \": if you send only the cryptogram, the acceptance rate may vary. Check with your wallet or token provider whether they include a cryptogram.\")), mdx(\"h3\", {\n    \"id\": \"step-2-continue-the-normal-flow\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#step-2-continue-the-normal-flow\",\n    \"aria-label\": \"step 2 continue the normal flow permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"Step 2. Continue the normal flow\"), mdx(\"p\", null, \"Use the returned \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"token\"), \" to call Charge (\", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"POST /card/v1/charges\"), \") or Pre-authorization (\", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"POST /card/v1/preAuthorization\"), \"). The rest of the flow does not change.\"), mdx(\"h2\", {\n    \"id\": \"2-let-kushki-create-one-creation\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#2-let-kushki-create-one-creation\",\n    \"aria-label\": \"2 let kushki create one creation permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"2. Let Kushki create one (Creation)\"), mdx(\"p\", null, \"If instead you are tokenizing a regular card with Kushki, without bringing an already tokenized number, you can ask Kushki to also tokenize that card with a network token during the charge, using Kushki\\u2019s own tokenizer.\"), mdx(\"h3\", {\n    \"id\": \"step-1-request-it-in-the-charge\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#step-1-request-it-in-the-charge\",\n    \"aria-label\": \"step 1 request it in the charge permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"Step 1. Request it in the charge\"), mdx(\"p\", null, \"Include \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"\\\"networkToken\\\"\"), \" in the \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"capabilities\"), \" array of the Charge (\", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"POST /card/v1/charges\"), \") or Pre-authorization (\", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"POST /card/v1/preAuthorization\"), \") request. It also works in their tokenless variants.\"), mdx(\"pre\", null, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-json\"\n  }, \"{\\n  \\\"token\\\": \\\"f5c64f7ac8ea42d5a58dcdc74de973dc\\\",\\n  \\\"capabilities\\\": [\\\"networkToken\\\"],\\n  \\\"amount\\\": {\\n    \\\"subtotalIva\\\": 0,\\n    \\\"subtotalIva0\\\": 150.00,\\n    \\\"iva\\\": 0,\\n    \\\"currency\\\": \\\"PEN\\\"\\n  }\\n}\\n\")), mdx(\"h3\", {\n    \"id\": \"step-2-read-the-network-object-in-the-response\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#step-2-read-the-network-object-in-the-response\",\n    \"aria-label\": \"step 2 read the network object in the response permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"Step 2. Read the network object in the response\"), mdx(\"p\", null, \"If the transaction was tokenized this way, the response includes a \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"network\"), \" object with the token details:\"), mdx(\"pre\", null, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-json\"\n  }, \"{\\n  \\\"ticketNumber\\\": \\\"922513792073660814\\\",\\n  \\\"transactionReference\\\": \\\"6f16659e-b711-4995-a9ae-161aecbd6521\\\",\\n  \\\"network\\\": {\\n    \\\"wallet\\\": \\\"cybersource\\\",\\n    \\\"walletId\\\": \\\"04\\\",\\n    \\\"isNetworkToken\\\": true,\\n    \\\"tmsMaskedCardNumber\\\": \\\"549138XXXXXX4509\\\",\\n    \\\"tmsLastFourDigits\\\": \\\"4509\\\",\\n    \\\"tmsBin\\\": \\\"549138\\\",\\n    \\\"tmsIntegration\\\": \\\"kushki\\\"\\n  }\\n}\\n\")), mdx(Aside, {\n    title: \"Requires a commercial agreement\",\n    type: \"info\",\n    mdxType: \"Aside\"\n  }, mdx(\"p\", null, \"Network token creation is enabled on demand through a commercial agreement. Not every transaction is tokenized this way even with the agreement active: check the \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"network\"), \" object in each response to see whether that particular transaction was.\")), mdx(\"h2\", {\n    \"id\": \"how-the-two-paths-relate\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#how-the-two-paths-relate\",\n    \"aria-label\": \"how the two paths relate permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"How the two paths relate\"), mdx(\"p\", null, \"Transport and Creation answer different questions:\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Transport\"), \" controls \", mdx(\"em\", {\n    parentName: \"li\"\n  }, \"what you send\"), \": whether the card number in the request is a traditional PAN or a network token you already obtained on your own.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Creation\"), \" controls \", mdx(\"em\", {\n    parentName: \"li\"\n  }, \"what you get back\"), \": whether Kushki reports network token information for that transaction in the response, using its own tokenizer.\")), mdx(\"p\", null, \"They are independent: using one neither requires nor excludes the other. The \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"network\"), \" object in the charge or pre-authorization response reflects what you requested in \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"capabilities\"), \" and what actually happened to that transaction, regardless of which path the underlying token came from.\"), mdx(\"h2\", {\n    \"id\": \"api-reference\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#api-reference\",\n    \"aria-label\": \"api reference permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"API reference\"), mdx(CountryContent, {\n    only: \"co\",\n    mdxType: \"CountryContent\"\n  }, mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/colombia/online-payments/card-payments/token\"\n  }, \"Create a card token\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"isNetworkToken\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"networkToken\"), \", and \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"card.cryptogram\"), \" fields.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/colombia/online-payments/card-payments/charge\"\n  }, \"Charge\"), \" and \", mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/colombia/online-payments/card-payments/tokenless-charge\"\n  }, \"Tokenless charge\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"capabilities\"), \" and the \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"network\"), \" object.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/colombia/online-payments/card-payments/pre-authorization\"\n  }, \"Pre-authorization\"), \" and \", mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/colombia/online-payments/card-payments/tokenless-pre-authorization\"\n  }, \"Tokenless pre-authorization\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"capabilities\"), \" and the \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"network\"), \" object.\"))), mdx(CountryContent, {\n    only: \"cl\",\n    mdxType: \"CountryContent\"\n  }, mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/chile/online-payments/card-payments/token\"\n  }, \"Create a card token\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"isNetworkToken\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"networkToken\"), \", and \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"card.cryptogram\"), \" fields.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/chile/online-payments/card-payments/charge\"\n  }, \"Charge\"), \" and \", mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/chile/online-payments/card-payments/tokenless-charge\"\n  }, \"Tokenless charge\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"capabilities\"), \" and the \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"network\"), \" object.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/chile/online-payments/card-payments/pre-authorization\"\n  }, \"Pre-authorization\"), \" and \", mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/chile/online-payments/card-payments/tokenless-pre-authorization\"\n  }, \"Tokenless pre-authorization\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"capabilities\"), \" and the \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"network\"), \" object.\"))), mdx(CountryContent, {\n    only: \"pe\",\n    mdxType: \"CountryContent\"\n  }, mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/peru/online-payments/card-payments/token\"\n  }, \"Create a card token\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"isNetworkToken\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"networkToken\"), \", and \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"card.cryptogram\"), \" fields.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/peru/online-payments/card-payments/charge\"\n  }, \"Charge\"), \" and \", mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/peru/online-payments/card-payments/tokenless-charge\"\n  }, \"Tokenless charge\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"capabilities\"), \" and the \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"network\"), \" object.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/peru/online-payments/card-payments/pre-authorization\"\n  }, \"Pre-authorization\"), \" and \", mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/peru/online-payments/card-payments/tokenless-pre-authorization\"\n  }, \"Tokenless pre-authorization\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"capabilities\"), \" and the \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"network\"), \" object.\"))), mdx(CountryContent, {\n    only: \"mx\",\n    mdxType: \"CountryContent\"\n  }, mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/mexico/online-payments/card-payments/token\"\n  }, \"Create a card token\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"isNetworkToken\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"networkToken\"), \", and \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"card.cryptogram\"), \" fields.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/mexico/online-payments/card-payments/charge\"\n  }, \"Charge\"), \" and \", mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/mexico/online-payments/card-payments/tokenless-charge\"\n  }, \"Tokenless charge\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"capabilities\"), \" and the \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"network\"), \" object.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/mexico/online-payments/card-payments/pre-authorization\"\n  }, \"Pre-authorization\"), \" and \", mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/mexico/online-payments/card-payments/tokenless-pre-authorization\"\n  }, \"Tokenless pre-authorization\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"capabilities\"), \" and the \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"network\"), \" object.\"))), mdx(NextStep, {\n    type: \"recommended\",\n    side: \"right\",\n    link: \"/card-payments/apple-pay/configuration\",\n    title: \"Using Apple Pay?\",\n    mdxType: \"NextStep\"\n  }, mdx(\"p\", null, \"Set up Apple Pay in your integration to get network tokens from the customer\\u2019s wallet.\")));\n}\n;\nMDXContent.isMDXComponent = true;","excerpt":"A network token is a card number issued directly by the card network (Visa or Mastercard) that replaces the real card number (PAN) in a…","timeToRead":2,"tableOfContents":{"items":[{"url":"#1-bring-your-own-network-token-transport","title":"1. Bring your own network token (Transport)","items":[{"url":"#step-1-send-the-network-token-when-requesting-a-kushki-token","title":"Step 1. Send the network token when requesting a Kushki token"},{"url":"#step-2-continue-the-normal-flow","title":"Step 2. Continue the normal flow"}]},{"url":"#2-let-kushki-create-one-creation","title":"2. Let Kushki create one (Creation)","items":[{"url":"#step-1-request-it-in-the-charge","title":"Step 1. Request it in the charge"},{"url":"#step-2-read-the-network-object-in-the-response","title":"Step 2. Read the network object in the response"}]},{"url":"#how-the-two-paths-relate","title":"How the two paths relate"},{"url":"#api-reference","title":"API reference"}]}}},"updatedAt":"October 08, 2026","tabTitle":null}]}},"pageContext":{"country":"cl","id":"9d560643-b15b-5fd1-8eec-4c25353195ef","locale":"en","localeDateFormat":"MMMM DD, YYYY"}},"staticQueryHashes":["1632712422","2408418099","63159454"]}