{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Gestión de comercios","description":"QRwey! API es un API que te permite intenciones de autofactura con QRs para ser leidos en la App de QRwey!.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"gestión-de-comercios","__idx":0},"children":["Gestión de comercios"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Un ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["comercio"]}," representa un punto de venta asociado a un ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["emisor"]}," (RFC)."," ","Cada comercio puede tener sus propias llaves CSD para facturar, un logotipo"," ","personalizado y una API Key para operar con los endpoints de generación de QR."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"crear-comercio","__idx":1},"children":["Crear comercio"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint","__idx":2},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /v1/qrs/merchants\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Host (DEV):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://api-dev.qrwey.com\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Host (PROD):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://api.qrwey.com\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"headers-requeridos","__idx":3},"children":["Headers requeridos"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer {{access_token}}\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-body","__idx":4},"children":["Request body"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["issuerId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ID del emisor al que se asocia el comercio (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nombre del comercio"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billingProfile"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Perfil de facturación (ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FUEL"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GENERAL"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billingProfileData"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Datos adicionales del perfil de facturación (opcional)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contactEmail"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Correo electrónico de contacto"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contactPhoneNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Teléfono de contacto"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Objeto con los datos del domicilio"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address.street"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Calle del domicilio"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address.exteriorNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Número exterior"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address.interiorNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Número interior"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address.neighborhood"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Colonia"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address.city"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ciudad"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address.state"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Estado"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address.zipCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Código postal"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Estado inicial: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTIVE"]}," o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INACTIVE"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev","__idx":5},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://api-dev.qrwey.com/v1/qrs/merchants\" \\\n  -H \"Authorization: Bearer {{access_token}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"issuerId\": \"inv_data_4aca0361cfcd41c097663db44008fbb9\",\n    \"merchantName\": \"Estación Reforma Centro\",\n    \"billingProfile\": \"FUEL\",\n    \"contactEmail\": \"contacto@estacion-reforma.com\",\n    \"contactPhoneNumber\": \"5551234567\",\n    \"address\": {\n      \"street\": \"Av. Paseo de la Reforma\",\n      \"exteriorNumber\": \"222\",\n      \"interiorNumber\": null,\n      \"neighborhood\": \"Juarez\",\n      \"city\": \"Ciudad de México\",\n      \"state\": \"CDMX\",\n      \"zipCode\": \"06600\"\n    },\n    \"status\": \"ACTIVE\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"respuesta","__idx":6},"children":["Respuesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"merchantId\": \"mer_4aca0361cfcd41c097663db44008fbb9\",\n  \"externalMerchantId\": \"ext_001\",\n  \"merchantName\": \"Estación Reforma Centro\",\n  \"billingProfile\": \"FUEL\",\n  \"billingProfileData\": null,\n  \"contactEmail\": \"contacto@estacion-reforma.com\",\n  \"contactPhoneNumber\": \"5551234567\",\n  \"invoiceLogoUrl\": null,\n  \"invoiceLogoFileName\": null,\n  \"appLogoUrl\": null,\n  \"appLogoFileName\": null,\n  \"logoAnimation\": \"NONE\",\n  \"address\": {\n    \"street\": \"Av. Paseo de la Reforma\",\n    \"exteriorNumber\": \"222\",\n    \"interiorNumber\": null,\n    \"neighborhood\": \"Juarez\",\n    \"city\": \"Ciudad de México\",\n    \"state\": \"CDMX\",\n    \"zipCode\": \"06600\"\n  },\n  \"status\": \"ACTIVE\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"campos-de-la-respuesta-merchant","__idx":7},"children":["Campos de la respuesta (Merchant)"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificador único del comercio"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["externalMerchantId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificador externo del comercio"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nombre del comercio"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billingProfile"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Perfil de facturación"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billingProfileData"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Datos adicionales del perfil de facturación"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contactEmail"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Correo electrónico de contacto"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contactPhoneNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Teléfono de contacto"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoiceLogoUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL del logotipo para facturas"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoiceLogoFileName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nombre del archivo del logotipo de factura"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appLogoUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL del logotipo para la app"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appLogoFileName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nombre del archivo del logotipo de la app"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["logoAnimation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tipo de animación del logo"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Objeto con los datos del domicilio"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Estado del comercio: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTIVE"]}," o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INACTIVE"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"listar-comercios","__idx":8},"children":["Listar comercios"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-1","__idx":9},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /v1/qrs/merchants\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"headers-requeridos-1","__idx":10},"children":["Headers requeridos"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer {{access_token}}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"query-params","__idx":11},"children":["Query params"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parámetro"},"children":["Parámetro"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["issuerId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ID del emisor (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filter"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Texto para filtrar por nombre (default: vacío)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Número de página (default: 0)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["size"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Elementos por página (default: 20)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev-1","__idx":12},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api-dev.qrwey.com/v1/qrs/merchants?issuerId=inv_data_4aca0361cfcd41c097663db44008fbb9&page=0&size=10\" \\\n  -H \"Authorization: Bearer {{access_token}}\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"respuesta-1","__idx":13},"children":["Respuesta"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["El listado devuelve una versión resumida del comercio (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MerchantSummary"]},"):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"content\": [\n    {\n      \"merchantId\": \"mer_4aca0361cfcd41c097663db44008fbb9\",\n      \"merchantName\": \"Estación Reforma Centro\",\n      \"city\": \"Ciudad de México\",\n      \"state\": \"CDMX\",\n      \"invoiceLogoUrl\": \"https://cdn.qrwey.com/logos/mer_invoice_4aca0361.png\",\n      \"appLogoUrl\": \"https://cdn.qrwey.com/logos/mer_app_4aca0361.png\",\n      \"status\": \"ACTIVE\"\n    }\n  ],\n  \"totalElements\": 1,\n  \"totalPages\": 1,\n  \"number\": 0,\n  \"size\": 10\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"campos-de-merchantsummary","__idx":14},"children":["Campos de MerchantSummary"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificador único del comercio"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nombre del comercio"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["city"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ciudad del comercio"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["state"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Estado del comercio"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoiceLogoUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL del logotipo para facturas"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appLogoUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL del logotipo para la app"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Estado del comercio: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTIVE"]}," o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INACTIVE"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"obtener-comercio-por-id","__idx":15},"children":["Obtener comercio por ID"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-2","__idx":16},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /v1/qrs/merchants/{merchantId}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"headers-requeridos-2","__idx":17},"children":["Headers requeridos"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer {{access_token}}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev-2","__idx":18},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api-dev.qrwey.com/v1/qrs/merchants/mer_4aca0361cfcd41c097663db44008fbb9\" \\\n  -H \"Authorization: Bearer {{access_token}}\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"actualizar-comercio","__idx":19},"children":["Actualizar comercio"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-3","__idx":20},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"PUT /v1/qrs/merchants/{merchantId}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"headers-requeridos-3","__idx":21},"children":["Headers requeridos"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer {{access_token}}\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Los campos del request body son los mismos que al crear (excepto ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["issuerId"]},")."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev-3","__idx":22},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X PUT \"https://api-dev.qrwey.com/v1/qrs/merchants/mer_4aca0361cfcd41c097663db44008fbb9\" \\\n  -H \"Authorization: Bearer {{access_token}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"merchantName\": \"Estación Reforma Centro Actualizado\",\n    \"contactEmail\": \"nuevo-contacto@estacion-reforma.com\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"subir-logos-del-comercio","__idx":23},"children":["Subir logos del comercio"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sube o actualiza los logotipos (factura y app) de un comercio existente."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-4","__idx":24},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /v1/qrs/merchants/{merchantId}/logos\n"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Este endpoint usa ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["multipart/form-data"]}," para la carga de archivos."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"headers-requeridos-4","__idx":25},"children":["Headers requeridos"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer {{access_token}}\nContent-Type: multipart/form-data\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"campos-del-formulario","__idx":26},"children":["Campos del formulario"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoiceLogo"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Archivo de imagen para el logo de factura (opcional)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appLogo"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Archivo de imagen para el logo de la app (opcional)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["logoAnimation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tipo de animación del logo (ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NONE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOUNCE"]},") (opcional)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev-4","__idx":27},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://api-dev.qrwey.com/v1/qrs/merchants/mer_4aca0361cfcd41c097663db44008fbb9/logos\" \\\n  -H \"Authorization: Bearer {{access_token}}\" \\\n  -F \"invoiceLogo=@/path/to/invoice-logo.png\" \\\n  -F \"appLogo=@/path/to/app-logo.png\" \\\n  -F \"logoAnimation=NONE\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"respuesta-2","__idx":28},"children":["Respuesta"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retorna el objeto ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Merchant"]}," completo con las URLs de los logos actualizadas."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"activar-comercio","__idx":29},"children":["Activar comercio"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-5","__idx":30},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"PUT /v1/qrs/merchants/{merchantId}/status/active\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev-5","__idx":31},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X PUT \"https://api-dev.qrwey.com/v1/qrs/merchants/mer_4aca0361cfcd41c097663db44008fbb9/status/active\" \\\n  -H \"Authorization: Bearer {{access_token}}\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"desactivar-comercio","__idx":32},"children":["Desactivar comercio"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-6","__idx":33},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"PUT /v1/qrs/merchants/{merchantId}/status/inactive\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev-6","__idx":34},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X PUT \"https://api-dev.qrwey.com/v1/qrs/merchants/mer_4aca0361cfcd41c097663db44008fbb9/status/inactive\" \\\n  -H \"Authorization: Bearer {{access_token}}\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Desactivar un comercio impide que genere nuevos QRs y facture. Las transacciones existentes no se afectan."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"guardar-llaves-csd-modelo-de-facturación","__idx":35},"children":["Guardar llaves CSD (modelo de facturación)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Configura las llaves del Certificado de Sello Digital (CSD) para que el comercio pueda timbrar CFDIs."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-7","__idx":36},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /v1/qrs/merchants/{merchantId}/invoice-mode\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"headers-requeridos-5","__idx":37},"children":["Headers requeridos"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer {{access_token}}\nContent-Type: multipart/form-data\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"campos-del-formulario-1","__idx":38},"children":["Campos del formulario"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["csdDataRequest.cerFile"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Archivo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".cer"]}," del CSD (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["csdDataRequest.keyFile"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Archivo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".key"]}," del CSD (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["csdDataRequest.password"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contraseña de la llave privada (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["csdDataRequest.serialNumberPrefix"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Prefijo para el número de serie de los CFDIs (opcional)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev-7","__idx":39},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://api-dev.qrwey.com/v1/qrs/merchants/mer_4aca0361cfcd41c097663db44008fbb9/invoice-mode\" \\\n  -H \"Authorization: Bearer {{access_token}}\" \\\n  -F \"csdDataRequest.cerFile=@/path/to/certificado.cer\" \\\n  -F \"csdDataRequest.keyFile=@/path/to/llave.key\" \\\n  -F \"csdDataRequest.password=MiContrasenaSegura123\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"actualizar-llaves-csd","__idx":40},"children":["Actualizar llaves CSD"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-8","__idx":41},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"PUT /v1/qrs/merchants/{merchantId}/invoice-mode\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Mismos campos que al guardar. Usa este endpoint cuando necesites renovar las llaves CSD."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"obtener-modelo-de-facturación","__idx":42},"children":["Obtener modelo de facturación"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-9","__idx":43},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /v1/qrs/merchants/{merchantId}/invoice-mode\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev-8","__idx":44},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api-dev.qrwey.com/v1/qrs/merchants/mer_4aca0361cfcd41c097663db44008fbb9/invoice-mode\" \\\n  -H \"Authorization: Bearer {{access_token}}\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"respuesta-3","__idx":45},"children":["Respuesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"merchantId\": \"mer_4aca0361cfcd41c097663db44008fbb9\",\n  \"invoiceType\": \"QRWEY\",\n  \"csdDataRequest\": {\n    \"cerFileName\": \"certificado.cer\",\n    \"keyFileName\": \"llave.key\",\n    \"serialNumberPrefix\": \"A\",\n    \"businessCode\": \"BC001\"\n  },\n  \"apiDataRequest\": null\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"campos-de-invoicemoderesponse","__idx":46},"children":["Campos de InvoiceModeResponse"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificador del comercio"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoiceType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tipo de facturación configurada (ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QRWEY"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["csdDataRequest"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Datos del CSD configurado"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["csdDataRequest.cerFileName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nombre del archivo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".cer"]}," cargado"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["csdDataRequest.keyFileName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nombre del archivo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".key"]}," cargado"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["csdDataRequest.serialNumberPrefix"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Prefijo para el número de serie de los CFDIs"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["csdDataRequest.businessCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Código de negocio asociado"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiDataRequest"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Datos de API de facturación externa (nullable)"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"regenerar-api-key","__idx":47},"children":["Regenerar API Key"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Regenera las llaves de acceso del comercio. La API Key anterior dejará de funcionar inmediatamente."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-10","__idx":48},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"PUT /v1/qrs/merchants/{merchantId}/api-key/regenerate\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev-9","__idx":49},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X PUT \"https://api-dev.qrwey.com/v1/qrs/merchants/mer_4aca0361cfcd41c097663db44008fbb9/api-key/regenerate\" \\\n  -H \"Authorization: Bearer {{access_token}}\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Al regenerar la API Key, cualquier integración que use la llave anterior dejará de autenticarse. Actualiza la configuración de tus sistemas antes de regenerar."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"errores-comunes","__idx":50},"children":["Errores comunes"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Código"},"children":["Código"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Motivo"},"children":["Motivo"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Campos requeridos faltantes, archivos CSD invalidos"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Token inválido o expirado"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Comercio, emisor o grupo no encontrado, o no pertenece a tu cuenta"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Consulta: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/error-handling"},"children":["Manejo de errores"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"buenas-prácticas","__idx":51},"children":["Buenas prácticas"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configura las llaves CSD antes de intentar timbrar CFDIs"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Usa nombres descriptivos para cada comercio que identifiquen la sucursal o punto de venta"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Regenera la API Key solo cuando sea necesario y actualiza todas las integraciones afectadas"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Desactiva comercios que ya no operen en lugar de eliminarlos"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"qué-sigue","__idx":52},"children":["¿Qué sigue?"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Timbra un CFDI con el comercio: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/stamp-cfdi"},"children":["Timbrar CFDI 4.0"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Consulta transacciones del comercio: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/customer-portal"},"children":["Gestión de Clientes"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Vuelve al índice: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/customer-portal"},"children":["Gestión de Clientes"]}]}]}]},"headings":[{"value":"Gestión de comercios","id":"gestión-de-comercios","depth":1},{"value":"Crear comercio","id":"crear-comercio","depth":2},{"value":"Endpoint","id":"endpoint","depth":3},{"value":"Headers requeridos","id":"headers-requeridos","depth":3},{"value":"Request body","id":"request-body","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev","depth":3},{"value":"Respuesta","id":"respuesta","depth":3},{"value":"Campos de la respuesta (Merchant)","id":"campos-de-la-respuesta-merchant","depth":3},{"value":"Listar comercios","id":"listar-comercios","depth":2},{"value":"Endpoint","id":"endpoint-1","depth":3},{"value":"Headers requeridos","id":"headers-requeridos-1","depth":3},{"value":"Query params","id":"query-params","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev-1","depth":3},{"value":"Respuesta","id":"respuesta-1","depth":3},{"value":"Campos de MerchantSummary","id":"campos-de-merchantsummary","depth":3},{"value":"Obtener comercio por ID","id":"obtener-comercio-por-id","depth":2},{"value":"Endpoint","id":"endpoint-2","depth":3},{"value":"Headers requeridos","id":"headers-requeridos-2","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev-2","depth":3},{"value":"Actualizar comercio","id":"actualizar-comercio","depth":2},{"value":"Endpoint","id":"endpoint-3","depth":3},{"value":"Headers requeridos","id":"headers-requeridos-3","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev-3","depth":3},{"value":"Subir logos del comercio","id":"subir-logos-del-comercio","depth":2},{"value":"Endpoint","id":"endpoint-4","depth":3},{"value":"Headers requeridos","id":"headers-requeridos-4","depth":3},{"value":"Campos del formulario","id":"campos-del-formulario","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev-4","depth":3},{"value":"Respuesta","id":"respuesta-2","depth":3},{"value":"Activar comercio","id":"activar-comercio","depth":2},{"value":"Endpoint","id":"endpoint-5","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev-5","depth":3},{"value":"Desactivar comercio","id":"desactivar-comercio","depth":2},{"value":"Endpoint","id":"endpoint-6","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev-6","depth":3},{"value":"Guardar llaves CSD (modelo de facturación)","id":"guardar-llaves-csd-modelo-de-facturación","depth":2},{"value":"Endpoint","id":"endpoint-7","depth":3},{"value":"Headers requeridos","id":"headers-requeridos-5","depth":3},{"value":"Campos del formulario","id":"campos-del-formulario-1","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev-7","depth":3},{"value":"Actualizar llaves CSD","id":"actualizar-llaves-csd","depth":2},{"value":"Endpoint","id":"endpoint-8","depth":3},{"value":"Obtener modelo de facturación","id":"obtener-modelo-de-facturación","depth":2},{"value":"Endpoint","id":"endpoint-9","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev-8","depth":3},{"value":"Respuesta","id":"respuesta-3","depth":3},{"value":"Campos de InvoiceModeResponse","id":"campos-de-invoicemoderesponse","depth":3},{"value":"Regenerar API Key","id":"regenerar-api-key","depth":2},{"value":"Endpoint","id":"endpoint-10","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev-9","depth":3},{"value":"Errores comunes","id":"errores-comunes","depth":2},{"value":"Buenas prácticas","id":"buenas-prácticas","depth":2},{"value":"¿Qué sigue?","id":"qué-sigue","depth":2}],"frontmatter":{"title":"Gestión de comercios","description":"Crear, configurar y administrar comercios, llaves CSD y API keys en QRwey!","seo":{"title":"Gestión de comercios"}},"lastModified":"2026-04-22T23:50:55.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/merchants","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}