Preguntas frecuentes
Respuestas a las dudas más comunes de integradores: conciliación, cobros, mensajes, acreditación y comisiones.
Las preguntas que más nos hacen los integradores, con la respuesta de cómo funciona hoy. Si lo tuyo no está acá, escribinos a [email protected] o por WhatsApp al +54 9 351 543 0077.
Conciliación
¿Puede pagar otra persona, por ejemplo el padre por el alumno?
Cada cobro lleva un solo documento de pagador. Si sabés que va a transferir otra persona, cargá su documento al crear el cobro, o cambialo antes del pago con PATCH /payment-request/{referenceId}/customer. Si el cobro manda avisos por WhatsApp en modo CUIL, el aviso trae el botón "Pagar con otro DNI": el pagador escribe el DNI de quien va a transferir y queda autorizado. Si esa persona ya había transferido a ese CVU, el pago se imputa en ese momento.
Más detalle en Si paga un tercero y Corregí el pagador de un cobro creado.
Una persona tiene dos cobros abiertos a la vez. ¿Cómo se imputa lo que transfiere?
Cada cobro abierto recibe su propio CVU, aunque sea del mismo pagador. Cada transferencia se imputa al cobro del CVU al que llega. Si transfiere el total de los dos cobros a un solo CVU, todo se imputa a ese cobro y el otro sigue pendiente: no se reparte.
¿Puedo imputar a mano un pago que quedó sin identificar?
Por la Integration API, hoy no. El comercio puede asignar desde su cuenta de Chytapay las transferencias sin imputar que entraron al CVU de un cobro. Para cualquier otro caso, escribinos a [email protected] o por WhatsApp al +54 9 351 543 0077. Cómo llega un pago así a tu backend está en Gestioná un pago sin imputar.
¿Qué pasa si el pagador transfiere de más o de menos?
De menos: el cobro queda en pago parcial y cada transferencia nueva suma hasta cubrir el saldo. De más: el monto entero se imputa al cobro, que queda pagado; el excedente no se devuelve solo ni queda como saldo a favor. Una transferencia a un cobro que ya estaba pagado llega como payment.unmatched con motivo already_paid, como cuenta el payload. Los casos y la ventana de 24 horas están en Pagos tardíos. Hoy no hay devoluciones automáticas; si necesitás devolver un excedente, escribinos a [email protected] o por WhatsApp al +54 9 351 543 0077.
Mis webhooks no llegan y uso Cloudflare. ¿Qué hago?
Permití la IP de salida 18.231.238.36 en tu WAF o en Cloudflare (incluido Bot Fight Mode): un desafío anti-bot no lo resuelve un servidor y cada entrega falla sin que tu aplicación registre nada. Detalle en IP de salida.
Cobros
Aplico un recargo que sube con los días de atraso. ¿Puedo actualizar el monto de un cobro pendiente?
No. El monto solo se edita mientras el cobro está en borrador. Un cobro tiene hasta dos vencimientos: el segundo cobra el monto más un recargo, porcentual o fijo, que se calcula al crearlo. Para recargos de más de dos tramos, cancelá el cobro (si todavía no recibió pagos) y creá otro con el monto nuevo y un referenceId nuevo: el referenceId de un cobro cancelado sigue ocupado. Ver Vencimientos y recargo, Borrador sin monto y Cancelá un cobro.
¿Hay un límite de CVU por comercio?
Sí, hasta 100 CVU por cuenta de comercio, igual para todos, y no se amplía. En modo CUIL los cobros de distintos pagadores comparten CVU, así que tener más de 100 pagadores con un cobro abierto no ocupa 100 CVU. Ver Conciliación y Operación y errores.
Cancelé un cobro porque me pagaron por otro medio, y después igual entró una transferencia. ¿Qué pasa?
La plata se acredita en la cuenta del comercio y no se imputa al cobro cancelado. Si el cobro se canceló dentro de las 24 horas anteriores, te llega payment.unmatched con motivo canceled y los datos del cobro; si pasó más tiempo, llega sin cobro asociado. Hoy no hay devoluciones automáticas; si necesitás devolverla, escribinos a [email protected] o por WhatsApp al +54 9 351 543 0077. Los motivos están en Webhooks.
Mensajes
¿Puedo usar la API sin que Chytapay le escriba al pagador?
Sí. Con sendWhatsappNotification: false no sale ningún aviso, y con sendWhatsappPaymentConfirmation: false no sale la confirmación de pago. Al comercio le llega igual un email por cada pago. Los campos están en Avisos al pagador.
El tope de mensajes diarios, ¿es por integración o por comercio?
Por integración, sumados todos sus comercios: 20 por día en Sandbox y 200 iniciales por día en Producción. Solo consumen tope los cobros que mandan WhatsApp. Se amplía con Pedir más límite en el Portal. Ver Límites y Qué cuenta como mensaje.
La plata y el comercio
¿Cuándo se ve acreditado un pago?
En cuanto Chytapay recibe la transferencia, la imputa al cobro y te manda el webhook.
¿El comercio puede retirar a su banco cuando quiera?
Sí, desde su cuenta de Chytapay, sin mínimo, según las condiciones de su cuenta.
¿Cómo se da de alta un comercio y qué validación de identidad pasa?
Para dar de alta su cuenta, el comercio se registra en Chytapay y pasa la validación de identidad. Una persona física lo hace con su DNI y una verificación biométrica; una empresa completa además un legajo con su documentación. Con la cuenta aprobada, ya puede autorizar tu integración.
¿La factura de ARCA automática funciona con cobros creados por API?
Sí. Si el comercio tiene la facturación automática activada, se emite una factura a Consumidor Final cuando el cobro queda pagado del todo.
Comisiones
¿Puedo cobrar un porcentaje distinto a cada comercio?
Sí. La comisión del integrador se configura por comercio, y la cobrás en una sola cuenta recaudadora. Ver Cobrar comisión.
¿Puedo repartir un cobro entre varias cuentas, por ejemplo el club y el profesor?
No. Hoy el único reparto es tu comisión de integrador hacia tu cuenta recaudadora.