---
title: Primeros Pasos
slug: docs.interoperable.ar
description: Learn about the QR Interoperable service that brings compatibility to QR codes across different markets. This document explains how the service unifies specifications, enabling banks, virtual wallets, and integrators to implement it. Discover the various 
icon: {"faIcon":"fa-solid fa-star"}
createdAt: 2023-04-24T08:51:33.000Z
---

El servicio de QR Interoperable se propone como un sistema completamente interoperable con todos los QR disponibles en los diferentes mercados. Nuestro objetivo es unificar en un mismo QR todas las especificaciones de cada país, de cada sistema y de cada marca en el caso de las tarjetas. Nuestro servicio es agnostico y puede ser implementado tanto por Bancos, Billeteras Virtuales como por Integradores desde el lado de la aceptación.

El servicio se encuentra abierto a la incoporación de nuevos Operadores y Procesadores más allá de los ofrecidos actualmente.

Actualmente Interoperable soporta los siguientes medios de Pago según el país:

**Argentina**

- Transferencias 3.0
- Tarjetas de Crédito/Prepaga/Débito

**Uruguay**

- Tarjetas de Crédito/Prepaga/Débito
- Cuenta Bancaria ( En Progreso )

**Chile**

- Tarjetas de Crédito/Prepaga/Débito

# Conceptos Generales

### Operador

Un operador constituye la entidad que permite administrar múltiples cuentas tanto de Comercios como Billetera-Habientes

Existen 2 tipos de Operadores:

- Administradores de Cuentas: Bancos, Billeteras, Recaudadores
- Adquirentes: Comercios

Modos de Funcionamiento:

- Productivos
- Desarrollo o Sandbox

### Cliente / Billetera-Habiente

Dueño de la Billetera o Cuenta Bancaria que iniciará los pagos.

### Comercio

Receptor de los pagos de los Clientes / Billetera-Habientes

### Procesadores

El servicio provee de diversos procesadores dependiento del medio de pago con el que se necesite pagar.

| Medio de Pago                       | Procesador      | Estado      |
| ----------------------------------- | --------------- | ----------- |
| Transferencias 3.0                  | Coelsa          | Finalizado  |
| Transferencias 3.0                  | NewPay / PayWay | Finalizado  |
| Tarjetas de Crédito/Débito/Prepagas | Mobbex          | Finalizado  |
| Tarjetas de Crédito/Débito/Prepagas | SUGA            | Finalizado  |
| MODO                                | MODO            | En Progreso |
| Mercado Pago                        | Mercado Pago    | En Progreso |

### Credenciales

Existen 2 tipos de credenciales, las de Tipo Merchant y las de Tipo Customer, cada una será utilizada para las diferentes acciones del servicio. Las diferentes llamadas via Webhook serán firmadas utilizando el Client Secret entregado durante la implementación.



### Autenticación

Existen 2 tipos de autenticación:

- OAuth: más moderna y segura
- Auth: basada en tokens dinámicos generados a partir de un login
- Token: basada en tokens estáticos
-

Credenciales Provistas

- Client ID
- Client Secret

