{"componentChunkName":"component---src-templates-article-template-tsx","path":"/co/card-present-payments/kushki-one/payments","result":{"data":{"article":{"title":"Realiza cobros con Kushki One","subtitle":null,"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 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(Aside, {\n    title: \"\\uD83D\\uDEA7 Early Release \\u2014 Beta\",\n    type: \"danger\",\n    mdxType: \"Aside\"\n  }, mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Esta documentaci\\xF3n est\\xE1 en acceso temprano\"), \". Los par\\xE1metros, estructuras de respuesta y comportamientos pueden cambiar sin previo aviso. \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"No\"), \" uses esta versi\\xF3n en producci\\xF3n sin coordinarlo previamente con el equipo de integraciones de Kushki.\")), mdx(\"h1\", {\n    \"id\": \"pagos-con-terminal-smartpos\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h1\",\n    \"href\": \"#pagos-con-terminal-smartpos\",\n    \"aria-label\": \"pagos con terminal smartpos 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  }))), \"Pagos con terminal SmartPOS\"), mdx(\"p\", null, \"La \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Payment API\"), \" te permite procesar cobros presenciales con tarjeta desde tu sistema de caja hacia un terminal Kushki ONE (Sunmi P3, Sunmi P2 SE) en modo Semi-Integrado. El terminal gestiona toda la interacci\\xF3n con el cliente y el chip EMV \\u2014 tu sistema solo env\\xEDa el monto y recibe el resultado.\"), mdx(\"h2\", {\n    \"id\": \"cómo-funciona\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#c%C3%B3mo-funciona\",\n    \"aria-label\": \"cómo funciona 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 funciona\"), mdx(\"p\", null, \"Todos los endpoints comparten la misma estructura de request y respuesta\\nindependientemente de c\\xF3mo conectes tu POS con la terminal. Lo que var\\xEDa\\nentre topolog\\xEDas es \\xFAnicamente el base URL:\"), mdx(\"table\", null, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Topolog\\xEDa\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Base URL\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Red Local (LAN / Wi-Fi)\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"http://{TERMINAL_IP}:6868/terminal/v1/sync\"))), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Nube (Internet) \\u2014 UAT\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"https://uat-cloudt.kushkipagos.com/terminal/v1/{terminalSerial}/sync\"))), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Nube (Internet) \\u2014 Producci\\xF3n\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"https://cloudt.kushkipagos.com/terminal/v1/{terminalSerial}/sync\"))))), mdx(Aside, {\n    type: \"info\",\n    mdxType: \"Aside\"\n  }, mdx(\"p\", null, \"\\xBFNo sabes qu\\xE9 topolog\\xEDa usar? Revisa la secci\\xF3n\\n\", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"/card-present-payments/kushki-one/kushki-one-primeros-pasos#topolog%C3%ADas-de-integraci%C3%B3n-v%C3%ADas-de-comunicaci%C3%B3n\"\n  }, \"Topolog\\xEDas de integraci\\xF3n\"), \"\\nen Primeros Pasos antes de continuar.\")), mdx(Aside, {\n    type: \"info\",\n    mdxType: \"Aside\"\n  }, mdx(\"p\", null, \"La moneda \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"no se incluye en el cuerpo del request\"), \". Se configura por terminal\\nen el sistema de gesti\\xF3n de dispositivos (DMS) durante el onboarding del comercio.\")), mdx(\"h2\", {\n    \"id\": \"endpoints-disponibles\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#endpoints-disponibles\",\n    \"aria-label\": \"endpoints disponibles 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  }))), \"Endpoints disponibles\"), mdx(\"table\", null, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Endpoint\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"M\\xE9todo\"), 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  }, \"/charge\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"POST\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Cobro inmediato: autorizaci\\xF3n y captura en una sola operaci\\xF3n\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"/authorization\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"POST\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Pre-autorizaci\\xF3n: reserva fondos sin capturarlos\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"/capture\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"POST\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Captura los fondos de una pre-autorizaci\\xF3n aprobada\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"/re_authorization\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"POST\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Extiende el monto o la vigencia de una pre-autorizaci\\xF3n activa\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"/pos_tip\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"POST\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Agrega propina a una transacci\\xF3n ya autorizada\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"/void\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"POST\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Anula una transacci\\xF3n el mismo d\\xEDa, antes del corte del procesador\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"/refund\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"POST\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Devuelve fondos de una transacci\\xF3n ya liquidada\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"/abort\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"GET\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Cancela una transacci\\xF3n activa en el terminal de forma inmediata\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"/transaction_search_online\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"POST\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Consulta el historial de transacciones en el adquirente (Kushki)\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"/transaction_search_local\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"POST\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Consulta el historial almacenado localmente en el terminal, sin necesidad de internet\")))), mdx(\"h2\", {\n    \"id\": \"flujos-de-pago\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#flujos-de-pago\",\n    \"aria-label\": \"flujos de pago 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  }))), \"Flujos de pago\"), mdx(\"h3\", {\n    \"id\": \"cobro-directo\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#cobro-directo\",\n    \"aria-label\": \"cobro directo 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  }))), \"Cobro directo\"), mdx(\"p\", null, \"El flujo m\\xE1s com\\xFAn para comercios de retail. El terminal activa el lector de tarjeta y bloquea hasta que el cliente completa la interacci\\xF3n y el adquirente responde.\"), mdx(\"pre\", null, mdx(\"code\", {\n    parentName: \"pre\"\n  }, \"POST /charge  \\u2192  200 OK (approved: true)\\n\")), mdx(\"h3\", {\n    \"id\": \"pre-autorización-y-captura\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#pre-autorizaci%C3%B3n-y-captura\",\n    \"aria-label\": \"pre autorización y captura 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  }))), \"Pre-autorizaci\\xF3n y captura\"), mdx(\"p\", null, \"Ideal para hoteles, gasolineras y restaurantes de cuenta abierta, donde el monto final no se conoce al momento de la interacci\\xF3n con el cliente.\"), mdx(\"pre\", null, mdx(\"code\", {\n    parentName: \"pre\"\n  }, \"POST /authorization  \\u2192  guarda transaction_reference\\n        \\u2193  (d\\xEDas despu\\xE9s)\\nPOST /capture  \\u2192  usando el transaction_reference guardado\\n\")), mdx(Aside, {\n    type: \"danger\",\n    mdxType: \"Aside\"\n  }, mdx(\"p\", null, \"Guarda siempre el campo \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"transaction_reference\"), \" de la respuesta de \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"/authorization\"), \". Es el identificador que necesitas para ejecutar captura, re-autorizaci\\xF3n, anulaci\\xF3n o devoluci\\xF3n sobre esa transacci\\xF3n.\")), mdx(\"h3\", {\n    \"id\": \"vigencia-de-pre-autorizaciones\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#vigencia-de-pre-autorizaciones\",\n    \"aria-label\": \"vigencia de pre autorizaciones 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  }))), \"Vigencia de pre-autorizaciones\"), mdx(\"table\", null, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Tipo de tarjeta\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Vigencia desde la autorizaci\\xF3n\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"D\\xE9bito (Visa / Mastercard)\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"7 d\\xEDas\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Cr\\xE9dito (Visa / Mastercard)\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"28 d\\xEDas\")))), mdx(\"p\", null, \"La captura puede ser hasta el \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"110%\"), \" del monto total autorizado (autorizaci\\xF3n + re-autorizaciones). Solo se permite \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"una captura\"), \" por ciclo de autorizaci\\xF3n.\"), mdx(\"h2\", {\n    \"id\": \"conceptos-clave\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#conceptos-clave\",\n    \"aria-label\": \"conceptos clave 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  }))), \"Conceptos clave\"), mdx(\"h3\", {\n    \"id\": \"client_transaction_id\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#client_transaction_id\",\n    \"aria-label\": \"client_transaction_id 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  }))), \"client_transaction_id\"), mdx(\"p\", null, \"Identificador \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"UUID v4\"), \" generado por tu sistema de caja. Act\\xFAa como clave de idempotencia: si el terminal ya proces\\xF3 ese ID, detecta el duplicado y evita el doble cobro. Genera uno \\xFAnico por intento y reutil\\xEDzalo solo si est\\xE1s reintentando exactamente la misma operaci\\xF3n.\"), mdx(\"h3\", {\n    \"id\": \"transaction_reference\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#transaction_reference\",\n    \"aria-label\": \"transaction_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  }))), \"transaction_reference\"), mdx(\"p\", null, \"Identificador generado por Kushki y retornado en la respuesta de cada transacci\\xF3n aprobada. Es el v\\xEDnculo entre operaciones del mismo ciclo de vida. Persiste este valor en tu sistema \\u2014 sin \\xE9l no puedes capturar, re-autorizar, anular ni devolver.\"), mdx(\"h3\", {\n    \"id\": \"estructura-de-monto\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#estructura-de-monto\",\n    \"aria-label\": \"estructura de monto 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  }))), \"Estructura de monto\"), mdx(\"p\", null, \"Todos los endpoints que involucran un monto usan el mismo objeto \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"amount\"), \".\"), 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  }, \"Tipo\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Req.\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Endpoints\"), 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  }, \"iva\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"number\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"\\u2705\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Todos\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Impuesto al valor agregado. Usa \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"0\"), \" si no aplica\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"subtotal_iva\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"number\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"\\u2705\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Todos\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Subtotal que incluye IVA\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"subtotal_iva0\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"number\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"\\u2705\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Todos\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Subtotal exento de IVA. Monto principal de la transacci\\xF3n\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"tip\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"number\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"\\u274C\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Solo \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"/pos_tip\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Monto de propina. No enviar en \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"/charge\"), \" ni \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"/authorization\"))), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"extra_taxes\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"object\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"\\u274C\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"/charge\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"/authorization\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"/pos_tip\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Impuestos adicionales: \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"airport_tax\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"iac\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"ice\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"travel_agency\"))))), mdx(Aside, {\n    type: \"warning\",\n    title: \"Propina en el monto\",\n    mdxType: \"Aside\"\n  }, mdx(\"p\", null, \"El campo \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"tip\"), \" \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"solo es v\\xE1lido en \", mdx(\"inlineCode\", {\n    parentName: \"strong\"\n  }, \"/pos_tip\")), \". Enviarlo en \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"/charge\"), \" o\\n\", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"/authorization\"), \" retornar\\xE1 un error de validaci\\xF3n. Si el terminal tiene propina\\nhabilitada en el DMS, la captura de propina ocurre de forma autom\\xE1tica dentro\\ndel flujo de pago \\u2014 sin que tu sistema deba enviar ese campo.\")), mdx(\"h2\", {\n    \"id\": \"autenticación\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#autenticaci%C3%B3n\",\n    \"aria-label\": \"autenticació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  }))), \"Autenticaci\\xF3n\"), mdx(\"p\", null, \"Incluye estos headers en cada request:\"), mdx(\"table\", null, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Header\"), 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  }, \"Authorization\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Firma HMAC-SHA256 calculada sobre el cuerpo del request usando tu \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"Private-Credential-Id\"))), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"timestamp\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Unix timestamp en milisegundos\")))), mdx(\"h2\", {\n    \"id\": \"anulaciones-y-devoluciones\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#anulaciones-y-devoluciones\",\n    \"aria-label\": \"anulaciones y devoluciones 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  }))), \"Anulaciones y devoluciones\"), mdx(\"table\", null, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Operaci\\xF3n\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Cu\\xE1ndo usarla\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"strong\", {\n    parentName: \"td\"\n  }, \"Void\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Mismo d\\xEDa de la transacci\\xF3n, antes del horario de corte del procesador\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"strong\", {\n    parentName: \"td\"\n  }, \"Refund\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Una vez que la transacci\\xF3n ya fue liquidada, o si se super\\xF3 el horario de corte\")))), mdx(Aside, {\n    type: \"danger\",\n    mdxType: \"Aside\"\n  }, mdx(\"p\", null, \"Si intentas anular una transacci\\xF3n despu\\xE9s del horario de corte, la operaci\\xF3n \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"no es un void\"), \" \\u2014 cae autom\\xE1ticamente en el ciclo de \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"refund\"), \" y puede tomar d\\xEDas h\\xE1biles en reflejarse. Los horarios de corte por pa\\xEDs son:\"), mdx(\"table\", null, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Pa\\xEDs\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Horario de corte (hora local)\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Chile\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"23:59 del d\\xEDa de la transacci\\xF3n\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Per\\xFA\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"23:59 del d\\xEDa de la transacci\\xF3n\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"M\\xE9xico\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"22:59 del d\\xEDa de la transacci\\xF3n\")))), mdx(\"p\", null, \"Confirma los horarios exactos con el equipo de integraciones de Kushki antes de salir a producci\\xF3n.\")), mdx(\"h2\", {\n    \"id\": \"referencia-de-endpoints\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#referencia-de-endpoints\",\n    \"aria-label\": \"referencia de endpoints 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 de endpoints\"), mdx(\"h3\", {\n    \"id\": \"charge--cobro-directo\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#charge--cobro-directo\",\n    \"aria-label\": \"charge  cobro directo 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  }))), \"Charge \\u2014 Cobro directo\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"strong\"\n  }, \"POST /terminal/v1/sync/charge\"))), mdx(\"p\", null, \"Autorizaci\\xF3n y captura en una sola operaci\\xF3n. El terminal activa el lector de tarjeta al recibir el request y bloquea hasta que el cliente completa la interacci\\xF3n. \\xDAsalo como flujo est\\xE1ndar para la mayor\\xEDa de los comercios de retail.\"), mdx(\"p\", null, mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://api-docs.kushkipagos.com/docs/kushki-one/dorm4255icno5-charge\"\n  }, \"Ver referencia completa \\u2192\")), mdx(\"hr\", null), mdx(\"h3\", {\n    \"id\": \"authorization--pre-autorización\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#authorization--pre-autorizaci%C3%B3n\",\n    \"aria-label\": \"authorization  pre autorizació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  }))), \"Authorization \\u2014 Pre-autorizaci\\xF3n\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"strong\"\n  }, \"POST /terminal/v1/sync/authorization\"))), mdx(\"p\", null, \"Reserva fondos en la cuenta del tarjetahabiente sin capturarlos. Usa este flujo cuando el monto final no se conoce al momento de la interacci\\xF3n con el cliente: hoteles, gasolineras, restaurantes de cuenta abierta.\"), mdx(\"p\", null, mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://api-docs.kushkipagos.com/docs/kushki-one/ndy5zw5236az8-authorization-pre-auth\"\n  }, \"Ver referencia completa \\u2192\")), mdx(\"hr\", null), mdx(\"h3\", {\n    \"id\": \"capture--captura\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#capture--captura\",\n    \"aria-label\": \"capture  captura 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  }))), \"Capture \\u2014 Captura\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"strong\"\n  }, \"POST /terminal/v1/sync/capture\"))), mdx(\"p\", null, \"Cobra los fondos reservados por una autorizaci\\xF3n previa. Requiere el \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"transaction_reference\"), \" retornado en la respuesta de \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"/authorization\"), \". El monto a capturar puede ser igual o menor al autorizado, hasta un m\\xE1ximo del 110% del total (autorizaci\\xF3n + re-autorizaciones).\"), mdx(\"p\", null, mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://api-docs.kushkipagos.com/docs/kushki-one/kba2mg424azz7-capture\"\n  }, \"Ver referencia completa \\u2192\")), mdx(\"hr\", null), mdx(\"h3\", {\n    \"id\": \"re-authorization--re-autorización\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#re-authorization--re-autorizaci%C3%B3n\",\n    \"aria-label\": \"re authorization  re autorizació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  }))), \"Re-authorization \\u2014 Re-autorizaci\\xF3n\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"strong\"\n  }, \"POST /terminal/v1/sync/re_authorization\"))), mdx(\"p\", null, \"Extiende el monto reservado o la vigencia de una pre-autorizaci\\xF3n activa antes de la captura. Se puede ejecutar m\\xFAltiples veces sobre la misma autorizaci\\xF3n base. Env\\xEDa \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"subtotal_iva0: 0\"), \" para extender solo la vigencia sin modificar el monto.\"), mdx(\"p\", null, mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://api-docs.kushkipagos.com/docs/kushki-one/2dmv6unyecpc2-re-authorization\"\n  }, \"Ver referencia completa \\u2192\")), mdx(\"hr\", null), mdx(\"h3\", {\n    \"id\": \"post-tip--propina-posterior\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#post-tip--propina-posterior\",\n    \"aria-label\": \"post tip  propina posterior 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  }))), \"Post-tip \\u2014 Propina posterior\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"strong\"\n  }, \"POST /terminal/v1/sync/pos_tip\"))), mdx(\"p\", null, \"Agrega una propina a una transacci\\xF3n que ya fue autorizada. \\xDAsalo en flujos donde el cliente decide el monto de propina despu\\xE9s del cobro inicial. Env\\xEDa el monto de propina en \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"amount.tip\"), \".\"), mdx(\"p\", null, mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://api-docs.kushkipagos.com/docs/kushki-one/urhrqchi1o8jw-post-tip\"\n  }, \"Ver referencia completa \\u2192\")), mdx(\"hr\", null), mdx(\"h3\", {\n    \"id\": \"void--anulación\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#void--anulaci%C3%B3n\",\n    \"aria-label\": \"void  anulació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  }))), \"Void \\u2014 Anulaci\\xF3n\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"strong\"\n  }, \"POST /terminal/v1/sync/void\"))), mdx(\"p\", null, \"Cancela una transacci\\xF3n el mismo d\\xEDa antes del corte del procesador. El monto nunca se debita de la cuenta del cliente. Espera al menos 1 minuto despu\\xE9s de la transacci\\xF3n original antes de ejecutar un void.\"), mdx(\"p\", null, mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://api-docs.kushkipagos.com/docs/kushki-one/pvqtez7pc86kb-void\"\n  }, \"Ver referencia completa \\u2192\")), mdx(\"hr\", null), mdx(\"h3\", {\n    \"id\": \"refund--devolución\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#refund--devoluci%C3%B3n\",\n    \"aria-label\": \"refund  devolució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  }))), \"Refund \\u2014 Devoluci\\xF3n\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"strong\"\n  }, \"POST /terminal/v1/sync/refund\"))), mdx(\"p\", null, \"Reembolsa una transacci\\xF3n ya capturada y liquidada. Puede ejecutarse d\\xEDas despu\\xE9s del cobro original. Requiere el \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"transaction_reference\"), \" de la respuesta del cobro o captura original.\"), mdx(\"p\", null, mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://api-docs.kushkipagos.com/docs/kushki-one/14uen1b82zvke-refund\"\n  }, \"Ver referencia completa \\u2192\")), mdx(\"hr\", null), mdx(\"h3\", {\n    \"id\": \"abort--cancelar-transacción-activa\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#abort--cancelar-transacci%C3%B3n-activa\",\n    \"aria-label\": \"abort  cancelar transacción activa 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  }))), \"Abort \\u2014 Cancelar transacci\\xF3n activa\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"strong\"\n  }, \"GET /terminal/v1/sync/abort\"))), mdx(\"p\", null, \"Cancela de forma inmediata cualquier transacci\\xF3n en progreso en el terminal. No requiere cuerpo en el request. Ll\\xE1malo solo mientras una transacci\\xF3n est\\xE9 activa \\u2014 despu\\xE9s de que complet\\xF3 (aprobada o declinada) retorna \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"409 Conflict\"), \".\"), mdx(\"p\", null, mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://api-docs.kushkipagos.com/docs/kushki-one/ami2x050pv5li-abort\"\n  }, \"Ver referencia completa \\u2192\")), mdx(\"hr\", null), mdx(\"h3\", {\n    \"id\": \"transaction-search--consulta-de-historial\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#transaction-search--consulta-de-historial\",\n    \"aria-label\": \"transaction search  consulta de historial 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  }))), \"Transaction Search \\u2014 Consulta de historial\"), mdx(\"p\", null, \"Kushki ONE ofrece dos variantes de b\\xFAsqueda seg\\xFAn el origen de los datos:\"), mdx(\"hr\", null), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"strong\"\n  }, \"POST /terminal/v1/sync/transaction_search_online\"))), mdx(\"p\", null, \"Consulta el historial de transacciones directamente en el adquirente (Kushki).\\nRetorna los datos m\\xE1s completos y actualizados. Requiere conexi\\xF3n a internet.\\nLos resultados son paginados y se pueden filtrar por tarjeta, rango de fechas\\no tipo de operaci\\xF3n.\"), mdx(\"p\", null, mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://api-docs.kushkipagos.com/docs/kushki-one/transaction-search-online\"\n  }, \"Ver referencia completa \\u2192\")), mdx(\"hr\", null), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"strong\"\n  }, \"POST /terminal/v1/sync/transaction_search_local\"))), mdx(\"p\", null, \"Consulta el historial almacenado localmente en la terminal. \\xDAtil para\\nreconciliaci\\xF3n offline o cuando el backend del adquirente no est\\xE1 disponible.\\nNo incluye el campo \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"transaction_type\"), \" como filtro.\"), mdx(\"p\", null, mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://api-docs.kushkipagos.com/docs/kushki-one/transaction-search-local\"\n  }, \"Ver referencia completa \\u2192\")), mdx(\"h2\", {\n    \"id\": \"buenas-prácticas\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#buenas-pr%C3%A1cticas\",\n    \"aria-label\": \"buenas prácticas 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  }))), \"Buenas pr\\xE1cticas\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Genera un \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"client_transaction_id\"), \" \\xFAnico por intento. Reutil\\xEDzalo solo en reintentos de la misma operaci\\xF3n l\\xF3gica.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Persiste \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"transaction_reference\"), \" en tu base de datos inmediatamente al recibir la respuesta de autorizaci\\xF3n.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Verifica que los campos de \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"amount\"), \" sumen correctamente antes de enviar el request.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Registra el \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"client_transaction_id\"), \" enviado y el c\\xF3digo HTTP recibido en cada operaci\\xF3n para facilitar la conciliaci\\xF3n y el soporte.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Usa \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"abort\"), \" solo mientras una transacci\\xF3n est\\xE1 activa en el terminal \\u2014 llamarlo despu\\xE9s de que complet\\xF3 retorna \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"409 Conflict\"), \".\")), mdx(NextStep, {\n    type: \"recommended\",\n    side: \"left\",\n    link: \"/card-present-payments/kushki-one/error-catalog-kushkione\",\n    title: \"Cat\\xE1logo de errores\",\n    mdxType: \"NextStep\"\n  }, mdx(\"p\", null, \"Consulta los modelos de error, c\\xF3digos y acciones correctivas recomendadas para todos los endpoints de la Payment API en el \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"/card-present-payments/kushki-one/error-catalog-kushkione\"\n  }, \"Cat\\xE1logo de errores de Kushki ONE\"), \".\")));\n}\n;\nMDXContent.isMDXComponent = true;","excerpt":"Esta documentación está en acceso temprano . Los parámetros, estructuras de respuesta y comportamientos pueden cambiar sin previo aviso.  No…","timeToRead":4,"tableOfContents":{"items":[{"url":"#pagos-con-terminal-smartpos","title":"Pagos con terminal SmartPOS","items":[{"url":"#cómo-funciona","title":"Cómo funciona"},{"url":"#endpoints-disponibles","title":"Endpoints disponibles"},{"url":"#flujos-de-pago","title":"Flujos de pago","items":[{"url":"#cobro-directo","title":"Cobro directo"},{"url":"#pre-autorización-y-captura","title":"Pre-autorización y captura"},{"url":"#vigencia-de-pre-autorizaciones","title":"Vigencia de pre-autorizaciones"}]},{"url":"#conceptos-clave","title":"Conceptos clave","items":[{"url":"#client_transaction_id","title":"client_transaction_id"},{"url":"#transaction_reference","title":"transaction_reference"},{"url":"#estructura-de-monto","title":"Estructura de monto"}]},{"url":"#autenticación","title":"Autenticación"},{"url":"#anulaciones-y-devoluciones","title":"Anulaciones y devoluciones"},{"url":"#referencia-de-endpoints","title":"Referencia de endpoints","items":[{"url":"#charge--cobro-directo","title":"Charge — Cobro directo"},{"url":"#authorization--pre-autorización","title":"Authorization — Pre-autorización"},{"url":"#capture--captura","title":"Capture — Captura"},{"url":"#re-authorization--re-autorización","title":"Re-authorization — Re-autorización"},{"url":"#post-tip--propina-posterior","title":"Post-tip — Propina posterior"},{"url":"#void--anulación","title":"Void — Anulación"},{"url":"#refund--devolución","title":"Refund — Devolución"},{"url":"#abort--cancelar-transacción-activa","title":"Abort — Cancelar transacción activa"},{"url":"#transaction-search--consulta-de-historial","title":"Transaction Search — Consulta de historial"}]},{"url":"#buenas-prácticas","title":"Buenas prácticas"}]}]}}},"updatedAt":"31 marzo 2026","tabTitle":null}]}},"pageContext":{"country":"co","id":"0c6d4467-2027-53c9-9598-b017b7e318bd","locale":"es","localeDateFormat":"DD MMMM YYYY"}},"staticQueryHashes":["1632712422","2408418099","63159454"]}