Si tiene pagos que se deben ejecutar de forma periódica, y es una opción cobrarlos mediante tarjeta de crédito/débito o mediante un débito en cuenta bancaria, ePagos le brinda la posibilidad de que ofrezca a sus contribuyentes adherir una cuenta o guardar la tarjeta para realizar el cobro de forma automática.
Para habilitar esta funcionalidad, al momento de redireccionar el usuario a la página de pago, deberá incluir en la solicitud el atributo identificador_cliente que es un texto alfanumérico que deberá ser único por cada contribuyente, de al menos 6 caracteres.
Ese valor será responsabilidad del Organismo en su generación y gestión, para ePagos dos solicitudes con el mismo identificador_cliente corresponderán al mismo usuario. Si para un identificador_cliente existen medios de pago guardados ese usuario los verá en las sucesivas solicitudes.
Es importante que además del identificador_cliente, se incluya en la solicitud, el email_pagador, de forma de que ese
identificador_cliente quede vinculado a una cuenta de la billetera de ePagos.
También se recomienda que informe el parámetro tipo_operacion con el identificador del impuesto a asociar por parte del usuario,
aunque si no lo informa el usuario podrá elegir entre los impuestos disponibles para su organismo.
Como última consideración se recomienda que restrinja las formas de pago permitidas para que el usuario solo pueda usar Débito directo o Tarjetas de crédito o débito, según el caso. Usando el parámetro fp_permitidas con el valor 42 o el parámetro tp_excluidos con el valor "1,3,4,5,6,7".
Al momento de realizar el pago, el usuario podrá seleccionar si desea guardar esa tarjeta para futuros pagos,
de esta manera apareciendo como un medio de pago destacado en las siguientes solicitudes.
Los usuarios también podrán eliminar esas tarjetas vinculadas para evitar futuros usos.
Para pagos con cuenta bancaria, lo primero que deberá suceder es la adhesión de la cuenta por parte del contribuyente. Este proceso se realizará usando el botón de pago con las consideraciones arriba mencionadas.
Para registrar una cuenta se le pedirá al usuario ingresar:
Para permitirle al usuario la incorporación de un nuevo medio de pago almacenado, pero sin relacionarlo a una operación de pago, existe la posibilidad de iniciar una solicitud con un conjunto de credenciales diferentes, que les serán proporcionadas y que apuntan al id_organismo = 70 (ePagos Billetera).
De esta forma le permite al usuario registrar una nueva tarjeta de crédito, para el cobro por recurrencia en el sistema.
Para validar que la tarjeta posea fondos, se deberá generarle un cargo simbólico que luego podrá ser tomado como pago a cuenta de sus obligaciones.
Para iniciar la solicitud deberá:
Para realizar los cargos sobre el medio de pago guardada, por favor, revisar los métodos de la API solicitud_pago_recurrente y solicitud_pago_recurrente_suscripcion.
Si necesita listar las tarjetas guardadas para un usuario, determinado, puede utilizar el método obtener_tarjetas_cliente.
Usando el identificador_cliente informado al momento de realizar la adhesión, podrá buscar las cuentas guardadas de un usuario.
El atributo fecha_debito, en el método solicitud_pago_recurrente permite que se pueda indicar que día realizar el descuento bancario de Débito Directo a la cuenta y cliente guardados previamente.
Cada intento de cobro (la adhesión y sus posteriores llamados a los métodos de API para aplicar cargos) generarán una operación en nuestra plataforma.
Hay que prestar atención a la respuesta de los intentos de cobro, primero para saber si el pago fue exitoso, rechazado o aún no tiene una respuesta disponible.
En el caso de ser rechazado existen algunos casos que indican que el medio de pago ya no es válido,
por lo que no tiene sentido seguir intentando aplicar cobros sobre el mismo.
En el campo respuesta_entidad_cobro del método que se utilice para realizar el cobro, recibirá la respuesta por parte del medio de pago, si la respuesta recibida se encuentra en la lista de a continuación, el medio de pago ya no es válido.
| Respuesta | Medio pago | Explicación |
|---|---|---|
| cc_rejected_blacklist | Tarjeta de crédito/débito | La tarjeta se encuentra en una lista negra de la marca por haber sido denunciada como robaba, perdida, etc. |
| cc_rejected_card_disabled | Tarjeta de crédito/débito | La tarjeta no fue activada por parte del usuario. Debe comunicarse al número que figura en el reverso de la tarjeta |
| cc_rejected_bad_filled_date | Tarjeta de crédito/débito | Hay un problema con la fecha de vencimiento de la tarjeta, posiblemente ya no es válida. |
| cc_rejected_bad_filled_other | Tarjeta de crédito/débito | En los datos guardados de la tarjeta hay datos ingresados incorrectamente, deberá volver a cargarla. |