:::ApiMethodV2
```json
{
  "tab": "examples",
  "url": "https://api.interoperable.ar/app/login",
  "name": "Auth",
  "method": "POST",
  "request": {
    "pathParameters": [],
    "queryParameters": [],
    "headerParameters": [],
    "bodyDataParameters": [
      {
        "kind": "required",
        "name": "client_id",
        "type": "string",
        "description": "Client ID Provisto"
      },
      {
        "kind": "optional",
        "name": "client_secret",
        "type": "string",
        "children": [],
        "description": "Client ID Provisto"
      }
    ],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "iaGVb3p3bSOJid8ey6mJb",
        "code": "{\n\t\"expires_at\": 1682590149,\n\t\"prefix\": \"Bearer\",\n\t\"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHAiOiI2NDQ1YjljZjU4ZWQwNDAzMDAwZWJlOWEiLCJleHAiOjE2ODI1OTAxNDl9.2YrUGKLmkAVB7oOwK7CAlEwZOB267w15YZAJZRSguLE\"\n}",
        "language": "200",
        "customLabel": ""
      },
      {
        "id": "bXKRkONOO8YhtcFx0_EvY",
        "code": "{\n\t\"data\": \"UNAUTHORIZED\",\n\t\"result\": false\n}",
        "language": "401",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "iaGVb3p3bSOJid8ey6mJb"
  },
  "examples": {
    "languages": [
      {
        "id": "Tfjt7EEALPlCTx67W_91l",
        "code": "curl --location --request POST 'https://api.interoperable.ar/app/login' \\\n--header 'Accept: application/json' \\\n--data-raw '{\"client_id\":\"string\",\"client_secret\":\"string\"}'",
        "language": "curl",
        "customLabel": ""
      },
      {
        "id": "5ztZlDum3OLvTGKhf9mX4",
        "code": "var request = require('request');\nvar options = {\n   'method': 'POST',\n   'url': 'https://api.interoperable.ar/app/login',\n   'headers': {\n      'Accept': 'application/json'\n   },\n   body: '{\"client_id\":\"string\",\"client_secret\":\"string\"}'\n\n};\nrequest(options, function (error, response) {\n   if (error) throw new Error(error);\n   console.log(response.body);\n});\n",
        "language": "nodejs",
        "customLabel": ""
      },
      {
        "id": "iJZuaZhd0nkGJ52KSeL8S",
        "code": "var myHeaders = new Headers();\nmyHeaders.append(\"Accept\", \"application/json\");\n\nvar raw = \"{\\\"client_id\\\":\\\"string\\\",\\\"client_secret\\\":\\\"string\\\"}\";\n\nvar requestOptions = {\n   method: 'POST',\n   headers: myHeaders,\n   body: raw,\n   redirect: 'follow'\n};\n\nfetch(\"https://api.interoperable.ar/app/login\", requestOptions)\n   .then(response => response.text())\n   .then(result => console.log(result))\n   .catch(error => console.log('error', error));",
        "language": "javascript",
        "customLabel": ""
      },
      {
        "id": "qGT7oTDvpGljq5kPya1zT",
        "code": "import requests\n\nurl = \"https://api.interoperable.ar/app/login\"\n\npayload = \"{\\\"client_id\\\":\\\"string\\\",\\\"client_secret\\\":\\\"string\\\"}\"\nheaders = {\n   'Accept': 'application/json'\n}\n\nresponse = requests.request(\"POST\", url, headers=headers, data=payload)\n\nprint(response.text)\n",
        "language": "python",
        "customLabel": ""
      },
      {
        "id": "2TGn89EaxJ5fGf86Gnx5M",
        "code": "require \"uri\"\nrequire \"net/http\"\n\nurl = URI(\"https://api.interoperable.ar/app/login\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Post.new(url)\nrequest[\"Accept\"] = \"application/json\"\nrequest.body = \"{\\\"client_id\\\":\\\"string\\\",\\\"client_secret\\\":\\\"string\\\"}\"\n\nresponse = https.request(request)\nputs response.read_body\n",
        "language": "ruby",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "2TGn89EaxJ5fGf86Gnx5M"
  },
  "description": "Permite generar la llave JWT para utilizar el servicio.",
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  },
  "hasTryItOut": false,
  "autoGeneratedAnchorSlug": "auth",
  "legacyHash": "weht0sppCAsy-HxcyW-uR"
}
```
:::

:::ApiMethodV2
```json
{
  "tab": "examples",
  "url": "https://api.interoperable.ar/app/oauth/login",
  "name": "OAuth",
  "method": "POST",
  "request": {
    "pathParameters": [],
    "queryParameters": [],
    "headerParameters": [],
    "bodyDataParameters": [
      {
        "kind": "required",
        "name": "client_id",
        "type": "string",
        "description": "Client ID Provisto"
      },
      {
        "kind": "required",
        "name": "client_secret",
        "type": "string",
        "description": "Client ID Provisto",
        "": "required"
      },
      {
        "name": "grant_type",
        "kind": "required",
        "type": "string",
        "description": "Valor Fijo: client_credentials",
        "": "Valor Fijo: client_credentials"
      }
    ],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "iaGVb3p3bSOJid8ey6mJb",
        "code": "{\n\t\"expires_at\": 1682590149,\n\t\"prefix\": \"Bearer\",\n\t\"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHAiOiI2NDQ1YjljZjU4ZWQwNDAzMDAwZWJlOWEiLCJleHAiOjE2ODI1OTAxNDl9.2YrUGKLmkAVB7oOwK7CAlEwZOB267w15YZAJZRSguLE\"\n}",
        "language": "200",
        "customLabel": ""
      },
      {
        "id": "bXKRkONOO8YhtcFx0_EvY",
        "code": "{\n\t\"data\": \"UNAUTHORIZED\",\n\t\"result\": false\n}",
        "language": "401",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "iaGVb3p3bSOJid8ey6mJb"
  },
  "examples": {
    "languages": [
      {
        "id": "Tfjt7EEALPlCTx67W_91l",
        "code": "curl --location --request POST 'https://api.interoperable.ar/app/login' \\\n--header 'Accept: application/json' \\\n--data-raw '{\"client_id\":\"string\",\"client_secret\":\"string\"}'",
        "language": "curl",
        "customLabel": ""
      },
      {
        "id": "5ztZlDum3OLvTGKhf9mX4",
        "code": "var request = require('request');\nvar options = {\n   'method': 'POST',\n   'url': 'https://api.interoperable.ar/app/login',\n   'headers': {\n      'Accept': 'application/json'\n   },\n   body: '{\"client_id\":\"string\",\"client_secret\":\"string\"}'\n\n};\nrequest(options, function (error, response) {\n   if (error) throw new Error(error);\n   console.log(response.body);\n});\n",
        "language": "nodejs",
        "customLabel": ""
      },
      {
        "id": "iJZuaZhd0nkGJ52KSeL8S",
        "code": "var myHeaders = new Headers();\nmyHeaders.append(\"Accept\", \"application/json\");\n\nvar raw = \"{\\\"client_id\\\":\\\"string\\\",\\\"client_secret\\\":\\\"string\\\"}\";\n\nvar requestOptions = {\n   method: 'POST',\n   headers: myHeaders,\n   body: raw,\n   redirect: 'follow'\n};\n\nfetch(\"https://api.interoperable.ar/app/login\", requestOptions)\n   .then(response => response.text())\n   .then(result => console.log(result))\n   .catch(error => console.log('error', error));",
        "language": "javascript",
        "customLabel": ""
      },
      {
        "id": "qGT7oTDvpGljq5kPya1zT",
        "code": "import requests\n\nurl = \"https://api.interoperable.ar/app/login\"\n\npayload = \"{\\\"client_id\\\":\\\"string\\\",\\\"client_secret\\\":\\\"string\\\"}\"\nheaders = {\n   'Accept': 'application/json'\n}\n\nresponse = requests.request(\"POST\", url, headers=headers, data=payload)\n\nprint(response.text)\n",
        "language": "python",
        "customLabel": ""
      },
      {
        "id": "2TGn89EaxJ5fGf86Gnx5M",
        "code": "require \"uri\"\nrequire \"net/http\"\n\nurl = URI(\"https://api.interoperable.ar/app/login\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Post.new(url)\nrequest[\"Accept\"] = \"application/json\"\nrequest.body = \"{\\\"client_id\\\":\\\"string\\\",\\\"client_secret\\\":\\\"string\\\"}\"\n\nresponse = https.request(request)\nputs response.read_body\n",
        "language": "ruby",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "2TGn89EaxJ5fGf86Gnx5M"
  },
  "description": "Permite generar la llave JWT para utilizar el servicio.",
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  },
  "hasTryItOut": false,
  "autoGeneratedAnchorSlug": "oauth",
  "legacyHash": "NqzOi4I8-8h2rmO1z8PmP"
}
```
:::

