Primeros Pasos
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
- client_idstringrequiredDescription
- client_secretstringDescription
curl --location --request POST 'https://api.interoperable.ar/app/login' \
--header 'Accept: application/json' \
--data-raw '{"client_id":"string","client_secret":"string"}'var request = require('request');
var options = {
'method': 'POST',
'url': 'https://api.interoperable.ar/app/login',
'headers': {
'Accept': 'application/json'
},
body: '{"client_id":"string","client_secret":"string"}'
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
var raw = "{\"client_id\":\"string\",\"client_secret\":\"string\"}";
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://api.interoperable.ar/app/login", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));import requests
url = "https://api.interoperable.ar/app/login"
payload = "{\"client_id\":\"string\",\"client_secret\":\"string\"}"
headers = {
'Accept': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
require "uri"
require "net/http"
url = URI("https://api.interoperable.ar/app/login")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Accept"] = "application/json"
request.body = "{\"client_id\":\"string\",\"client_secret\":\"string\"}"
response = https.request(request)
puts response.read_body
{
"expires_at": 1682590149,
"prefix": "Bearer",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHAiOiI2NDQ1YjljZjU4ZWQwNDAzMDAwZWJlOWEiLCJleHAiOjE2ODI1OTAxNDl9.2YrUGKLmkAVB7oOwK7CAlEwZOB267w15YZAJZRSguLE"
}{
"data": "UNAUTHORIZED",
"result": false
}- client_idstringrequiredDescription
- client_secretstringrequiredDescription
- grant_typestringrequiredDescription
curl --location --request POST 'https://api.interoperable.ar/app/login' \
--header 'Accept: application/json' \
--data-raw '{"client_id":"string","client_secret":"string"}'var request = require('request');
var options = {
'method': 'POST',
'url': 'https://api.interoperable.ar/app/login',
'headers': {
'Accept': 'application/json'
},
body: '{"client_id":"string","client_secret":"string"}'
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
var raw = "{\"client_id\":\"string\",\"client_secret\":\"string\"}";
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://api.interoperable.ar/app/login", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));import requests
url = "https://api.interoperable.ar/app/login"
payload = "{\"client_id\":\"string\",\"client_secret\":\"string\"}"
headers = {
'Accept': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
require "uri"
require "net/http"
url = URI("https://api.interoperable.ar/app/login")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Accept"] = "application/json"
request.body = "{\"client_id\":\"string\",\"client_secret\":\"string\"}"
response = https.request(request)
puts response.read_body
{
"expires_at": 1682590149,
"prefix": "Bearer",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHAiOiI2NDQ1YjljZjU4ZWQwNDAzMDAwZWJlOWEiLCJleHAiOjE2ODI1OTAxNDl9.2YrUGKLmkAVB7oOwK7CAlEwZOB267w15YZAJZRSguLE"
}{
"data": "UNAUTHORIZED",
"result": false
}Esta llave JWT generada deberá ser enviada en las llamadas a los servicios de la API en el campo Authorization.
curl --location --request GET 'https://api.interoperable.ar/status' \
--header 'Accept: application/json'var request = require('request');
var options = {
'method': 'GET',
'url': 'https://api.interoperable.com.ar/status',
'headers': {
'Accept': 'application/json'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
var requestOptions = {
method: 'GET',
headers: myHeaders,
redirect: 'follow'
};
fetch("https://api.interoperable.com.ar/status", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));import requests
url = "https://api.interoperable.com.ar/status"
payload={}
headers = {
'Accept': 'application/json'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
require "uri"
require "net/http"
url = URI("https://api.interoperable.com.ar/status")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Accept"] = "application/json"
response = https.request(request)
puts response.read_body
{
"data": "OK",
"result": true
}