{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Gestión de transacciones","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-transacciones","__idx":0},"children":["Gestión de transacciones"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Las ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["transacciones"]}," representan las operaciones de facturación realizadas a través de un comercio."," ","Desde la Gestión de Clientes puedes consultar el listado, obtener el detalle completo y cancelar"," ","transacciones pendientes."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"listar-transacciones","__idx":1},"children":["Listar transacciones"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint","__idx":2},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /v1/qrs/merchants/{merchantId}/transactions\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}}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"path-params","__idx":4},"children":["Path 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":["merchantId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ID del comercio (requerido)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"query-params","__idx":5},"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":["transactionId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filtrar por ID de transacción (opcional)"]}]},{"$$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":["Filtrar por estado: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PENDING"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USED"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EXPIRED"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CANCELLED"]}," (opcional)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rfc"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filtrar por RFC del receptor (opcional)"]}]},{"$$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":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Campo y dirección de ordenamiento (ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdAt,desc"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev","__idx":6},"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/transactions?status=USED&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","__idx":7},"children":["Respuesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"content\": [\n    {\n      \"transactionId\": \"qr_8b3f0a61cfcd41c097663db44008fcc1\",\n      \"rfcReceptor\": \"EKU9003173C9\",\n      \"products\": 3,\n      \"total\": 1160.00,\n      \"createdAt\": \"2026-03-19T14:30:00Z\",\n      \"expiresAt\": \"2026-03-19T15:30:00Z\",\n      \"status\": \"USED\"\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-qrtransactionsummary","__idx":8},"children":["Campos de QrTransactionSummary"]},{"$$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":["transactionId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificador único de la transacción"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rfcReceptor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["RFC del receptor que escaneo el QR"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Número de conceptos/productos en la transacción"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Monto total de la transacción"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdAt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fecha de creación de la transacción"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expiresAt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fecha de expiración del QR"]}]},{"$$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 de la transacción: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTIVE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PENDING"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USED"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EXPIRED"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CANCELED"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"obtener-detalle-de-transacción","__idx":9},"children":["Obtener detalle de transacción"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-1","__idx":10},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /v1/qrs/merchants/{merchantId}/transactions/{transactionId}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"headers-requeridos-1","__idx":11},"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-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/mer_4aca0361cfcd41c097663db44008fbb9/transactions/qr_8b3f0a61cfcd41c097663db44008fcc1\" \\\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":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"transactionId\": \"qr_8b3f0a61cfcd41c097663db44008fcc1\",\n  \"store\": \"Estación Reforma Centro\",\n  \"issuerRfc\": \"FUNK671228PH6\",\n  \"issuerName\": \"KARLA FUENTE NOLASCO\",\n  \"receiverRfc\": \"EKU9003173C9\",\n  \"receiverName\": \"ESCUELA KEMPER URGATE\",\n  \"invoiceStatus\": \"GENERATED\",\n  \"invoiceUuid\": \"A1B2C3D4-E5F6-7890-ABCD-EF1234567890\",\n  \"operation\": \"SALE\",\n  \"currency\": \"MXN\",\n  \"amount\": 1160.00,\n  \"subtotal\": 1000.00,\n  \"status\": \"USED\",\n  \"expiresAt\": \"2026-03-19T15:30:00Z\",\n  \"createdAt\": \"2026-03-19T14:30:00Z\",\n  \"qrContent\": \"https://app.qrwey.com/qr?t=...\",\n  \"qrUrl\": \"https://app.qrwey.com/qr?t=...\",\n  \"qrBase64\": \"data:image/png;base64,iVBORw0KGgo...\",\n  \"operationItems\": [\n    {\n      \"sku\": \"GAS87\",\n      \"description\": \"Gasolina Magna\",\n      \"quantity\": 49.210,\n      \"unitPrice\": 20.321,\n      \"amount\": 1000.00,\n      \"satProductServiceKey\": \"15101515\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"campos-del-detalle-de-transacción","__idx":14},"children":["Campos del detalle de transacción"]},{"$$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":["transactionId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificador único de la transacción"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["store"]}]},{"$$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":["issuerRfc"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["RFC del emisor"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["issuerName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Razón social del emisor"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["receiverRfc"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["RFC del receptor (si ya fue escaneado/facturado)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["receiverName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Razón social del receptor"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoiceStatus"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Estado de la factura asociada (ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GENERATED"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoiceUuid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["UUID fiscal de la factura asociada (si ya fue timbrada)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tipo de operación"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Moneda de la transacción"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Monto total"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subtotal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Subtotal antes de impuestos"]}]},{"$$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 de la transacción"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expiresAt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fecha de expiración del QR"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdAt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fecha de creación"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["qrContent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contenido codificado del QR"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["qrUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL de resolución del QR"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["qrBase64"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Imagen del QR en formato base64 (data URI)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operationItems"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lista de conceptos de la operación"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operationItems[].sku"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificador interno del producto"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operationItems[].description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Descripción del concepto"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operationItems[].quantity"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cantidad"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operationItems[].unitPrice"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Precio unitario"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operationItems[].amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Importe del concepto"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operationItems[].satProductServiceKey"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clave de producto/servicio SAT"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cancelar-transacción","__idx":15},"children":["Cancelar transacción"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cancela una transacción activa o pendiente. Solo se pueden cancelar transacciones con estado ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTIVE"]}," o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PENDING"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-2","__idx":16},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"PATCH /v1/qrs/merchants/{merchantId}/transactions/{transactionId}/cancel\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 PATCH \"https://api-dev.qrwey.com/v1/qrs/merchants/mer_4aca0361cfcd41c097663db44008fbb9/transactions/qr_8b3f0a61cfcd41c097663db44008fcc1/cancel\" \\\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-2","__idx":19},"children":["Respuesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"HTTP/1.1 200 OK\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["La operación no devuelve cuerpo en la respuesta."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"errores-comunes","__idx":20},"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":["La transacción no está en estado ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTIVE"]}," o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PENDING"]}," y no puede ser cancelada"]}]},{"$$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":["Transacción o comercio 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":21},"children":["Buenas prácticas"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Usa los filtros de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," y ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rfc"]}," para localizar transacciones rápidamente"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cancela transacciones pendientes que ya no serán facturadas para mantener el orden"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Consulta el detalle de la transacción para verificar la información de facturación antes de generar el CFDI"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"qué-sigue","__idx":22},"children":["¿Qué sigue?"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Consulta reportes de consumo: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/customer-reports"},"children":["Reportes del cliente"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Timbra un CFDI: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/stamp-cfdi"},"children":["Timbrar CFDI 4.0"]}]},{"$$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 transacciones","id":"gestión-de-transacciones","depth":1},{"value":"Listar transacciones","id":"listar-transacciones","depth":2},{"value":"Endpoint","id":"endpoint","depth":3},{"value":"Headers requeridos","id":"headers-requeridos","depth":3},{"value":"Path params","id":"path-params","depth":3},{"value":"Query params","id":"query-params","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev","depth":3},{"value":"Respuesta","id":"respuesta","depth":3},{"value":"Campos de QrTransactionSummary","id":"campos-de-qrtransactionsummary","depth":3},{"value":"Obtener detalle de transacción","id":"obtener-detalle-de-transacción","depth":2},{"value":"Endpoint","id":"endpoint-1","depth":3},{"value":"Headers requeridos","id":"headers-requeridos-1","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev-1","depth":3},{"value":"Respuesta","id":"respuesta-1","depth":3},{"value":"Campos del detalle de transacción","id":"campos-del-detalle-de-transacción","depth":3},{"value":"Cancelar transacción","id":"cancelar-transacción","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":"Respuesta","id":"respuesta-2","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 transacciones","description":"Consultar y cancelar transacciones de un comercio en QRwey!","seo":{"title":"Gestión de transacciones"}},"lastModified":"2026-04-22T23:50:55.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/transactions","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}