Esta llave JWT generada deberá ser enviada en las llamadas a los servicios de la API en el campo ***Authorization.***

:::ApiMethodV2
```json
{
  "tab": "examples",
  "url": "https://api.interoperable.ar/status",
  "name": "Estado del Servicio",
  "method": "GET",
  "request": {
    "pathParameters": [],
    "queryParameters": [],
    "headerParameters": [],
    "bodyDataParameters": [],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "u3jcdSXXuvxy-7IKXbSBH",
        "code": "{\n\t\"data\": \"OK\",\n\t\"result\": true\n}",
        "language": "200",
        "customLabel": ""
      },
      {
        "id": "EP7DJDzvFaEeq-DiqW4I9",
        "code": "",
        "language": "500",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "u3jcdSXXuvxy-7IKXbSBH"
  },
  "examples": {
    "languages": [
      {
        "id": "5Rk2ASHyBMHNAxkjxHSc_",
        "code": "curl --location --request GET 'https://api.interoperable.ar/status' \\\n--header 'Accept: application/json'",
        "language": "curl",
        "customLabel": ""
      },
      {
        "id": "qO5DtsL0OFRdnr1xJjbvD",
        "code": "var request = require('request');\nvar options = {\n   'method': 'GET',\n   'url': 'https://api.interoperable.com.ar/status',\n   'headers': {\n      'Accept': 'application/json'\n   }\n};\nrequest(options, function (error, response) {\n   if (error) throw new Error(error);\n   console.log(response.body);\n});\n",
        "language": "nodejs",
        "customLabel": ""
      },
      {
        "id": "Lnom8ce8MI3XJH3mVVjiH",
        "code": "var myHeaders = new Headers();\nmyHeaders.append(\"Accept\", \"application/json\");\n\nvar requestOptions = {\n   method: 'GET',\n   headers: myHeaders,\n   redirect: 'follow'\n};\n\nfetch(\"https://api.interoperable.com.ar/status\", requestOptions)\n   .then(response => response.text())\n   .then(result => console.log(result))\n   .catch(error => console.log('error', error));",
        "language": "javascript",
        "customLabel": ""
      },
      {
        "id": "BBnmewDUcd6orwerborNL",
        "code": "import requests\n\nurl = \"https://api.interoperable.com.ar/status\"\n\npayload={}\nheaders = {\n   'Accept': 'application/json'\n}\n\nresponse = requests.request(\"GET\", url, headers=headers, data=payload)\n\nprint(response.text)\n",
        "language": "python",
        "customLabel": ""
      },
      {
        "id": "G1PQHDdYNlrcl3VnZsjW_",
        "code": "require \"uri\"\nrequire \"net/http\"\n\nurl = URI(\"https://api.interoperable.com.ar/status\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Get.new(url)\nrequest[\"Accept\"] = \"application/json\"\n\nresponse = https.request(request)\nputs response.read_body\n",
        "language": "ruby",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "5Rk2ASHyBMHNAxkjxHSc_"
  },
  "description": "Permite conocer el estado del Servicio",
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  },
  "hasTryItOut": false,
  "autoGeneratedAnchorSlug": "estado-del-servicio",
  "legacyHash": "HbTm3_KfQbown2LfiUy76"
}
```
:::

