---
title: Consulta de Operaciones y Childs
slug: consulta-de-operaciones-y-childs
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
createdAt: 2021-01-25T20:00:16.000Z
---

:::ApiMethodV2
```json
{
  "tab": "examples",
  "url": "https://api.sugaway.com/p/operations/{UID}",
  "name": "Consultar Transacción por UID",
  "method": "GET",
  "request": {
    "pathParameters": [
      {
        "name": "uid",
        "kind": "required",
        "type": "string",
        "description": "Identificador del cupón a solicitar.",
        "children": []
      },
      {
        "name": "REF:",
        "kind": "optional",
        "type": "string",
        "description": "Referencia del cupón a solicitar.",
        "children": []
      }
    ],
    "queryParameters": [],
    "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 a la entidad"
      }
    ],
    "bodyDataParameters": [],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "c0_giZEY3zbTXyJO1440_",
        "code": "{\n    \"result\": true,\n    \"data\": {\n        \"transactions\": [\n            {\n                \"_id\": \"5f0c97f616d2da0eb6d68943\",\n                \"uid\": \"OmM7j3LSzb\",\n                \"utid\": \"\",\n                \"status\": \"200\",\n                \"description\": \"Checkout Demo\",\n                \"message\": \"\",\n                \"type\": \"Payment\",\n                \"total\": 100.5,\n                \"references\": [],\n                \"hash\": \"\",\n                \"sender\": \"5e283b0a49fb2b1a71dad7d8\",\n                \"receiver\": \"58485bda80471d000f9e0fc9\",\n                \"coupon\": \"5f0c97f616d2da0eb6d6893f\",\n                \"currency\": {\n                    \"value\": \"TEST\",\n                    \"label\": \"Test Money\",\n                    \"symbol\": \"T$\",\n                    \"hidden\": false\n                },\n                \"updated\": \"2020-07-13T17:20:54.463Z\",\n                \"created\": \"2020-07-13T17:20:54.462Z\",\n                \"__v\": 0\n            }\n        ],\n        \"transaction\": {\n            \"result\": true,\n            \"view\": {\n                \"type\": \"card\"\n            },\n            \"payment\": {\n                \"id\": \"zP5_3fqSt\",\n                \"description\": \"Checkout Demo\",\n                \"operation\": {\n                    \"type\": \"payment.v2\"\n                },\n                \"status\": {\n                    \"code\": \"200\",\n                    \"text\": \"Aprobado\",\n                    \"message\": \"Transacción Aprobada\"\n                },\n                \"total\": 100.5,\n                \"currency\": {\n                    \"code\": \"TEST\",\n                    \"text\": \"Test Money\",\n                    \"symbol\": \"T$\"\n                },\n                \"riskAnalysis\": {\n                    \"band\": \"N/A\",\n                    \"level\": \"N/A\"\n                },\n                \"created\": \"2020-07-13T17:20:54.308Z\",\n                \"updated\": \"2020-07-13T17:20:54.977Z\",\n                \"reference\": \"Referencia Demo\",\n                \"source\": {\n                    \"name\": \"Visa Débito\",\n                    \"type\": \"card\",\n                    \"reference\": \"visa.debit\",\n                    \"number\": \"450799******0010\",\n                    \"expiration\": {\n                        \"month\": \"12\",\n                        \"year\": \"25\"\n                    },\n                    \"installment\": {\n                        \"description\": \"Debito\",\n                        \"amount\": 100.5,\n                        \"count\": 1,\n                        \"reference\": \"1_debit\"\n                    }\n                }\n            },\n            \"user\": {\n                \"name\": \"Cliente Demo\",\n                \"email\": \"demo@mobbex.com\"\n            },\n            \"source\": {\n                \"name\": \"Visa Débito\",\n                \"type\": \"card\",\n                \"reference\": \"visa.debit\"\n            }\n        },\n        \"transaction_details\": [\n            {\n                \"key\": \"card_number\",\n                \"label\": \"Número de Tarjeta\",\n                \"value\": \"450799******0010\"\n            },\n            {\n                \"key\": \"transactionId\",\n                \"label\": \"ID Transacción\",\n                \"value\": \"zP5_3fqSt\"\n            },\n            {\n                \"key\": \"authorizationCode\",\n                \"label\": \"Código de Autorización\",\n                \"value\": \"121212\"\n            },\n            {\n                \"key\": \"ticketNo\",\n                \"label\": \"Número de Ticket\",\n                \"value\": \"1111\"\n            }\n        ]\n    }\n}",
        "language": "200"
      }
    ],
    "selectedLanguageId": "c0_giZEY3zbTXyJO1440_"
  },
  "examples": {
    "languages": [
      {
        "id": "BSHMbcAa9YD6gZupvQkST",
        "code": "curl --request POST \\\r\n  --url https://api.mobbex.com/2.0/transactions/status \\\r\n  --header 'cache-control: no-cache' \\\r\n  --header 'content-type: multipart/form-data; \\\r\n  --header 'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj' \\\r\n  --header 'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc' \\\r\n  --form 'id=#MyImportantID'",
        "language": "curl"
      },
      {
        "id": "Vo7WJPWfPQvmPtREd2OJ6",
        "code": "var data = new FormData();\ndata.append(\"id\", \"#MyImportantID\");\nvar xhr = new XMLHttpRequest();\nxhr.withCredentials = true;\nxhr.addEventListener(\"readystatechange\", function () {\n    if (this.readyState === 4) {\n        console.log(this.responseText);\n    }\n});\nxhr.open(\"POST\", \"https://api.mobbex.com/2.0/transactions/status\");\nxhr.setRequestHeader(\"x-api-key\", \"zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj\");\nxhr.setRequestHeader(\"x-access-token\", \"d31f0721-2f85-44e7-bcc6-15e19d1a53cc\");\nxhr.setRequestHeader(\"cache-control\", \"no-cache\");\nxhr.send(data);",
        "language": "javascript"
      },
      {
        "id": "nXmzb8wHapx_qApH8Mzet",
        "code": "<?php\r\n$request = new HttpRequest();\r\n$request->setUrl('https://api.mobbex.com/2.0/transactions/status');\r\n$request->setMethod(HTTP_METH_POST);\r\n$request->setHeaders(array(\r\n  'cache-control' => 'no-cache',\r\n  'content-type' => 'application/json',\r\n  'x-access-token' => 'd31f0721-2f85-44e7-bcc6-15e19d1a53cc',\r\n  'x-api-key' => 'zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj'\r\n));\r\n$request->setPostFields(array(\r\n  'id' => '#MyImportantID'\r\n));\r\ntry {\r\n  $response = $request->send();\r\n  echo $response->getBody();\r\n} catch (HttpException $ex) {\r\n  echo $ex;\r\n}\r\n?>",
        "language": "php"
      }
    ],
    "selectedLanguageId": "BSHMbcAa9YD6gZupvQkST"
  },
  "description": "Esta API permite consultar el estado de la transacción por el ID de cupón o referencia.",
  "currentNewParameter": {
    "label": "Path Parameter",
    "value": "pathParameters"
  },
  "autoGeneratedAnchorSlug": "consultar-transaccin-por-uid",
  "legacyHash": "r94BUZ8zvx7v7OXnRL9KT"
}
```
:::

