API para cobros por transferencia bancaria en Argentina, cómo funciona y cómo integrarla
· Martín Costamagna
Por Martín Costamagna, cofundador y CTO de ChytaPay.
Respuesta rápida
Una API para cobros por transferencia bancaria permite que tu sistema cree un cobro, le dé al cliente una cuenta a la que transferir y se entere solo cuando el pago llega, sin revisar el homebanking. La API de ChytaPay hace exactamente eso en Argentina: creás el cobro con una llamada REST, el cliente transfiere desde cualquier banco o billetera, ChytaPay identifica el pago por el CVU o por el documento de quien transfiere, y tu sistema recibe un webhook. Datos al 15 de noviembre de 2026.
- Qué resuelve: crear cobros, saber quién pagó y actualizar tu sistema automáticamente.
- Cómo identifica el pago: por el CVU asignado al cobro, o por el CUIL, CUIT o DNI de quien transfiere (modo recomendado para volúmenes altos).
- Cómo te avisa: un webhook en tiempo real, con reintentos y una clave de idempotencia.
- Cómo lo probás: ambiente de test, Postman, OpenAPI y un simulador de pagos, sin dinero real.
- El límite: cobra únicamente por transferencia, sin tarjeta ni cuotas, y no hay plugins para Tiendanube, WooCommerce ni Shopify.
Transparencia: este artículo se publica en el blog de ChytaPay, que es la solución que describe. Los datos técnicos salen de la documentación pública de la API.
Por qué cobrar por transferencia desde una API
En septiembre de 2026 hubo 791,6 millones de transferencias inmediatas en pesos, un 21,9 % más que un año antes en cantidad, y el 75 % tuvo origen o destino en una CVU (BCRA). Incluyen envíos entre personas, no solo pagos a comercios. Aun así, el dato muestra que transferir es un hábito instalado: el cliente ya sabe hacerlo y no necesita tarjeta.
El problema de cobrar por transferencia a mano es saber a qué cobro corresponde cada pago. Una API de cobros por transferencia bancaria automatiza ese paso: genera el cobro, asigna la cuenta de destino, concilia el pago y notifica a tu sistema.
Cómo funciona una API de cobros por transferencia
El flujo básico tiene cuatro pasos:
- Tu servidor crea el cobro con un identificador propio (
referenceId), un monto, una descripción y un vencimiento. - El cliente recibe los datos para transferir, por tu interfaz, por WhatsApp o por email, o los ve dentro de un checkout embebido.
- El cliente transfiere desde su banco o billetera. ChytaPay recibe el dinero en una CVU y lo acredita de inmediato.
- Tu sistema recibe un webhook con el estado del cobro, el monto pagado y los datos de quien pagó, y actualiza el pedido, la cuota o la reserva.
Para entender cómo se identifica cada pago, mirá la guía de cómo conciliar transferencias automáticamente.
Qué conviene evaluar en una API de transferencias
Antes de elegir proveedor, estas son las preguntas que ordenan la comparación:
| Criterio | Qué preguntar |
|---|---|
| Conciliación | ¿Identifica el pago por CVU, por documento del pagador o por ambos? ¿Qué pasa si paga otra persona? |
| Notificaciones | ¿Hay webhook? ¿Con reintentos, idempotencia y validación de origen? |
| Ambiente de prueba | ¿Hay test sin dinero real y un simulador de pagos entrantes? |
| Pagos no imputados | ¿Te avisa cuando entra plata que no pudo asociar a un cobro? |
| Volumen | ¿Hay carga en lote y qué límites diarios aplican? |
| Modelo de integración | ¿Sirve para un solo comercio, para una plataforma con muchos comercios, o para ambos? |
| Costo | ¿La tarifa está publicada? ¿Hay abono, alta o mínimos? ¿Cuándo se cobra la comisión? |
| Medios de pago | ¿Solo transferencia o también tarjetas? |
Hay otros proveedores en el mercado. Si querés compararlos con datos públicos, tenemos alternativas a Talo y una comparativa con TotalCoin.
Qué ofrece la API de ChytaPay
Creación de cobros
Con POST /payment-request creás un cobro con referenceId propio (8 a 100 caracteres, único), monto, descripción, uno o dos vencimientos y datos del cliente. Los vencimientos pueden ser por día o con hora exacta, hasta 35 días hacia adelante. Con dos vencimientos podés sumar un recargo fijo o porcentual. Un cobro admite pagos parciales, y podés adjuntar metadata propia que vuelve tal cual en el webhook (guía de creación de cobros).
curl -X POST {{integration-url}}/payment-request \
-H "Authorization: Bearer {user_id_token}" \
-d '{
"referenceId": "invoice-2026-000123",
"amount": 5000,
"description": "Cuota mensual",
"dueDates": ["2026-12-15"],
"conciliationType": "cuil",
"customer": { "name": "María García", "taxDocument": "27304050604" }
}'
Conciliación por CVU o por documento
El campo conciliationType define cómo se asocian los pagos: cvu (por defecto) o cuil. En modo cuil, el pago se asocia por el CUIL, CUIT o DNI de quien transfiere, y varios cobros pueden compartir la misma cuenta. La documentación recomienda cuil porque escala mejor y usa menos CVUs abiertos, y reserva cvu para cuando pedirle el documento al pagador no sea viable (guía de conciliación).
Webhooks
Cuando cambia el estado de un cobro, ChytaPay hace un POST a tu URL:
- Eventos:
payment_request.payment_receivedypayment_request.expiredvienen activados por defecto.payment.unmatched, que avisa de plata que no se pudo asociar a ningún cobro, hay que habilitarlo en el Portal. - Seguridad: el encabezado
validation-tokenpermite verificar el origen, y los webhooks salen de una IP fija. - Reintentos e idempotencia: hasta 3 intentos por evento. Deduplicá con el encabezado
X-Chytapay-Webhook-Id, y respondé con un 2xx rápido.
Todo el detalle está en la guía de webhooks.
Widget de checkout
Si tenés una tienda o un portal, el widget muestra el checkout por transferencia dentro de tu sitio. Creás el cobro desde tu servidor con type: "checkout" y abrís el widget con el SDK de JavaScript. El comprador se identifica con su CUIL o DNI y recibe la cuenta a la que transferir. La guía está en Widget de pago.
Comisión propia y varios comercios
Si sos una plataforma que cobra en nombre de muchos comercios, tenés dos opciones que se combinan:
- Modelo de plataforma: una integración, varias cuentas de comercio autorizadas por OAuth y un solo webhook. Distinguís cada cobro por su
referenceId. - Comisión automática (split): definís qué porcentaje te quedás de cada pago y una cuenta que lo recibe. Se calcula sobre cada pago acreditado y se transfiere al instante (guía de comisiones).
- Sucursales o clientes con su propio webhook: con tenants, cada unidad recibe solo sus eventos (guía multi-sede).
Notificaciones al pagador
Con sendWhatsappNotification y sendEmailNotification, ChytaPay le manda al cliente el pedido de pago y los recordatorios a las 10 de la mañana, hora de Argentina, a partir de los vencimientos.
Cómo empezar a integrar
- Pedí las credenciales. Recibís un email de bienvenida con la cuenta de administrador de la integración. Podés escribir por WhatsApp al +54 9 351 543 0077.
- Configurá en el Portal tu URL de webhook, tu URL de redirección y los avisos que querés recibir.
- Autorizá una cuenta de comercio por OAuth2. Es un paso único: después, todo el flujo es de servidor a servidor, con renovación del token.
- Probá en test. El Portal genera un usuario de prueba ya vinculado y permite simular un pago entrante, para ver llegar el webhook sin dinero real.
- Pasá a producción cambiando las URLs base y las credenciales.
Los recursos para arrancar rápido están en primeros pasos, la referencia interactiva, la especificación OpenAPI y una colección de Postman con entornos de test y producción. Para trabajar con un asistente de IA, la página de la API explica cómo conectarlo por MCP.
Límites que conviene conocer
- Solo transferencia. No cobra con tarjeta ni en cuotas. Si necesitás tarjeta, se puede combinar con otra solución.
- Límite diario de creación. Son 400 llamadas por día por integración y cuenta de comercio. La carga en lote (
/payment-request/bulk) cuenta como una sola llamada y admite hasta 100 cobros, es decir hasta 40.000 cobros por día. - Monto máximo. Hasta $10.000.000 por cobro.
- Listados. La consulta de cobros no pagina: filtrá por rango de fechas.
- Sin plugins. No hay plugin para Tiendanube, WooCommerce ni Shopify. El widget se integra con un SDK propio.
- Pagos desde otra cuenta. Si el cobro se concilia por documento y la transferencia sale de una cuenta que no es del pagador, no se asocia solo: llega como pago no imputado.
Cuánto cuesta
No hay abono mensual, costo de alta ni mínimos. Se paga por uso. La comisión es de 0,8 % + IVA en el widget de checkout y de 1 % + IVA cuando el cobro incluye recordatorios por WhatsApp, y se descuenta al retirar. Para volúmenes superiores a $50 millones por mes, la tarifa se revisa a la baja. Si el cobro promedio es menor a $20.000, puede aplicar una comisión mayor a la publicada. La tarifa vigente está en chytapay.com.ar.
Casos de uso
- Plataformas y sistemas de gestión: gimnasios, turnos, ticketeras y software para clubes que cobran en nombre de sus clientes, con comisión propia.
- E-commerce propio: cobro por transferencia con confirmación automática del pedido. Un ejemplo es el de Tilde, que conectó el checkout con ayuda de Claude.
- Seña de turnos y reservas: un cobro con vencimiento a la hora exacta, como cuenta el caso de Xentara.
- Cuotas mensuales: carga en lote de cuotas con conciliación por DNI, como en las escuelas de gimnasia artística.
Preguntas frecuentes
¿Qué es una API de cobros por transferencia bancaria? Es una interfaz que permite a tu sistema crear cobros, dar al cliente una cuenta para transferir y enterarse automáticamente cuando el pago llega.
¿Cómo sabe la API qué cliente pagó? Por el CVU asignado al cobro, o por el CUIL, CUIT o DNI de quien transfiere. Para volúmenes altos, la documentación recomienda el documento.
¿Cómo me entero de que un cobro se pagó? Por un webhook en tiempo real. También podés consultar el estado de un cobro por su referenceId.
¿Qué pasa si entra plata que no se puede asociar a un cobro? El dinero se acredita igual. Si habilitás el evento payment.unmatched, tu sistema recibe el aviso con el motivo.
¿Puedo probar sin dinero real? Sí. Hay ambiente de test, un usuario de prueba y un simulador de pagos en el Portal.
¿Funciona para una plataforma con muchos comercios? Sí. Con el modelo de plataforma, un solo webhook y OAuth por comercio, y con la opción de cobrar una comisión sobre cada pago.
¿Cobra con tarjeta? No, cobra únicamente por transferencia.
¿Cuánto cuesta? 0,8 % + IVA en el widget y 1 % + IVA con recordatorios por WhatsApp, sin abono ni costo de alta. Si el cobro promedio es menor a $20.000, puede aplicar una comisión mayor a la publicada.
Fuentes y metodología
Datos técnicos tomados de la documentación pública de la API de ChytaPay al 15 de noviembre de 2026. Autor: Martín Costamagna, cofundador y CTO de ChytaPay, Ingeniero en Sistemas (UTN). Publicado el 15 de noviembre de 2026.
- BCRA, Informe Mensual de Pagos Minoristas, septiembre de 2026.
- ChytaPay: API, primeros pasos, crear cobros, webhooks, widget, comisiones, multi-sede y portal.