Agregadores y PSPaaS
Consulta de Operaciones por Operador
2 min
{ "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" "\<?php\n\n$curl = curl init();\n\ncurl setopt array($curl, array(\n curlopt url => '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" } } 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