Paga con QR

Conoce el paso a paso de cómo crear un pago con QR en Argentina.

Crear un pago con QR en Argentina consiste en capturar los datos necesarios del cliente para el pago y hacer una solicitud a través de nuestra API con un Bearer Token y una secretKey. De esta forma, las transacciones se autentican y se realizan de forma segura.

📘

Pagos con QR

Este método procesa transacciones con todas las billeteras en Argentina y soporta hasta 2000 transacciones por segundo (TPS).


¿Cómo funciona?

El proceso de pago con wallet en Argentina consta de cuatro etapas principales:

  1. Selección de método. El cliente elige pagar con código QR en tu sitio web.
  2. Generación del QR. ProntoPaga le entrega un QR único al cliente, que podrá escanear con la aplicación de la wallet con la que pagará.
  3. Pago en web. El cliente abre la aplicación bancaria o wallet, escanea el código QR y hace el pago. El dinero se mueve desde la wallet del cliente hacia la cuenta de tu comercio.
  4. Confirmación. El cliente recibe una confirmación de pago exitoso en su correo electrónico. A su vez, tu comercio recibe la confirmación del pago a través de los webhooks que hayas configurado.

Crear un nuevo pago

Tu front-end será el encargado de recopilar los datos necesarios de tu cliente para procesar el pago, mientras que tu back-end estará integrado con nuestra API, procesando el pago.

Body de la solicitud

Para crear una solicitud de nuevo pago deberás usar este endpoint y colocar ar_qr_payment como método de pago en el body de la solicitud.

La solicitud se envía con tu Bearer Token, así como con tu secretKey. Además, debes incluir los datos necesarios del cliente para hacer el pago, como nombre, correo electrónico, teléfono, país, moneda, monto, entre otros.

🚧

Firma de la transacción

Puedes ver el detalle de cómo firmar los parámetros de la transacción con tu secretKey en este artículo.

También deberás incluir la URL de retorno en caso de que la transacción sea exitosa, así como una URL en caso de que el pago sea rechazado.

📘

Notificación del estado de la transacción

Para configurar el webhook que irá en el campo urlConfirmation y recibir notificaciones con el estado de tu transacción, revisa este artículo.

A continuación puedes ver el ejemplo del body request:

{
    "currency": "ARS",
    "country": "AR",
    "amount": "34000.90",
    "clientName": "John Doe",
    "clientEmail": "[email protected]",
    "clientPhone": "999999999",
    "clientDocument": "12345678912",
    "paymentMethod": "ar_qr_payment",
    "urlConfirmation": "https://www.webhook.com",
    "urlFinal": "https://sandbox.prontopaga.com/successful",
    "urlRejected": "https://sandbox.prontopaga.com/declined",
    "order": "XYZ789"
}

Respuesta

Como respuesta a una solicitud de pago exitosa, recibirás un enlace para procesar el pago, así como un identificador de pago del sistema.

Ejemplo de respuesta para solicitud exitosa

{
    "uid": "01KB5Q3HCRQZVPFXZTKESCRHDK",
    "reference": "17643498227932",
    "urlPay": "https://www.webhook.com"
}

Ejemplo de respuesta de pago rechazado

{ 
   "uid": "ID in our services",
   "status": "rejected",
   "reference": "Reason for rejection" 
}

Ejemplo de error

{
  "statusCode": 400,
  "message": "Validation failed",
  "errors": [
    {
      "field": "amount",
      "message": "Amount must be a positive number"
    }
  ],
  "timestamp": "2025-04-25T07:00:00.000Z",
  "path": "/transaction/create"
}

Consultar un pago

Una vez que el usuario haya completado el proceso de pago en el formulario, ProntoPaga le mostrará una ventana con el resultado final de su transacción. Al mismo tiempo, devolverá los datos de la transacción a la URL que especificaste en urlConfirmation.

Para confirmar si una transacción fue exitosa, debes verificar que en tu webhook el valor del campo status sea SUCCESS.

Conoce todos los estados posibles de un pago en el siguiente enlace: Estados de los pay ins.

Ejemplo de pago exitoso

{
  "status": "SUCCESS"
}

Cancelar transacción

Si un cliente generó un QR o código, pero no realizó el pago al momento, puedes cancelarlo para evitar que el cliente intente pagar después. El endpoint responde con una página HTML de ProntoPaga, donde se muestra el estado cancelado de la transacción.

Para cancelar un pago, consulta estos endpoints con tu Bearer Token y mandar el uid del pago en la URL de la solicitud.

❗️

Ten en cuenta que