Ejemplo de nodo **`childs`:**

```json
 "childs": [
                {
                    "id": "675ae372aa48b839b789144f",
                    "uid": "CHD-727BJJJVN8FAC1UZLV",
                    "operation": "payment.v2",
                    "status": "200",
                    "card_number": "45079900****0010",
                    "source": {
                        "name": "Visa Débito",
                        "reference": "visa.debit"
                    },
                    "installment_count": 1,
                    "total": 400.53,
                    "currency": "TEST",
                    "description": "Checkout de Prueba",
                    "reference": "02G3GROO2VP5N2ANE8",
                    "user": {
                        "name": "Cliente Demo",
                        "email": "demo@sugaway.com"
                    },
                    "updated": "2024-12-12T13:24:22.602Z",
                    "created": "2024-12-12T13:21:54.377Z"
                },
                {
                    "id": "675ae372aa48b839b7891457",
                    "uid": "CHD-R3I5VC9H0KV4GDE0QK",
                    "operation": "payment.v2",
                    "status": "200",
                    "card_number": "45079831****2450",
                    "source": {
                        "name": "Visa",
                        "reference": "visa"
                    },
                    "installment_count": 1,
                    "total": 500,
                    "currency": "TEST",
                    "description": "Checkout de Prueba",
                    "reference": "949MFIFCZM77505MKK",
                    "user": {
                        "name": "Cliente Demo",
                        "email": "demo@sugaway.com"
                    },
                    "updated": "2024-12-12T13:22:06.791Z",
                    "created": "2024-12-12T13:21:54.377Z"
                }
            ]
```

