Leer QR

Productos en los que aplica:

WALLET / PSP

Descripción

Consulta la información de un QR que esté conformado de forma standard según EMVco y que pertenezca al ecosistema de interoperabilidad de Argentina.

El sistema consulta a la API Resolve del Aceptador dueño del QR para obtener la información necesaria para luego instruir el PCT.

Este servicio responde con la misma estructura standard con la que responde la API Resolve.

Endpoint

GET

/walletentidad-operaciones/v1/api/v1.201/QR/GetInfoPagoQR[?textoQR]

Request

textoQR string
REQUIRED
String que conforma la imagen QR. Resulta de leer e interpretar el código QR que se quiere pagar.

Ejemplo de request

Copy code

curl --location 'https://gw-staging-qrbind.epays.services/walletentidad-operaciones/v1/api/v1.201/QR/GetInfoPagoQR?textoQR=00020101021102080000000041370012com.TESTbind98113069226478599020143220018B00000495128ET000Z5015001130707101020512600220000531909000067076630520454115802AR5918GRANJAS%20CARNAVE%20SA6012BUENOS%20AIRES61041000530303262100706S1691281050001Z63043626' \
--header 'Authorization: Bearer 12345XAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6Ikg5bmo1QU9Tc3dNcGhnMVNGeDdqYVYtbEI5dyJ9.eyJhdWQiOiJiNmQ1OTEyYi00ZTM0LTRmYjItOWYzMS0yNzEzZTEwYWY3NDUiLCJpc3MiOiJodHRwczovL2xvZ2luLm1pY3Jvc29mdG9ubGluZS5jb20vNjFlZjViODktOGRmMy00OTlkLThjMTMtMzhmZWQ1ZDA5YzcyL3YyLjAiLCJpYXQiOjE3MjU0MDYwNjMsIm5iZiI6MTcyNTQwNjA2MywiZXhwIjoxNzI1NDA5OTYzLCJhaW8iOiJFMmRnWUVnOThhNzUyTW5Zb0xySmxTb0pmMlNXNWlTeitUaHZXSC9sbHRFRmpkNzZUUjBBIiwiYXpwIjoiMDQ5MjgyOTgtNGM3Zi00OTEyLWFiYTgtZThhOGY1NmZhZDVkIiwiYXpwYWNyIjoiMSIsIm9pZCI6ImFhNmIyMTFiLTVmZDMtNDUzYi1iMzBkLTA4MzNhMzE4MDU5YiIsInJoIjoiMC5BWDBBaVZ2dllmT05uVW1NRXpqLTFkQ2NjaXVSMWJZMFRySlBuekVuRS1FSzkwV2FBQUEuIiwicm9sZXMiOlsiR3JvdXAuQWRtaW4iLCJYLUVudGlkYWQuMSIsIlgtQ2xpZW50TmFtZS53YWxsZXRBZG1pbiJdLCJzdWIiOiJhYTZiMjExYi01ZmQzLTQ1M2ItYjMwZC0wODMzYTMxODA1OWIiLCJ0aWQiOiI2MWVmNWI4OS04ZGYzLTQ5OWQtOGMxMy0zOGZlZDVkMDljNzIiLCJ1dGkiOiIzWXpxY3FReTZFV2JTeG11V210NEFBIiwidmVyIjoiMi4wIn0.ey4rp8DSNU62kpU6qCZZtVS8OoCFmuz3tItX83qraA99qoYVpBqvgkcodLD7QjCrzwu0WYuucCY8_s_i_NPux6GzX1RD3_fUWiLeVMsXnDx42en_xBIt-ndlpncqGIimgTjtlgz-lbYpwfAFz_wq4Ktqpl0_O9pRdCuos1awBxuiXomUZ9tZ26c6h4pOYD_aTVklqIOaka6odHpIRDlvfcmvnuumDcNVzN1SmJEsZUzJnzSb4gOZcLuQxqg7x0r0VK-54YCuUck8sSyHUulozQxQoTZ5iqRVvAujzhtmeE6HvLwWvhzU74OYkSFVEduM8v5MuRjFsnzkA3APii7Qkw'

Response