Los pagos con estado final SUCCESS o REJECTED no pueden ser cancelados.

Visualizar el flujo final de un pago

Este endpoint se utiliza para visualizar el flujo final de pago con QR en Argentina. Busca el pago mediante su uid y redirige a la página de ProntoPaga. No realiza validaciones adicionales ni modifica el estado de la transacción.


Wallets disponibles

A continuación se presenta el listado de billeteras y entidades que pueden operar mediante QR interoperable en Argentina. Estas aplicaciones permiten a los usuarios escanear el código QR y realizar pagos desde su billetera digital o aplicación bancaria.

IdentificadorBilletera
36535Ágil Pagos
36579AL2
36513Bancón
36512Banco Credicoop
36517Banco Galicia
36556Banco Piano
36523Banco de San Juan
36522Banco de Santa Cruz
36529Banco Supervielle
36509Banco Santander
36532BICA
36561BIND PSP
36567BLP
36507Billetera Macro
36565Billetera Ultra
36540Bizland Payment Solutions
36505BBVA Argentina
36569Click+
36536Claro Pay
36583Columbia Banco Movil
36542Codigo Pago
36576Credencial Payments
36506Cuenta DNI
36582DigiFin (Lemon)
36580Digipayments (Ripio)
36544Easy Pagos
36500ePagos
36557FACAF
36550Finket
36566Fertil Suma
36552Garpa (Dólar App)
36572Go Pay
36531Hooli
36520ICBC
36586Insight Business
36578Koipay
36543Lux11
36538Naranja X
36558NBCH24 Billetera
36514Moni
36508MODO
36549Más BanCo
36568Mi BPN
36502Mercado Pago
36546Prex
36530Personal Pay
36575Pago24
36537Paycloud
36503Plus Pagos
36534Telepagos
36564TDK Labs
36541totalcoin
36562Tarjeta Urbana
36571TACH
36504Ualá
36581Unex
36559Vía Pago
36548Viumi
36587Wayni
36511Resimple
36501Propago
36521Brubank
36573SYS (EVAPAR)
36545PVS
36563Sidom Pay
36516BNA
36525Banco Santa Fe

Límites transaccionales

La siguiente tabla muestra los límites desde ProntoPaga para pagos con QR en Argentina:

Mínimo por transacciónMáximo por transacciónMáximo por día
$5 ARS$999 999 999,99 ARSSin límites

Límites wallet

La siguiente tabla muestra los límites establecidos por las billeteras para transacciones en Argentina.

❗️

Límites por billetera

Ten en cuenta que cada billetera puede definir límites propios, los cuales pueden variar según sus políticas internas, el nivel de verificación del usuario y el historial transaccional del comercio o del pagador.

Billetera

Mínimo por transacción

Máximo por transacción

Máximo por día

Mercado Pago

$ 100,00 ARS

  • Desde Mercado Pago: $ 15.000.000 ARS
  • Desde cuentas vinculadas: hasta $ 10.000.000 ARS que serán descontados de ese límite total.

$ 30.000.000 ARS


Validación de pago a terceros

ProntoPaga cuenta con un servicio de validación de pago de terceros, el cual confirma que el número de teléfono celular ingresado coincide con los datos de la cuenta del cliente, evitando que se realicen pagos de terceros y maximizando la seguridad de tus transacciones.

Esta validación se asigna de forma automática a ciertos comercios integrados con nosotros. Si deseas activarla o desactivarla, comunícate con nuestro equipo de integración.


Prueba tu integración

Contamos con un catálogo de datos de prueba que puedes usar para comprobar que tu integración está lista, así como para ver el flujo de pago que seguirá tu cliente. Además, puedes hacer pruebas con nuestros demos:


Certifica tu integración

La certificación de la integración en sandbox es un paso obligatorio que todos los comercios deben realizar antes de recibir sus credenciales de producción. Su propósito es asegurar que la integración cumpla con los estándares técnicos, funcionales y de seguridad requeridos por ProntoPaga. Dentro de esta sección, se establecen los requisitos que deben cumplirse sin excepción para que la certificación sea aprobada.

Requisitos de certificación

A continuación, encontrarás los distintos requisitos necesarios para completar tu certificación:

  • ❌ El documento de identidad del cliente no debe ser modificable en ningún punto de la transacción.
  • ✅ Es recomendable que este dato no se muestre en el checkout. Solo puede estar disponible en la sección de perfil del usuario autenticado.
  • ⚠️ Esta medida tiene como objetivo prevenir fraudes y evitar que se realicen transacciones en nombre de terceros o menores de edad.