Aclaración: El ejemplo anterior corresponde a una transacción que se abonó con dos medios de pago distintos, generando un CHD por cada medio de pago.&#x20;



:::ApiMethodV2
```json
{
  "tab": "examples",
  "url": "https://api.sugaway.com/p/entity/operations?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\": \"606f01cc063b6c569b7cb232\",\n                \"user\": {\n                    \"name\": \"demo\"\n                },\n                \"uid\": \"GZF5JBMBd\",\n                \"operation\": \"payment.v2\",\n                \"status\": \"200\",\n                \"sourceReference\": \"mastercard\",\n                \"sourceName\": \"Mastercard\",\n                \"installmentReference\": \"1\",\n                \"card_number\": \"532362******1008\",\n                \"description\": \"Orden Test\",\n                \"reference\": \"my_mobbex_reference\",\n                \"riskQualityLevel\": 0,\n                \"entity\": {\n                    \"_id\": \"5761a3dd8aad6c120042b287\",\n                    \"name\": \"Demo\",\n                    \"uid\": \"H1rJEXyr\",\n                    \"tax_id\": \"99999999999\"\n                },\n                \"total\": 2871.74,\n                \"totals\": {\n                    \"total\": 2871.74,\n                    \"user_charges\": 0,\n                    \"entity_charges\": {\n                        \"source\": 0,\n                        \"installment\": 0,\n                        \"service\": 0\n                    },\n                    \"currency\": \"TEST\",\n                    \"installment_amount\": 2871.74,\n                    \"financial\": {\n                        \"percentage\": 0,\n                        \"amount\": 0\n                    },\n                    \"requested\": {\n                        \"total\": 2871.74,\n                        \"currency\": \"TEST\"\n                    },\n                    \"currency_data\": {\n                        \"value\": \"TEST\",\n                        \"label\": \"Test Money\",\n                        \"symbol\": \"T$\",\n                        \"hidden\": false\n                    },\n                    \"installment\": {\n                        \"amount\": 2871.74,\n                        \"count\": 1\n                    }\n                },\n                \"created\": \"2021-04-08T13:14:52.648Z\",\n                \"context\": {\n                    \"value\": \"plugin.value.payment_order:web\",\n                    \"name\": \"Orden de Pago\"\n                },\n                \"intent\": {\n                    \"value\": \"payment.v2\",\n                    \"name\": \"Pago\"\n                },\n                \"source\": {\n                    \"name\": \"Mastercard\",\n                    \"reference\": \"mastercard\"\n                },\n                \"sign\": \"+\",\n                \"riskQuality\": {\n                    \"level\": 0,\n                    \"band\": 0\n                }\n            },\n            {\n                \"_id\": \"606f0073799a6056ca9cd0ba\",\n                \"user\": {\n                    \"name\": \"Demo\"\n                },\n                \"uid\": \"4ED9NVAHM\",\n                \"operation\": \"payment.v2\",\n                \"status\": \"400\",\n                \"sourceReference\": \"mastercard\",\n                \"sourceName\": \"Mastercard\",\n                \"installmentReference\": \"1\",\n                \"card_number\": \"532362******1008\",\n                \"description\": \"Orden Test\",\n                \"reference\": \"my_mobbex_reference\",\n                \"riskQualityLevel\": 0,\n                \"entity\": {\n                    \"_id\": \"5761a3dd8aad6c120042b287\",\n                    \"name\": \"Demo\",\n                    \"uid\": \"H1rJEXyr\",\n                    \"tax_id\": \"99999999999\"\n                },\n                \"total\": 2871.74,\n                \"totals\": {\n                    \"total\": 2871.74,\n                    \"user_charges\": 0,\n                    \"entity_charges\": {\n                        \"source\": 0,\n                        \"installment\": 0,\n                        \"service\": 0\n                    },\n                    \"currency\": \"TEST\",\n                    \"installment_amount\": 2871.74,\n                    \"financial\": {\n                        \"percentage\": 0,\n                        \"amount\": 0\n                    },\n                    \"requested\": {\n                        \"total\": 2871.74,\n                        \"currency\": \"TEST\"\n                    },\n                    \"currency_data\": {\n                        \"value\": \"TEST\",\n                        \"label\": \"Test Money\",\n                        \"symbol\": \"T$\",\n                        \"hidden\": false\n                    },\n                    \"installment\": {\n                        \"amount\": 2871.74,\n                        \"count\": 1\n                    }\n                },\n                \"created\": \"2021-04-08T13:09:07.404Z\",\n                \"context\": {\n                    \"value\": \"plugin.value.payment_order:web\",\n                    \"name\": \"Orden de Pago\"\n                },\n                \"intent\": {\n                    \"value\": \"payment.v2\",\n                    \"name\": \"Pago\"\n                },\n                \"source\": {\n                    \"name\": \"Mastercard\",\n                    \"reference\": \"mastercard\"\n                },\n                \"sign\": \"+\",\n                \"riskQuality\": {\n                    \"level\": 0,\n                    \"band\": 0\n                }\n            }\n        ],\n        \"page\": 1,\n        \"prevPage\": -1,\n        \"nextPage\": -1,\n        \"limit\": 20\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.mobbex.com/p/operations?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": "<?php\r\n\r\n$curl = curl_init();\r\n\r\ncurl_setopt_array($curl, array(\r\n  CURLOPT_URL => 'https://api.mobbex.com/p/operations?page=0&limit=20&reference=my_mobbex_reference&context=plugin.value.checkout:web,plugin.value.payment_order:web&test=true',\r\n  CURLOPT_RETURNTRANSFER => true,\r\n  CURLOPT_ENCODING => '',\r\n  CURLOPT_MAXREDIRS => 10,\r\n  CURLOPT_TIMEOUT => 0,\r\n  CURLOPT_FOLLOWLOCATION => true,\r\n  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\r\n  CURLOPT_CUSTOMREQUEST => 'GET',\r\n  CURLOPT_HTTPHEADER => array(\r\n    'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj',\r\n    'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc'\r\n  ),\r\n));\r\n\r\n$response = curl_exec($curl);\r\n\r\ncurl_close($curl);\r\necho $response;\r\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-"
}
```
:::

