Flujo de Pago
6 min
Este flujo es exclusivo para Cuenta/Billetera Habientes
sequenceDiagram
participant Aplicacion
participant Servicio
participant Interoperable
Aplicacion->>Servicio: Lee un QR
Servicio->>Interoperable: Envía el QR al endpoint "resolve"
Interoperable-->>Aplicacion: Devuelve los Medios de Pago
Servicio->>Interoperable: Llamada a Patch Plans
Interoperable-->>Aplicacion: Devuelve los Planes Calculados
Aplicacion->>Servicio: Elije Medio de Pago
Servicio->>Interoperable: Ejecuta el Pago
Interoperable-->>Aplicacion: Devuelve el resultado del Pago
Incluso durante los errores para resolver un QR el servicio contestará con un Order ID que podrá ser utilizado desde las API de Ordenes para obtener más detalles.
Leer/Resolver QR Con Cuenta/Billetera-Habiente
Este endpoint permite leer el QR
POST
https://api.interoperable.ar/qr/customer/{customer_id}/resolve
Path Parameters
- customer_idstringrequiredDescription
Query Parameters
- locstringDescription
Header Parameters
- Authorizationstringrequired
Body Parameters
- qr_rawstringrequiredDescription
- sourcesArray
- sources.[$]Object
- typestringrequiredDescription
- dataObjectrequired
- namestringrequiredDescription
- identificationstringrequiredDescription
- cvustringDescription
- cbustringDescription
- thirdPartyResolveObject
- qr_idstringrequired
- merchantObject
- namestring
- cuitstring
- categorystring
- field_of_activitystring
- mccstring
- zipstring
- free_tierBoolean
- iva_exemptBoolean
- imagestring
- accountstring
- transaction_typestringDescription
- countrystringDescription
- textstringDescription
curl
curl --location --globoff 'https://api.interoperable.ar/qr/customer/{customer_id}/resolve/{customer_id}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"qr_raw":"string"}'nodejs
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://api.interoperable.ar/qr/customer/{customer_id}/resolve/{customer_id}',
'headers': {
'Accept': 'application/json',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"qr_raw": "string"
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
javascript
var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Content-Type", "application/json");
var raw = JSON.stringify({
"qr_raw": "string"
});
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://api.interoperable.ar/qr/customer/{customer_id}/resolve/{customer_id}", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));python
import requests
import json
url = "https://api.interoperable.ar/qr/customer/{customer_id}/resolve/{customer_id}"
payload = json.dumps({
"qr_raw": "string"
})
headers = {
'Accept': 'application/json',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
ruby
require "uri"
require "json"
require "net/http"
url = URI("https://api.interoperable.ar/qr/customer/{customer_id}/resolve/{customer_id}")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
"qr_raw": "string"
})
response = https.request(request)
puts response.read_body
200
{
"id": "2O31V162NRYCELD6X30NQZ",
"currency": "ARS",
"total": 10,
"acquirers": [
"ar.interoperable"
],
"merchantData": {
"accountNumber": "XXXXXXXXXXXXXXXXX",
"accountType": "cvu",
"country": "ARG",
"countryCategoryCode": "641930",
"legalName": "Prueba 2",
"mcc": "6010",
"name": "Prueba 2",
"reference": "65a59b415d3731a69545a476",
"taxId": "20121231234",
"taxIdType": "arg.cuit",
"zipCode": "C1000AAA"
},
"localizedOrder": {},
"sources": [
{
"source": {
"uid": "65e5ec0561658049e63991ba",
"type": "card",
"data": {
"bin": "45079900",
"country": "ARG",
"expirationMonth": "12",
"expirationYear": "34",
"identification": "12123123",
"last4": "0010",
"name": "Demo Customer",
"type": "card"
},
"kind": "customer"
},
"data": {
"source": {
"card": {
"issuer": {
"color": "#122d98",
"logo": "https://res.mobbex.com/images/sources/png/visa.png",
"metadata": null,
"name": "Visa",
"shortName": "Visa",
"type": "unknown"
},
"level": "classic",
"product": {
"code": {
"length": 3,
"name": "CVV",
"position": 1
},
"gaps": [
4,
8,
12
],
"lengths": [
16
],
"logo": "https://res.mobbex.com/images/sources/png/visa.png",
"metadata": null,
"name": "Visa Débito",
"shortName": "Visa Débit",
"validation": [
"length",
"exp",
"cvv",
"luhn"
],
"variant": "debit"
}
},
"name": "Visa Débito",
"reference": "visa.debit",
"references": [
"visa.debit"
],
"type": "card"
},
"type": "card"
}
}
]
}500
{
"id": "2O31V162NRYCELD6X30NQZ",
"code": "500",
"message": "FAT_ERR"
}Extensiones para otros paises
El servicio permite extender las respuestas para otros países o pagos cross-border. Cuando se detecte un pago Cross Border cambiará la información del Merchant indicando correctamente el país y agregando en el campo "additional_info" toda la información extra recabada.
{
"id": "DR8AY5JPAIE1M5NCR9SS67",
"isStatic": true,
"currency": "ARS",
"total": 15000,
"acquirers": [],
"merchantData": {
"accountNumber": "0000000000000000000",
"accountType": "none",
"country": "BRA",
"legalName": "NOMBRE FANTASIA",
"mcc": "XXXX",
"name": "NOMBRE FANTASIA",
"reference": "8CEC2373-A74B-D9EA-62A44E32DF079BE7",
"taxId": "0000000000",
"taxIdType": "bra.cpf",
"zipCode": ""
},
"additional_info": {
"merchantCurrency": "BRL",
"merchantTotal": 10,
"exchangeRate": 1.4,
"exchangeRateLastUpdatedAt": 1762313608641
},
"localizedOrder": {},
"sources": []
}Patch Plans
PATCH
https://api.interoperable.ar/order/{order_id}/plans
Path Parameters
- order_idstringrequiredDescription
Query Parameters
- locstringDescription
- totalnumberDescription
Header Parameters
- Authorizationstringrequired
curl
curl --location --globoff --request PATCH 'https://api.interoperable.ar/qr/{order_id}/plans' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'nodejs
var request = require('request');
var options = {
'method': 'PATCH',
'url': 'https://api.interoperable.ar/qr/{order_id}/plans',
'headers': {
'Accept': 'application/json',
'Content-Type': 'application/json'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
javascript
var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Content-Type", "application/json");
var requestOptions = {
method: 'PATCH',
headers: myHeaders,
redirect: 'follow'
};
fetch("https://api.interoperable.ar/qr/{order_id}/plans", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));python
import requests
import json
url = "https://api.interoperable.ar/qr/{order_id}/plans"
payload = {}
headers = {
'Accept': 'application/json',
'Content-Type': 'application/json'
}
response = requests.request("PATCH", url, headers=headers, data=payload)
print(response.text)
ruby
require "uri"
require "json"
require "net/http"
url = URI("https://api.interoperable.ar/qr/{order_id}/plans")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
response = https.request(request)
puts response.read_body
200
{
"supported": [
{
"source": {
"uid": "CSP-TZLA1WRCMYSZ9XQ2SQAT03",
"type": "card",
"data": {
"bin": "45079900"
},
"kind": "customer"
},
"data": {
"installments": [
{
"uid": "CGq7Y9nfZ",
"count": 1,
"description": "",
"name": "Débito",
"order": 1,
"reference": "1",
"tags": [],
"totals": {
"currency": {
"exponent": 2,
"isoCode": "032",
"label": "Peso Argentino",
"locale": "es-AR",
"symbol": "$",
"value": "ARS"
},
"financial": {
"amount": 0,
"percentage": 0
},
"installment": {
"amount": 10,
"count": 1
},
"total": 10
}
}
],
"source": {
"card": {
"issuer": {
"color": "#122d98",
"logo": "https://res.mobbex.com/images/sources/png/visa.png",
"metadata": null,
"name": "Visa",
"shortName": "Visa",
"type": "unknown"
},
"level": "classic",
"product": {
"code": {
"length": 3,
"name": "CVV",
"position": 1
},
"gaps": [
4,
8,
12
],
"lengths": [
16
],
"logo": "https://res.mobbex.com/images/sources/png/visa.png",
"metadata": null,
"name": "Visa Débito",
"shortName": "Visa Débit",
"validation": [
"length",
"exp",
"cvv",
"luhn"
],
"variant": "debit"
}
},
"name": "Visa Débito",
"reference": "visa.debit",
"references": [
"visa.debit"
],
"type": "card"
},
"type": "card"
}
}
],
"unsupported": []
}500
{
"result": false,
}Creación de Token
Crear Token no es necesario en este flujo y sólo debe ser invocado si se desea hacer un pago con una tarjeta cargada por el cliente al momento del pago.
Crear Token
Pagar Orden via QR
POST
https://api.interoperable.ar/payments/tokens
Header Parameters
- AuthorizationstringrequiredDescription
Body Parameters
- cardObjectrequiredDescription
curl
curl --location 'https://api.interoperable.ar/payments/tokens' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"card":"Object"}'nodejs
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://api.interoperable.ar/payments/tokens',
'headers': {
'Accept': 'application/json',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"card": "Object"
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
javascript
var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Content-Type", "application/json");
var raw = JSON.stringify({
"card": "Object"
});
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://api.interoperable.ar/payments/tokens", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));python
import requests
import json
url = "https://api.interoperable.ar/payments/tokens"
payload = json.dumps({
"card": "Object"
})
headers = {
'Accept': 'application/json',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
ruby
require "uri"
require "json"
require "net/http"
url = URI("https://api.interoperable.ar/payments/tokens")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
"card": "Object"
})
response = https.request(request)
puts response.read_body
200
{
"created_at": "2024-03-04T10:44:49Z",
"expiry_at": "2024-03-04T10:59:49Z",
"token": "T:P0WG66KQ9WRPQQ9EETIECJ"
}404
{
"message": "Ain't no cake like that."
}Ejemplo de Solicitud de Creación de Token
{
"card": {
"holder": {
"name": "Demo",
"identification_type": "DNI",
"identification_number": "12123123"
},
"card_data": {
"number": "4507990000000010",
"security_code": "200",
"expiration_month": 12,
"expiration_year": 2032,
"entry_mode": "MANUAL"
}
}
}Pagar QR
Pagar Orden via QR
POST
https://api.interoperable.ar/orders/{order_id}/payments
Path Parameters
- order_idstringrequiredDescription
Query Parameters
- locstringDescription
Header Parameters
- AuthorizationstringrequiredDescription
Body Parameters
- sourcestringrequiredDescription
- installmentstringDescription
- totalnumberDescription
curl
curl --location --globoff 'https://api.interoperable.ar/orders/{order_id}/payments/{order_id}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"source":"string","installment":"string"}'nodejs
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://api.interoperable.ar/orders/{order_id}/payments/{order_id}',
'headers': {
'Accept': 'application/json',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"source": "string",
"installment": "string"
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
javascript
var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Content-Type", "application/json");
var raw = JSON.stringify({
"source": "string",
"installment": "string"
});
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://api.interoperable.ar/orders/{order_id}/payments/{order_id}", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));python
import requests
import json
url = "https://api.interoperable.ar/orders/{order_id}/payments/{order_id}"
payload = json.dumps({
"source": "string",
"installment": "string"
})
headers = {
'Accept': 'application/json',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
ruby
require "uri"
require "json"
require "net/http"
url = URI("https://api.interoperable.ar/orders/{order_id}/payments/{order_id}")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
"source": "string",
"installment": "string"
})
response = https.request(request)
puts response.read_body
200
{
"data": {
"data": {
"entity": {
"name": "Prueba 2",
"uid": "arg.test:123"
},
"payment": {
"id": "CHD-0KJ3NPGCC9B49QBA7C",
"reference": "CHD-T8TW2J30R3HGUFHNNE",
"source": {
"cardholder": {
"identification": "33996953",
"name": ""
},
"expiration": {
"month": "12",
"year": "34"
},
"installment": {
"amount": 10,
"count": 1,
"description": "Débito",
"reference": "1",
"uid": "CGq7Y9nfZ"
},
"name": "Visa Débito",
"number": "45079900****0010",
"reference": "visa.debit",
"transaction": {
"authorizationCode": "",
"batchNo": "",
"resultCode": "03",
"retrievalReferenceNo": "",
"ticketNo": "",
"transactionId": "CHD-0KJ3NPGCC9B49QBA7C"
},
"type": "card"
},
"status": {
"code": "500",
"data": {},
"message": "Error en emisor, reintentar operación. (Cod. 03)",
"resultCode": "03",
"text": "Error",
"view": "default"
},
"total": 10
},
"source": {
"name": "Visa Débito",
"reference": "visa.debit",
"type": "card"
},
"view": {
"type": "card"
}
},
"id": "CHD-0KJ3NPGCC9B49QBA7C",
"status": "500"
},
"result": true
}404
{
"message": "Ain't no cake like that."
}{
"source": "CST-96FMMYYFOUKKG7FJLIHKTG"
}Devolver Operación
Devolución de la Orden
DELETE
https://api.interoperable.ar/orders/{order_id}/payments
Path Parameters
- order_idstringrequiredDescription
Header Parameters
- Authorizationstring
curl
curl --location --globoff --request DELETE 'https://api.interoperable.ar/orders/{order_id}/payments/{order_id}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'nodejs
var request = require('request');
var options = {
'method': 'DELETE',
'url': 'https://api.interoperable.ar/orders/{order_id}/payments/{order_id}',
'headers': {
'Accept': 'application/json',
'Content-Type': 'application/json'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
javascript
var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Content-Type", "application/json");
var requestOptions = {
method: 'DELETE',
headers: myHeaders,
redirect: 'follow'
};
fetch("https://api.interoperable.ar/orders/{order_id}/payments/{order_id}", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));python
import requests
import json
url = "https://api.interoperable.ar/orders/{order_id}/payments/{order_id}"
payload = {}
headers = {
'Accept': 'application/json',
'Content-Type': 'application/json'
}
response = requests.request("DELETE", url, headers=headers, data=payload)
print(response.text)
ruby
require "uri"
require "json"
require "net/http"
url = URI("https://api.interoperable.ar/orders/{order_id}/payments/{order_id}")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
response = https.request(request)
puts response.read_body
200
{
"result": true,
"status_message": "",
"transaction_id": "1CGEMKERVARWBKE49EBRE9"
}