Cuando creas una deuda o una suscripción, puedes acotar con qué medios puede pagar el deudor. Por defecto, TapiPay resuelve internamente los medios disponibles para tu organización (efectivo y digitales) y tú decides si quieres restringirlos.
Medios disponibles
El campo paymentMethods acepta uno o más de estos valores:
Si no envías paymentMethods, la deuda queda habilitada 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.
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 a nivel del recurso acota lo permitido por la organización. No puedes habilitar a nivel de deuda 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.
