{"componentChunkName":"component---src-templates-article-template-tsx","path":"/pe/card-payments/network-tokens","result":{"data":{"article":{"title":"Network Tokens","subtitle":"Cómo funcionan los network tokens en la API de Card Payments de Kushki: trae tu propio token, o deja que Kushki cree uno durante el cargo.","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, \"Un network token es un n\\xFAmero de tarjeta emitido directamente por la red de tarjetas (Visa o Mastercard) que reemplaza el n\\xFAmero real de la tarjeta (PAN) en una transacci\\xF3n. Est\\xE1 ligado a la tarjeta original y se actualiza autom\\xE1ticamente si la tarjeta expira o se reemite, as\\xED que el comercio no necesita pedirle al tarjetahabiente un nuevo n\\xFAmero cuando eso pasa.\"), mdx(\"p\", null, \"Kushki admite network tokens en Colombia, Chile, Per\\xFA y M\\xE9xico de dos formas independientes, y una misma integraci\\xF3n puede usar una, ambas o ninguna en una transacci\\xF3n dada. Ambos caminos aplican al modelo de adquirencia de Kushki.\"), mdx(\"h2\", {\n    \"id\": \"1-trae-tu-propio-network-token-transporte\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#1-trae-tu-propio-network-token-transporte\",\n    \"aria-label\": \"1 trae tu propio network token transporte 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. Trae tu propio network token (Transporte)\"), mdx(\"p\", null, \"\\uD83D\\uDEA7 \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"BETA\")), mdx(\"p\", null, \"Si tu integraci\\xF3n ya obtiene network tokens por su cuenta, por ejemplo desde una wallet digital como \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"/card-payments/apple-pay/configuration\"\n  }, \"Apple Pay\"), \", puedes entregarle ese token a Kushki para que la transacci\\xF3n se procese con \\xE9l en lugar de un PAN tradicional. Esta funci\\xF3n est\\xE1 en BETA: contacta a tu ejecutivo de cuenta de Kushki antes de habilitarla.\"), mdx(\"h3\", {\n    \"id\": \"paso-1-envía-el-network-token-al-solicitar-un-token-de-kushki\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#paso-1-env%C3%ADa-el-network-token-al-solicitar-un-token-de-kushki\",\n    \"aria-label\": \"paso 1 envía el network token al solicitar un token de kushki 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  }))), \"Paso 1. Env\\xEDa el network token al solicitar un token de Kushki\"), mdx(\"p\", null, \"Se env\\xEDa en el request de Solicitar un token de tarjeta (\", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"POST /card/v1/tokens\"), \"), con \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"card.number\"), \" en el n\\xFAmero del network token, \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"card.cryptogram\"), \" con el criptograma, \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"isNetworkToken: true\"), \" y un objeto \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"networkToken\"), \" con los metadatos de wallet y dispositivo:\"), 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, \"Reemplaza \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"currency\"), \" por la moneda de tu pa\\xEDs: \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"COP\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"CLP\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"PEN\"), \" o \", 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  }, \"Campo\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Descripci\\xF3n\"))), 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  }, \"Indica que \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"card.number\"), \" es un network token y no un PAN tradicional.\")), 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  }, \"Criptograma din\\xE1mico del network token, de 20 a 28 caracteres alfanum\\xE9ricos. Es un campo distinto del 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  }, \"Tipo de dispositivo que origina la transacci\\xF3n tokenizada.\")), 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  }, \"ID \\xFAnico que la red de tarjetas asigna al solicitante del token.\")), 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  }, \"Origen del 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  }, \"Identificador de la wallet digital: \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"01\"), \" para Apple Pay, \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"04\"), \" para otras 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  }, \"Nivel de autenticaci\\xF3n realizado durante el aprovisionamiento del token.\")), 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  }, \"Merchant Verification Value de 10 d\\xEDgitos (solo transacciones Visa).\")))), mdx(\"p\", null, \"Tambi\\xE9n puedes enviar estos campos directamente en un cargo sin token (\", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"POST /card/v2/charges\"), \").\"), mdx(CountryContent, {\n    only: \"co\",\n    mdxType: \"CountryContent\"\n  }, mdx(\"p\", null, \"Consulta la referencia completa en \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://api-docs.kushkipagos.com/colombia/online-payments/card-payments/token\"\n  }, \"Solicitar un token de tarjeta\"), \".\")), mdx(CountryContent, {\n    only: \"cl\",\n    mdxType: \"CountryContent\"\n  }, mdx(\"p\", null, \"Consulta la referencia completa en \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://api-docs.kushkipagos.com/chile/online-payments/card-payments/token\"\n  }, \"Solicitar un token de tarjeta\"), \".\")), mdx(CountryContent, {\n    only: \"pe\",\n    mdxType: \"CountryContent\"\n  }, mdx(\"p\", null, \"Consulta la referencia completa en \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://api-docs.kushkipagos.com/peru/online-payments/card-payments/token\"\n  }, \"Solicitar un token de tarjeta\"), \".\")), mdx(CountryContent, {\n    only: \"mx\",\n    mdxType: \"CountryContent\"\n  }, mdx(\"p\", null, \"Consulta la referencia completa en \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://api-docs.kushkipagos.com/mexico/online-payments/card-payments/token\"\n  }, \"Solicitar un token de tarjeta\"), \".\")), mdx(Aside, {\n    title: \"Criptograma y CVV\",\n    type: \"info\",\n    mdxType: \"Aside\"\n  }, mdx(\"p\", null, \"El criptograma se env\\xEDa en \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"card.cryptogram\"), \" y no reemplaza al CVV. Se recomienda enviar tambi\\xE9n \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"card.cvv\"), \": si solo env\\xEDas el criptograma, la tasa de aceptaci\\xF3n puede variar. Confirma con tu wallet o proveedor de tokens si incluyen un criptograma.\")), mdx(\"h3\", {\n    \"id\": \"paso-2-continúa-el-flujo-normal\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#paso-2-contin%C3%BAa-el-flujo-normal\",\n    \"aria-label\": \"paso 2 continúa el flujo normal 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  }))), \"Paso 2. Contin\\xFAa el flujo normal\"), mdx(\"p\", null, \"Usa el \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"token\"), \" que te devolvieron para llamar a Cargo (\", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"POST /card/v1/charges\"), \") o a Preautorizaci\\xF3n (\", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"POST /card/v1/preAuthorization\"), \"). El resto del flujo no cambia.\"), mdx(\"h2\", {\n    \"id\": \"2-deja-que-kushki-cree-uno-creación\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#2-deja-que-kushki-cree-uno-creaci%C3%B3n\",\n    \"aria-label\": \"2 deja que kushki cree uno creación 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. Deja que Kushki cree uno (Creaci\\xF3n)\"), mdx(\"p\", null, \"Si en cambio est\\xE1s tokenizando una tarjeta normal con Kushki, sin traer un n\\xFAmero ya tokenizado, puedes pedirle a Kushki que tambi\\xE9n tokenice esa tarjeta con network token durante el cargo, usando el tokenizador propio de Kushki.\"), mdx(\"h3\", {\n    \"id\": \"paso-1-pídelo-en-el-cargo\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#paso-1-p%C3%ADdelo-en-el-cargo\",\n    \"aria-label\": \"paso 1 pídelo en el cargo 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  }))), \"Paso 1. P\\xEDdelo en el cargo\"), mdx(\"p\", null, \"Incluye \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"\\\"networkToken\\\"\"), \" en el array \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"capabilities\"), \" del request de Cargo (\", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"POST /card/v1/charges\"), \") o de Preautorizaci\\xF3n (\", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"POST /card/v1/preAuthorization\"), \"). Tambi\\xE9n funciona en sus variantes sin token.\"), 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\": \"paso-2-lee-el-objeto-network-en-la-respuesta\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#paso-2-lee-el-objeto-network-en-la-respuesta\",\n    \"aria-label\": \"paso 2 lee el objeto network en la respuesta 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  }))), \"Paso 2. Lee el objeto network en la respuesta\"), mdx(\"p\", null, \"Si la transacci\\xF3n se tokeniz\\xF3 de esta forma, la respuesta incluye un objeto \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"network\"), \" con los detalles del token:\"), 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: \"Requiere un acuerdo comercial\",\n    type: \"info\",\n    mdxType: \"Aside\"\n  }, mdx(\"p\", null, \"La creaci\\xF3n de network tokens se habilita bajo demanda mediante un acuerdo comercial. No todas las transacciones se tokenizan de esta forma aun con el acuerdo activo: revisa el objeto \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"network\"), \" en cada respuesta para saber si esa transacci\\xF3n en particular lo fue.\")), mdx(\"h2\", {\n    \"id\": \"cómo-se-relacionan-los-dos-caminos\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#c%C3%B3mo-se-relacionan-los-dos-caminos\",\n    \"aria-label\": \"cómo se relacionan los dos caminos 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  }))), \"C\\xF3mo se relacionan los dos caminos\"), mdx(\"p\", null, \"Transporte y Creaci\\xF3n responden preguntas distintas:\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Transporte\"), \" controla \", mdx(\"em\", {\n    parentName: \"li\"\n  }, \"qu\\xE9 env\\xEDas\"), \": si el n\\xFAmero de tarjeta en el request es un PAN tradicional o un network token que ya obtuviste por tu cuenta.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Creaci\\xF3n\"), \" controla \", mdx(\"em\", {\n    parentName: \"li\"\n  }, \"qu\\xE9 recibes de vuelta\"), \": si Kushki reporta informaci\\xF3n de network token para esa transacci\\xF3n en la respuesta, usando su propio tokenizador.\")), mdx(\"p\", null, \"Son independientes: usar uno no requiere ni excluye al otro. El objeto \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"network\"), \" en la respuesta del cargo o la preautorizaci\\xF3n refleja lo que pediste en \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"capabilities\"), \" y lo que realmente pas\\xF3 con esa transacci\\xF3n, sin importar por cu\\xE1l camino se obtuvo el token subyacente.\"), mdx(\"h2\", {\n    \"id\": \"referencia-api\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#referencia-api\",\n    \"aria-label\": \"referencia api 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  }))), \"Referencia API\"), 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  }, \"Solicitar un token de tarjeta\"), \": campos \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"isNetworkToken\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"networkToken\"), \" y \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"card.cryptogram\"), \".\"), 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  }, \"Cargo\"), \" y \", mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/colombia/online-payments/card-payments/tokenless-charge\"\n  }, \"Cargo sin token\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"capabilities\"), \" y objeto \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"network\"), \".\"), 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  }, \"Preautorizaci\\xF3n\"), \" y \", mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/colombia/online-payments/card-payments/tokenless-pre-authorization\"\n  }, \"Preautorizaci\\xF3n sin token\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"capabilities\"), \" y objeto \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"network\"), \".\"))), 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  }, \"Solicitar un token de tarjeta\"), \": campos \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"isNetworkToken\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"networkToken\"), \" y \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"card.cryptogram\"), \".\"), 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  }, \"Cargo\"), \" y \", mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/chile/online-payments/card-payments/tokenless-charge\"\n  }, \"Cargo sin token\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"capabilities\"), \" y objeto \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"network\"), \".\"), 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  }, \"Preautorizaci\\xF3n\"), \" y \", mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/chile/online-payments/card-payments/tokenless-pre-authorization\"\n  }, \"Preautorizaci\\xF3n sin token\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"capabilities\"), \" y objeto \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"network\"), \".\"))), 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  }, \"Solicitar un token de tarjeta\"), \": campos \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"isNetworkToken\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"networkToken\"), \" y \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"card.cryptogram\"), \".\"), 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  }, \"Cargo\"), \" y \", mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/peru/online-payments/card-payments/tokenless-charge\"\n  }, \"Cargo sin token\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"capabilities\"), \" y objeto \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"network\"), \".\"), 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  }, \"Preautorizaci\\xF3n\"), \" y \", mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/peru/online-payments/card-payments/tokenless-pre-authorization\"\n  }, \"Preautorizaci\\xF3n sin token\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"capabilities\"), \" y objeto \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"network\"), \".\"))), 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  }, \"Solicitar un token de tarjeta\"), \": campos \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"isNetworkToken\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"networkToken\"), \" y \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"card.cryptogram\"), \".\"), 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  }, \"Cargo\"), \" y \", mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/mexico/online-payments/card-payments/tokenless-charge\"\n  }, \"Cargo sin token\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"capabilities\"), \" y objeto \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"network\"), \".\"), 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  }, \"Preautorizaci\\xF3n\"), \" y \", mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://api-docs.kushkipagos.com/mexico/online-payments/card-payments/tokenless-pre-authorization\"\n  }, \"Preautorizaci\\xF3n sin token\"), \": \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"capabilities\"), \" y objeto \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"network\"), \".\"))), mdx(NextStep, {\n    type: \"recommended\",\n    side: \"right\",\n    link: \"/card-payments/apple-pay/configuration\",\n    title: \"\\xBFUsas Apple Pay?\",\n    mdxType: \"NextStep\"\n  }, mdx(\"p\", null, \"Configura Apple Pay en tu integraci\\xF3n para obtener network tokens desde la wallet del cliente.\")));\n}\n;\nMDXContent.isMDXComponent = true;","excerpt":"Un network token es un número de tarjeta emitido directamente por la red de tarjetas (Visa o Mastercard) que reemplaza el número real de la…","timeToRead":3,"tableOfContents":{"items":[{"url":"#1-trae-tu-propio-network-token-transporte","title":"1. Trae tu propio network token (Transporte)","items":[{"url":"#paso-1-envía-el-network-token-al-solicitar-un-token-de-kushki","title":"Paso 1. Envía el network token al solicitar un token de Kushki"},{"url":"#paso-2-continúa-el-flujo-normal","title":"Paso 2. Continúa el flujo normal"}]},{"url":"#2-deja-que-kushki-cree-uno-creación","title":"2. Deja que Kushki cree uno (Creación)","items":[{"url":"#paso-1-pídelo-en-el-cargo","title":"Paso 1. Pídelo en el cargo"},{"url":"#paso-2-lee-el-objeto-network-en-la-respuesta","title":"Paso 2. Lee el objeto network en la respuesta"}]},{"url":"#cómo-se-relacionan-los-dos-caminos","title":"Cómo se relacionan los dos caminos"},{"url":"#referencia-api","title":"Referencia API"}]}}},"updatedAt":"08 octubre 2026","tabTitle":null}]}},"pageContext":{"country":"pe","id":"6e79fc06-fba2-5c25-bbcd-52b074041e96","locale":"es","localeDateFormat":"DD MMMM YYYY"}},"staticQueryHashes":["1632712422","2408418099","63159454"]}