--- title: Consulta de Operaciones y childs slug: consulta-de-operaciones-y-childs description: Learn how to check the status of a transaction using its unique ID with this comprehensive API documentation. Discover code examples in curl, JavaScript, and PHP for easily making requests to the API. Dive into transaction details such as payment method, docTags: createdAt: 2021-01-25T20:00:16.000Z --- :::ApiMethodV2 ```json { "tab": "examples", "url": "https://api.unicobros.com.ar/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@unicobros.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 GET \\\n --url https://api.unicobros.com.ar/p/operations/5f0c97f616d2da0eb6d6 \\\n --header 'cache-control: no-cache' \\\n --header 'content-type: multipart/form-data; \\\n --header 'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj' \\\n --header 'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc' \\\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(\"GET\", \"https://api.unicobros.com.ar/p/operations/5f0c97f616d2da0eb6d6\");\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": "setUrl('https://api.unicobros.com.ar/p/operations/5f0c97f616d2da0eb6d6');\n$request->setMethod(HTTP_METH_GET);\n$request->setHeaders(array(\n 'cache-control' => 'no-cache',\n 'content-type' => 'application/json',\n 'x-access-token' => 'd31f0721-2f85-44e7-bcc6-15e19d1a53cc',\n 'x-api-key' => 'zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj'\n));\n$request->setPostFields(array(\n 'id' => '#MyImportantID'\n));\ntry {\n $response = $request->send();\n echo $response->getBody();\n} catch (HttpException $ex) {\n echo $ex;\n}\n?>", "language": "php" } ], "selectedLanguageId": "nXmzb8wHapx_qApH8Mzet" }, "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": "m8hN62qPS11Sn3QAp6SiQ" } ``` ::: 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@unicobros.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@unicobros.com" }, "updated": "2024-12-12T13:22:06.791Z", "created": "2024-12-12T13:21:54.377Z" } ] ``` :::ApiMethodV2 ```json { "tab": "examples", "url": "https://api.unicobros.com.ar/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_unicobros_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_unicobros_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/entity/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": " 'https://api.unicobros.com.ar/p/entity/operations?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": "YWJlT2czW188_W5Ta9jY7" }, "description": "Mediante la siguiente API se puede obtener un listado de operaciones en Unicobros 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.