--- title: Códigos de Barra o Insertados slug: codigos-de-barra-o-insertados description: Learn how to generate barcode images for payment purposes using Mobbex APIs. This document includes code examples for making requests to the pre-generated barcode image API and the barcode object API. Discover how to access barcode options, the generated icon: {"faIcon":"fa-solid fa-barcode"} docTags: createdAt: 2021-01-25T14:24:18.000Z --- :::ApiMethodV2 ```json { "tab": "examples", "url": "https://api.mobbex.com/p/payment_code/gen/{code}?reference={reference}&total={total}&expiration={expiration}", "name": "Generar imagen de código de barras", "method": "GET", "request": { "pathParameters": [ { "kind": "required", "name": "code", "type": "string", "description": "Código pre-generado para la entidad definido dentro de la sección \"Códigos de Pago\"" } ], "queryParameters": [ { "kind": "required", "name": "reference", "type": "string", "description": "Identificador de la operación en el servicio. Le permitirá rastrear la operación. Debe ser único y no debe repetirse." }, { "kind": "required", "name": "total", "type": "Number", "description": "Monto de la operación. Debe expresarse en el formato XXX.xx donde el PUNTO es el separador decimal." }, { "kind": "optional", "name": "expiration", "type": "string", "description": "Fecha de vencimiento en formato DD-MM-YYYY. Ej: 10-01-2021" }, { "kind": "optional", "name": "email", "type": "string", "description": "Email del receptor. Le permitirá al usuario seguir la operación." }, { "kind": "optional", "name": "surchargeDays", "type": "Integer", "description": "Días al segundo vencimiento respecto al vencimiento original." }, { "kind": "optional", "name": "surchargeTotal", "type": "Number", "description": "Monto adicional del segundo vencimiento. Debe expresarse en el formato XXX.xx donde el PUNTO es el separador decimal." } ], "headerParameters": [], "bodyDataParameters": [], "formDataParameters": [] }, "results": { "languages": [ { "id": "Yih99fJR96l9wydWqhVUO", "code": "", "language": "200" } ], "selectedLanguageId": "Yih99fJR96l9wydWqhVUO" }, "examples": { "languages": [ { "id": "jE4eSBuO32-4anz1u0Zgx", "code": "curl --location --request GET 'https://api.mobbex.com/p/payment_code/gen/HyPoGfFxf?reference=0001-00000002&total=100&expiration=31-12-2017&surchargeDays=5&surchargeTotal=50'", "language": "curl" }, { "id": "v9DBPryyp8KSsrWHkItz0", "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/payment_code/gen/HyPoGfFxf?reference=0001-00000002&total=100&expiration=31-12-2017&surchargeDays=5&surchargeTotal=50\");\n\nxhr.send();", "language": "javascript" } ], "selectedLanguageId": "jE4eSBuO32-4anz1u0Zgx" }, "description": "Esta API te permite generar un código de barras para cobrar tus productos o servicios e insertarlos en una aplicación propia. El retorno de la misma es una imagen de código pregenerada.", "currentNewParameter": { "label": "Path Parameter", "value": "pathParameters" }, "autoGeneratedAnchorSlug": "generar-imagen-de-cdigo-de-barras", "legacyHash": "hUHGNXlUjVbzWq7b_UF1h" } ``` ::: **Descripción del Ejemplo:** - Referencia (Factura): 0001-00000002 - Vencimiento: 31-12-2017 - Total: 100.00 - Recargo: 50 pesos a los 5 dias del vencimiento :::ApiMethodV2 ```json { "tab": "examples", "url": "https://api.mobbex.com/p/payment_code/", "name": "Generar código de barras", "method": "POST", "request": { "pathParameters": [], "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 al comercio." } ], "bodyDataParameters": [ { "kind": "required", "name": "total", "type": "Number", "description": "Total de la operación. Valor numérico con formato XXX.xx" }, { "kind": "required", "name": "reference", "type": "string", "description": "Identificador de la operación en el servicio. Le permitirá rastrear la operación. Debe ser único y no debe repetirse." }, { "kind": "required", "name": "sourceReference", "type": "string", "description": "Identificador del medio de pago correspondiente a código de barras. Valor único: arg_mobbex_cash" }, { "kind": "optional", "name": "expiration", "type": "String", "description": "Fecha de vencimiento en formato DD-MM-YYYY. Ej: 10-01-2021" }, { "kind": "optional", "name": "email", "type": "string", "description": "Email del receptor. Le permitirá al usuario seguir la operación." }, { "kind": "optional", "name": "surchargeDays", "type": "Integer", "description": "Días al segundo vencimiento respecto al vencimiento original." }, { "kind": "optional", "name": "surchargeTotal", "type": "string", "description": "Monto adicional del segundo vencimiento. Debe expresarse en el formato XXX.xx donde el PUNTO es el separador decimal." }, { "kind": "optional", "name": "webhook", "type": "string", "description": "URL a la cual será informado el pago mediante WebHooks (POST)" } ], "formDataParameters": [] }, "results": { "languages": [ { "id": "9C8aYaj0owx6ph1dJQYhd", "code": "{\n \"uid\": \"_L5O3yt1h\",\n \"status\": {\n \"code\": \"2\",\n \"text\": \"En Espera\",\n \"message\": \"El cupón vence el día 8/08.\",\n \"data\": {},\n \"view\": \"default\"\n },\n \"barcode\": \"04473704250942108080010000000000000000000000515003571355\",\n \"barcodeOptions\": {\n \"bcid\": \"interleaved2of5\",\n \"includetext\": \"1\",\n \"textxalign\": \"center\",\n \"textsize\": \"11\"\n }\n}", "language": "200" }, { "id": "MAMB-nOElfLE7l2LdnJPB", "code": "{\n \"message\": \"Ain't no cake like that.\"\n}", "language": "404" } ], "selectedLanguageId": "9C8aYaj0owx6ph1dJQYhd" }, "examples": { "languages": [ { "id": "mvGfSLz4EY5UPFIcXzh_S", "code": "var client = new RestClient(\"https://api.mobbex.com/p/payment_code\");\r\nclient.Timeout = -1;\r\nvar request = new RestRequest(Method.POST);\r\nrequest.AddHeader(\"x-api-key\", \"zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj\");\r\nrequest.AddHeader(\"x-access-token\", \"d31f0721-2f85-44e7-bcc6-15e19d1a53cc\");\r\nrequest.AddHeader(\"Content-Type\", \"application/json\");\r\nvar body = @\"{\r\n\" + \"\\n\" +\r\n@\" \"\"total\"\": 100,\r\n\" + \"\\n\" +\r\n@\" \"\"reference\"\": \"\"060820211629\"\",\r\n\" + \"\\n\" +\r\n@\" \"\"sourceReference\"\": \"\"arg_mobbex_cash\"\"\r\n\" + \"\\n\" +\r\n@\"}\";\r\nrequest.AddParameter(\"application/json\", body, ParameterType.RequestBody);\r\nIRestResponse response = client.Execute(request);\r\nConsole.WriteLine(response.Content);", "language": "csharp" }, { "id": "QGKnDxtp0hHkDniSUtlPD", "code": "var myHeaders = new Headers();\nmyHeaders.append(\"x-api-key\", \"zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj\");\nmyHeaders.append(\"x-access-token\", \"d31f0721-2f85-44e7-bcc6-15e19d1a53cc\");\nmyHeaders.append(\"Content-Type\", \"application/json\");\n\nvar raw = JSON.stringify({\n \"total\": 100,\n \"reference\": \"060820211629\",\n \"sourceReference\": \"arg_mobbex_cash\"\n});\n\nvar requestOptions = {\n method: 'POST',\n headers: myHeaders,\n body: raw,\n redirect: 'follow'\n};\n\nfetch(\"https://api.mobbex.com/p/payment_code\", requestOptions)\n .then(response => response.text())\n .then(result => console.log(result))\n .catch(error => console.log('error', error));", "language": "javascript" }, { "id": "i2h5Z2p2A67LV6ulvRvTU", "code": " 'https://api.mobbex.com/p/payment_code',\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 => 'POST',\r\n CURLOPT_POSTFIELDS =>'{\r\n \"total\": 100,\r\n \"reference\": \"060820211629\",\r\n \"sourceReference\": \"arg_mobbex_cash\"\r\n}',\r\n CURLOPT_HTTPHEADER => array(\r\n 'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj',\r\n 'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc',\r\n 'Content-Type: application/json'\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": "mvGfSLz4EY5UPFIcXzh_S" }, "description": "Esta API te permite generar un código de barras para pagos en efectivo de tus productos o servicios. El retorno es un objeto con toda la información sobre el código generado.", "currentNewParameter": { "label": "Body Parameter", "value": "bodyDataParameters" }, "autoGeneratedAnchorSlug": "generar-cdigo-de-barras", "legacyHash": "g__gYN90oXj0fN85Mnr8l" } ``` :::