Skip to main content
Cuando creas una suscripción, puedes acotar con qué medios puede pagar el deudor las deudas que genera. Por defecto, TapiPay resuelve internamente los medios disponibles para tu organización (efectivo y digitales) y tú decides si quieres restringirlos.
paymentMethods y autopay aplican a las suscripciones (y a sus deudas). POST /v2/debts no los acepta: enviarlos devuelve 400 INVALID_REQUEST. En esas deudas el cobro automático lo gobierna el medio de pago default del usuario, ver Débito automático.

​
Medios disponibles

El campo paymentMethods acepta uno o más de estos valores:
Si no envías paymentMethods, las deudas quedan habilitadas con los medios configurados a nivel de tu organización. No necesitas enviar este campo para cobrar.

​
Domiciliación (autopay)

autopay (default false) indica que el cobro se realiza por domiciliación, sin que el deudor elija un medio en cada cobro. Para el flujo completo de domiciliación gobernada por el medio de pago default del usuario (productos, enrolamiento y POST /v2/debts), consulta Débito automático. Para ver qué medios registró un usuario, usa GET /payment-methods: ver Medios de pago del usuario.
autopay y paymentMethods son mutuamente excluyentes. Si envías autopay: true, no puedes enviar paymentMethods en la misma petición. Hacerlo devuelve 400 INVALID_REQUEST.
Error: autopay + paymentMethods juntos

​
Jerarquía de medios

Los medios habilitados se resuelven en cascada, de lo general a lo específico:
Lo que definas en la suscripción acota lo permitido por la organización. No puedes habilitar un medio que tu organización no tenga activo.

​
Pago de varias deudas a la vez

Cuando un deudor paga múltiples deudas en una sola operación, el sistema calcula la intersección de los medios habilitados en cada deuda y solo ofrece los medios comunes a todas.
Si la intersección queda vacía, no hay un medio común para cobrar todas las deudas juntas y la operación se rechaza con 422 BUSINESS_RULE_VIOLATION. En ese caso, el deudor debe pagarlas por separado.
Si vas a permitir que tus deudores agrupen pagos, mantén un conjunto de paymentMethods consistente entre las deudas del mismo deudor para evitar intersecciones vacías.