**Formato del objeto created/updated en consultas de tipo POST:**

```json
{
  "from: {
    "day": 10,
    "month": 11,
    "year": 2019
  },
  "to": {
    "day": 11,
    "month": 11,
    "year": 2019
  }
}
```

# Tipos de Contextos

- *Checkout*: plugin.value.checkout\:web ,plugin.value.checkout\:button
- *Links de Venta*: plugin.value.commerce\:buy
- *Códigos de Barra de Pago*: plugin.value.payment\_code\:generate
- *Orden de pago*: plugin.value.payment\_order\:web
- *MultiPOS*: plugin.value.pos\:web, plugin.value.pos\:web.mobile, plugin.value.pos\:mobile, plugin.value.pos\:desktop
- *Suscripciones*: plugin.value.subscriptions\:subscribe, plugin.value.subscriptions\:exec

**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://mobbex.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.


Código QR de Transacción
========================

El código QR generado por Mobbex en las transacciones y enviado a través de ***Email*** y ***Tickets*** puede ser utilizado para obtener fácilmente el código de la misma y mediante nuestra API consultar el detalle de la Transacción.

### Utilización del Código QR.

1. Leer el código QR utilizando un lector de códigos estandar
2. Separar el código utilizando el caracter: :
3. El primer segmento del QR separado será el ID de la transacción
4. Utilizando el ID de la transacción Consultar el Estado de la misma en nuestro API.

### Ejemplo de Código QR

```none
MYpmTQlVC:kYSmcGx1Z2lusHBsdWdpbi52YWx1ZS5wb3OjdWlkrm1vYmJleC53ZWIucG9zpGRhdGHZMHsidXNlciI6IjU3NmQyOTEzYzM0YzY0MTIwMDI1OTU2YSIsInR5cGUiOiJ3ZWIifaNfaWSCqV9ic29udHlwZahPYmplY3RJRKJpZMQMXP3Z3uPhOxJEzKZ5
```

**Código Separado**

- MYpmTQlVC: Código de Operación
- kYSmcGx1Z2lusHBsdWdpbi52YWx1ZS5wb3OjdWlkrm1vYmJleC53ZWIucG9zpGRhdGHZMHsidXNlciI6IjU3NmQyOTEzYzM0YzY0MTIwMDI1OTU2YSIsInR5cGUiOiJ3ZWIifaNfaWSCqV9ic29udHlwZahPYmplY3RJRKJpZMQMXP3Z3uPhOxJEzKZ5: Datos internos de la Operación

