--- title: Consulta de Operaciones por Operador slug: consulta-de-operaciones-por-operador description: Learn how to use an API to check transaction status, retrieve transaction lists, search for operations, and more in this comprehensive document. With code examples in cURL, JavaScript, and PHP, you'll have all the information you need to seamlessly integr docTags: createdAt: 2021-01-25T20:00:16.000Z --- :::ApiMethodV2 ```json { "tab": "examples", "url": "https://api.sugaway.com/p/operator/coupons?page={page}&limit={limit}", "name": "Listado y Búsqueda de Transacciones", "method": "GET", "request": { "pathParameters": [], "queryParameters": [ { "kind": "required", "name": "page", "type": "Integer", "description": "Número de página para paginación. El valor comienza en 0." }, { "kind": "optional", "name": "limit", "type": "Integer", "description": "Límite de transacciones a devolver. Default: 15. Máximo: 50" }, { "kind": "optional", "name": "status", "type": "Number", "description": "Estado de la transacción (código)." }, { "kind": "optional", "name": "currency", "type": "String", "description": "Moneda de la Transacción: Admitidos: ARS, TEST." }, { "kind": "optional", "name": "created_from", "type": "string", "description": "Fecha de creación de la operación. Desde cuando buscar. Fecha como String o Timestamp." }, { "kind": "optional", "name": "created_to", "type": "string", "description": "Fecha de creación de la operación. Hasta cuando buscar. Fecha como String o Timestamp." }, { "kind": "optional", "name": "text", "type": "string", "description": "Buscar texto en las operaciones." }, { "kind": "optional", "name": "reference", "type": "string", "description": "Referencia asociada a la Operación." }, { "kind": "optional", "name": "test", "type": "Boolean", "description": "Permite obtener sólo operaciones de prueba." }, { "kind": "optional", "name": "context", "type": "string", "description": "Permite filtrar el contexto de la operación. String separado por coma sin espacios." }, { "kind": "optional", "name": "updated_from", "type": "string", "description": "Fecha de actualización de la operación. Desde cuando buscar. Fecha como String o Timestamp." }, { "kind": "optional", "name": "updated_to", "type": "string", "description": "Fecha de actualización de la Operación. Hasta cuando buscar. Fecha como String o Timestamp." } ], "headerParameters": [ { "kind": "required", "name": "x-api-key", "type": "string", "description": "Clave API de su aplicación." }, { "kind": "required", "name": "x-access-token", "type": "string", "description": "Token de acceso de la entidad." } ], "bodyDataParameters": [], "formDataParameters": [] }, "results": { "languages": [ { "id": "3lVmLo4wdtRrX8Lo_eO8q", "code": "{\n \"result\": true,\n \"data\": {\n \"docs\": [\n {\n \"_id\": \"66cfdb58979aeb558e130005\",\n \"uid\": \"SDJFAKLSDJFASLDKJFASLK\",\n \"operation\": \"payment.v2\",\n \"intentToken\": {\n \"_id\": \"99999999999999\",\n \"data\": {\n \"total\": \"12.50\",\n \"currency\": \"ARS\",\n \"reference\": \"Reference test\",\n \"description\": \"Venta Test Venta POS DX1111\",\n \"deviceExtras\": {\n \"os\": \"android\",\n \"osVersion\": 29,\n \"manufacturer\": \"ingenico\",\n \"model\": \"DX1111\",\n \"serialNumber\": \"ING:000000\",\n \"bundleId\": \"com.sugaway.pos\",\n \"buildNumber\": \"1021\",\n \"appVersion\": \"1.1.0\",\n \"romVersion\": \"1.8.0\",\n \"kernelVersion\": \"4.9.217\"\n },\n \"timeout\": 15,\n \"pos\": \"K6Y3SHXZQ759YTTTTT\",\n \"device\": \"W8QV5Y8LS2ILTTTTT\"\n }\n },\n \"status\": \"200\",\n \"status_message\": \"Transacción Aprobada\",\n \"entity\": {\n \"_id\": \"6699263b113153ed78aeeb3a\",\n \"uid\": \"arg.TEST\",\n \"name\": \"Sucursal\",\n \"tax_id\": \"99999999999\"\n },\n \"creator\": {\n \"_id\": \"2222222222222\",\n \"email\": \"test@demo.com\",\n \"name\": \"Test Name\"\n },\n \"sourceReference\": \"visa\",\n \"sourceName\": \"Visa\",\n \"sourceType\": \"card\",\n \"sourceAction\": \"cashin\",\n \"total\": 12.5,\n \"currency\": \"ARS\",\n \"card_number\": \"47045500****1008\",\n \"ticketNo\": \"8695\",\n \"authorizationCode\": \"010457\",\n \"description\": \"Venta Test POS DX8000\",\n \"installment_count\": 1,\n \"installment_amount\": 12.5,\n \"handler\": \"TEST\",\n \"user\": {\n \"name\": \"\"\n },\n \"authMethod\": \"none\",\n \"threeDSAuth\": \"none\",\n \"updated\": \"2024-08-29T02:22:18.087Z\",\n \"created\": \"2024-08-29T02:22:16.950Z\",\n \"totals\": {\n \"total\": 12.5,\n \"user_charges\": 0,\n \"entity_charges\": {\n \"source\": 0,\n \"installment\": 0,\n \"service\": 0.5\n },\n \"currency\": \"ARS\",\n \"installment_amount\": 12.5,\n \"financial\": {\n \"percentage\": 0,\n \"amount\": 0\n },\n \"requested\": {\n \"total\": 12.5,\n \"currency\": \"ARS\"\n },\n \"currency_data\": {\n \"value\": \"ARS\",\n \"label\": \"Peso Argentino\",\n \"symbol\": \"$\",\n \"locale\": \"es-AR\",\n \"isoCode\": \"032\",\n \"exponent\": 2,\n \"hidden\": false\n },\n \"installment\": {\n \"amount\": 12.5,\n \"count\": 1\n },\n \"financialData\": {\n \"isOperated\": true,\n \"service\": {\n \"_id\": \"64c7c84c34718e222222\",\n \"uid\": \"QQX7SWLRXZIV11111\",\n \"name\": \"Defecto\",\n \"operator\": \"64c1718f31csasdd7ce782f\",\n \"percentage\": 4,\n \"fixed_amount\": 0,\n \"user_percentage\": 0,\n \"user_fixed_amount\": 0,\n \"paymentDelay\": -1,\n \"isDefault\": false,\n \"chargeOverTotal\": true,\n \"modifiers\": [],\n \"__v\": 0,\n \"owner\": \"64c1718f31csasdd7cesss2f\",\n \"type\": \"simple\",\n \"isOperated\": true,\n \"paymentDelayType\": \"inactive\",\n \"useTiers\": false\n },\n \"user\": {\n \"percentage\": 0,\n \"fixed_amount\": 0,\n \"installment\": 0,\n \"service\": {\n \"percentage\": 0,\n \"fixed_amount\": 0\n }\n },\n \"entity\": {\n \"percentage\": 0,\n \"fixed_amount\": 0,\n \"installment\": 0,\n \"service\": {\n \"percentage\": 4,\n \"fixed_amount\": 0\n }\n }\n }\n },\n \"riskQualityLevel\": 0,\n \"statusUpdatedAt\": \"2024-08-29T02:22:18.087Z\",\n \"metadata\": {\n \"serviceCosts\": {\n \"percentage\": 4,\n \"fixed_amount\": 0,\n \"paymentDelayType\": \"inactive\",\n \"paymentDelay\": -1,\n \"uid\": \"QQX7SWLRXZIVN1D333\",\n \"tierUid\": null\n },\n \"serviceData\": {\n \"_id\": \"64c7c84c34718ea7883e219a\",\n \"uid\": \"QQX7SWLRXZIVN1D333\",\n \"name\": \"Defecto\",\n \"operator\": \"64c1718f31c7b53ad7ce782f\",\n \"percentage\": 4,\n \"fixed_amount\": 0,\n \"user_percentage\": 0,\n \"user_fixed_amount\": 0,\n \"paymentDelay\": -1,\n \"isDefault\": false,\n \"chargeOverTotal\": true,\n \"modifiers\": [],\n \"__v\": 0,\n \"owner\": \"64c1718f31c7b53ad7ce333\",\n \"type\": \"simple\",\n \"isOperated\": true,\n \"paymentDelayType\": \"inactive\",\n \"useTiers\": false\n }\n },\n \"context\": {\n \"value\": \"plugin.value.pos:mobile.pos\",\n \"name\": \"SmartPOS\"\n },\n \"intent\": {\n \"value\": \"payment.v2\",\n \"name\": \"Pago\"\n },\n \"source\": {\n \"name\": \"Visa\",\n \"reference\": \"visa\"\n },\n \"sign\": \"+\",\n \"riskQuality\": {\n \"level\": 0,\n \"band\": 0\n },\n \"hasChilds\": false,\n \"deviceData\": {\n \"os\": \"android\",\n \"manufacturer\": \"ingenico\",\n \"model\": \"DX1111\",\n \"serialNumber\": \"ING:000000\",\n \"buildNumber\": \"1021\",\n \"appVersion\": \"1.1.0\"\n }\n }\n ],\n \"page\": 1,\n \"prevPage\": -1,\n \"nextPage\": -1,\n \"limit\": 1\n }\n}", "language": "200" } ], "selectedLanguageId": "3lVmLo4wdtRrX8Lo_eO8q" }, "examples": { "languages": [ { "id": "6R8RxOiBPS0bPWkav56YP", "code": "var xhr = new XMLHttpRequest();\nxhr.withCredentials = true;\n\nxhr.addEventListener(\"readystatechange\", function() {\n if(this.readyState === 4) {\n console.log(this.responseText);\n }\n});\n\nxhr.open(\"GET\", \"https://api.sugaway.com/p/operator/coupons?page=0&limit=20&reference=my_mobbex_reference&context=plugin.value.checkout:web,plugin.value.payment_order:web,&test=true\");\nxhr.setRequestHeader(\"x-api-key\", \"zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj\");\nxhr.setRequestHeader(\"x-access-token\", \"d31f0721-2f85-44e7-bcc6-15e19d1a53cc\");\n\nxhr.send();", "language": "javascript" }, { "id": "YWJlT2czW188_W5Ta9jY7", "code": " 'https://api.sugaway.com/p/operator/coupons?page=0&limit=20&reference=my_mobbex_reference&context=plugin.value.checkout:web,plugin.value.payment_order:web&test=true',\n CURLOPT_RETURNTRANSFER => true,\n CURLOPT_ENCODING => '',\n CURLOPT_MAXREDIRS => 10,\n CURLOPT_TIMEOUT => 0,\n CURLOPT_FOLLOWLOCATION => true,\n CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n CURLOPT_CUSTOMREQUEST => 'GET',\n CURLOPT_HTTPHEADER => array(\n 'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj',\n 'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc'\n ),\n));\n\n$response = curl_exec($curl);\n\ncurl_close($curl);\necho $response;\n", "language": "php" } ], "selectedLanguageId": "6R8RxOiBPS0bPWkav56YP" }, "description": "Mediante la siguiente API se puede obtener un listado de operaciones en Suga y ejecutar diferentes filtros sobre ellas.", "currentNewParameter": { "label": "Query Parameter", "value": "queryParameters" }, "autoGeneratedAnchorSlug": "listado-y-bsqueda-de-transacciones", "legacyHash": "gNqpXxSWRlApg-qkB4Jq-" } ``` ::: **Ejemplos del nodo `text`:** - Filtrar por ID de operación: `https://api.sugaway.com/operator/coupons?page=0&limit=20&text=HJBKL2123KLFJJJJ` **Ejemplos del nodo `reference`:** - Filtrar por referencia de operación: `https://api.sugaway.com/operator/coupons?page=0&limit=20&reference=Tm1234` **Estados de la Transacción:** Para mayor información sobre los posibles estados de una transacción para su filtrado, remitirse a [Estados y Tipos de Transacción](https://www.sugaway.dev/codigos-de-estado-por-estado-de-orden). Es ***muy importante*** revisar la documentación sobre estados y tipos de transacción ya que el manejo de los mismos será utilizado durante la homologación del comercio.