--- title: Dev Connect slug: dev-connect description: Learn how to use the Dev Connect API to generate an Access Token for seamless access to managed merchant services. Discover endpoints for creating credential requests and obtaining essential information like merchant name, logo, and tax ID. Authenticate s docTags: createdAt: 2021-01-25T14:30:20.000Z --- El API de Dev Connect permite a las aplicaciones generar el Access Token requerido para acceder a los servicios de los Comercios administrados de manera rápida y simple para los comercios. ### URL del Servicio :::BlockQuote https\://api.mobbex.com/p/developer/connect ::: :::ApiMethodV2 ```json { "tab": "examples", "url": "https://api.mobbex.com/p/developer/connect", "name": "Crear solicitud de Credenciales", "method": "POST", "request": { "pathParameters": [], "queryParameters": [], "headerParameters": [ { "kind": "optional", "name": "x-api-key", "type": "string", "description": "Clave API de su aplicación." } ], "bodyDataParameters": [ { "kind": "required", "name": "return_url", "type": "string", "description": "URL a la cual Mobbex deberá redireccionar al usuario al finalizar el proceso." } ], "formDataParameters": [] }, "results": { "languages": [ { "id": "Z3MlaAbetzclrzxZKHkja", "code": "{\n \"result\": true,\n \"data\": {\n \"id\": \"oZWpdzX7y\",\n \"url\": \"https://mobbex.com/p/developer/connect/oZWpdzX7y\"\n }\n}", "language": "200" } ], "selectedLanguageId": "Z3MlaAbetzclrzxZKHkja" }, "examples": { "languages": [ { "id": "-62aguiNwPcne-lcREAkK", "code": "var data = JSON.stringify({\n \"return_url\": \"mobbex.com/return/devconnect\"\n});\n\nvar 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(\"POST\", \"https://api.mobbex.com/p/developer/connect\");\nxhr.setRequestHeader(\"x-api-key\", \"zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj\");\nxhr.setRequestHeader(\"Content-Type\", \"application/json\");\n\nxhr.send(data);", "language": "javascript" }, { "id": "r7jR8DZ2-AjIIpqi2nrYk", "code": " 'https://api.mobbex.com/p/developer/connect',\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 \"return_url\": \"mobbex.com/return/devconnect\"\r\n}',\r\n CURLOPT_HTTPHEADER => array(\r\n 'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj',\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": "-62aguiNwPcne-lcREAkK" }, "description": "", "currentNewParameter": { "label": "Header Parameter", "value": "headerParameters" }, "autoGeneratedAnchorSlug": "crear-solicitud-de-credenciales", "legacyHash": "8EYmJpV0a_mgAW2WhRYgX" } ``` ::: :::hint{type="info"} ## Importante Redireccionar al usuario a la URL devuelta en data para la conexión. Si el resultado es positivo el usuario será redireccionado a la url declarada en "return\_url" agregando el parametro connectStatus en "done". Si el resultado es negativo será reenviado a la misma url con el status "cancelled". Si el status es Done se debe llamar a la siguiente URL para solicitar las credenciales. ::: :::ApiMethodV2 ```json { "tab": "examples", "url": "https://api.mobbex.com/p/developer/connect/{Connect_ID}/credentials", "name": "Obtención de Credenciales", "method": "GET", "request": { "pathParameters": [], "queryParameters": [ { "kind": "optional", "name": "Connect_ID", "type": "string", "description": "ID Retornado en la solicitud de credenciales." } ], "headerParameters": [ { "kind": "optional", "name": "x-api-key", "type": "string", "description": "Clave API de su aplicación." } ], "bodyDataParameters": [], "formDataParameters": [] }, "results": { "languages": [ { "id": "K1my1WQ52JAJimWEFQKRt", "code": "{\n \"result\": true,\n \"data\": {\n \"connectId\": \"oZWpdzX7y\",\n \"access_token\": \"XXXXXX-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXX\",\n \"entity\": {\n \"name\": \"Comercio de Prueba\",\n \"logo\": {\n \"filename\": \"comercio_de_prueba.png\",\n \"url\": \"https://s3.amazonaws.com/mobbex/files/images/comercio_de_prueba.png\",\n \"mimetype\": \"image/png\",\n \"extension\": \"png\",\n \"size\": 4472,\n \"width\": 250,\n \"height\": 250,\n \"sizes\": [\n \"medium\",\n \"small\",\n \"square\"\n ],\n \"versions\": [\n \"https://s3.amazonaws.com/mobbex/files/images/comercio_de_prueba-medium.png\",\n \"https://s3.amazonaws.com/mobbex/files/images/comercio_de_prueba-small.png\",\n \"https://s3.amazonaws.com/mobbex/files/images/comercio_de_prueba-square.png\"\n ],\n \"created\": \"2017-12-01T10:20:17.000Z\"\n },\n \"tax_id\": \"27121231230\"\n }\n }\n}", "language": "200" } ], "selectedLanguageId": "K1my1WQ52JAJimWEFQKRt" }, "examples": { "languages": [ { "id": "qFC1LScl6FjrrkmODCxBy", "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/developer/connect/oZWpdzX7y/credentials\");\nxhr.setRequestHeader(\"x-api-key\", \"zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj\");\n\nxhr.send();", "language": "javascript" }, { "id": "kqRc81BLxBy9-HEfm48eR", "code": " 'https://api.mobbex.com/p/developer/connect/oZWpdzX7y/credentials',\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 ),\r\n));\r\n\r\n$response = curl_exec($curl);\r\n\r\ncurl_close($curl);\r\necho $response;", "language": "php" } ], "selectedLanguageId": "qFC1LScl6FjrrkmODCxBy" }, "description": "Esta API debe ser llamada una vez que el cliente se haya autenticado correctamente tal como se indicó en la API anterior.", "currentNewParameter": { "label": "Header Parameter", "value": "headerParameters" }, "autoGeneratedAnchorSlug": "obtencin-de-credenciales", "legacyHash": "koUjVE_JKNrYihpb3Jdez" } ``` :::