status string
Estado del QR según standard de Transferencia 3.0.
Valores posibles:
"open_amount" = El QR no requiere una orden de monto cerrado asociada y simplemente tiene el QR a la vista. Es necesario que el comprador ingrese manualmente el monto a abonar.
"closed_amount" = El QR es de monto cerrado, requiere de una orden de monto cerrado y la información de la venta está disponible. El pagador tiene así toda la información requerida para confirmar el pago.
"pending" = El QR es de monto cerrado, requiere de una orden de monto cerrado y la información de la venta no está disponible. El pagador debe por tanto esperar y reintentar más tarde. Este escenario podría repetirse sucesivas veces mientras la información no esté disponible. La respuesta indica el delay mínimo antes de reintentar en segundos. Estos valores pueden variar según la cantidad de reintentos ya realizados y el tipo de local (petroleras, comida rápida, etc.) y por tanto deben ser respetados.
"time-out" = El comprador está escaneando un QR y se ha caído en el escenario status: pending, requiriéndose reintentos. Sin embargo, ha pasado demasiado tiempo y no hemos logrado obtener del vendedor la información de la venta. Por lo tanto, se decide abortar la operación.
"empty_order" = El vendedor está haciendo uso de una integración directa con el acquirer, pero aún no hay nada por cobrar (por ejemplo, período de gracia en un estacionamiento, o una orden sin items). El pagador debe por tanto esperar y reintentar escaneando nuevamente el QR.
"authentication_error" = Hubo errores de autenticación para obtener la información del QR. Reclamar a Bind PSP para que lo resuelva con el vendedor.
"unsupported_qr_code" = El comprador está escaneando un QR que no es válido. Este escenario debiera ser filtrado por la app al analizar el contenido del QR EMVCo, pero en caso de no hacerlo podría suceder.
"unsupported_merchant" = El vendedor aún no ha verificado su identidad y definido su alias para generar su CVU, siendo por tanto imposible proceder con el pago.
"error" = Hubo algún error general al intentar obtener la información del QR. Reclamar a Bind PSP para que lo resuelva con el vendedor.

acceptor object
Objeto con información del aceptador (Banco o PSP del comercio)

name string
Nombre del aceptador (Banco o PSP del comercio).

identification string
Nombre del aceptador (Banco o PSP del comercio).

administrator object
Objeto con información del administrador de interoperabilidad (Coelsa, LINK o Prisma).

name string
Nombre del administrador de interoperabilidad (Coelsa, LINK o Prisma).

identification_number string
Nombre del administrador de interoperabilidad (Coelsa, LINK o Prisma).

collector object
Objeto con información del comercio.

name string
Nombre del comercio.

identification_number string
CUIT del comercio.

account string
CBU/CVU en la que se acredita al comercio.

mcc string
Rubro del comercio según MCC de VISA.

bank string
Identificador del banco de la cuenta del comercio

branch_office string
Número de comercio o sucursal interno. Puede ser vacío.

terminal string
Número de terminal. Puede ser vacío.

order object
Objeto con información de la orden a pagar. Esta información sólo estará disponible para casos de lectura exitosos.

items object
Objeto con información de los items que están incluídos en la orden. Puede ser vacío.

id string
Identificador de la orden. Este dato es necesario al iniciar el pago PCT de este QR.

total_amount double
Importe a pagar. Si se trata de un QR de monto abierto (status: open_amount), el valor será null.

additional_info object
Objeto con info adicional. Es para uso opcional de cada aceptador. Puede ser vacío

retry_delay int
Delay mínimo antes de reintentar una nueva lectura,en segundos.





Ejemplo de response

HTTP 200

Lectura exitosa. El QR es de monto abierto y se puede pagar

Copy code

HTTP 200

Lectura exitosa. El QR es de monto abierto y se puede pagar

Copy code

HTTP 200

Lectura exitosa. El QR es de monto abierto y se puede pagar

Copy code

HTTP 200

Lectura exitosa. El QR es de monto cerrado y se puede pagar

Copy code

HTTP 200

Lectura exitosa. El QR es de monto cerrado y se puede pagar

Copy code

HTTP 200

Lectura exitosa. El QR es de monto cerrado y se puede pagar

Copy code

HTTP 200

Lectura exitosa. El QR es de monto cerrado pero no tiene orden para pagar

Copy code

HTTP 200

Lectura exitosa. El QR es de monto cerrado pero no tiene orden para pagar

Copy code

HTTP 200

Lectura exitosa. El QR es de monto cerrado pero no tiene orden para pagar

Copy code

HTTP 200

Lectura exitosa. El QR es de monto cerrado pero sin orden de venta disponible y que ya se han realizado la cantidad de reintentos máximos

Copy code

HTTP 200

Lectura exitosa. El QR es de monto cerrado pero sin orden de venta disponible y que ya se han realizado la cantidad de reintentos máximos

Copy code

HTTP 200

Lectura exitosa. El QR es de monto cerrado pero sin orden de venta disponible y que ya se han realizado la cantidad de reintentos máximos

Copy code

HTTP 200

El comercio responde un error genérico

Copy code

HTTP 200

El comercio responde un error genérico

Copy code

HTTP 200

El comercio responde un error genérico

Copy code

HTTP 200

El comercio no está habilitado para operar

Copy code

HTTP 200

El comercio no está habilitado para operar

Copy code

HTTP 200

El comercio no está habilitado para operar

Copy code

HTTP 422

QR ingresado es inválido o no cumple con el standard

Copy code

HTTP 422

QR ingresado es inválido o no cumple con el standard

Copy code

HTTP 422

QR ingresado es inválido o no cumple con el standard

Copy code

API REFERENCE

Filtrar por producto:

QR ESTÁTICO

QR DINÁMICO

REC. X TRANSFERENCIA

BOTÓN SIMPLE

DISPOSITIVO POS

WALLET / PSP

Autenticación

Cobrar con QR dinámico

API REFERENCE

API REFERENCE

API REFERENCE