Manual TuCuota de integración a Salesforce





DOCUMENTO DE ESPECIFICACIONES

Integración TuCuota con Salesforce

Mayo, 2022


Manual realizado por Proyecto Tribo


CONTENIDOS DEL DOCUMENTO


INTRODUCCIÓN        3

OBJETOS        3

Configuración:        3

¿Qué monitorear en el TC Panel de Control?        3

¿Qué información encontrás en TC Pagos?        4

¿Qué es TuCuota Error Logs?        5

ESTADOS DE TC PAGOS        5

Estados posibles        5

TC MÉTODO DE PAGO        6

¿Cómo crear un TC Método de Pago?        6

¿Qué se hace si se necesita modificar los datos del número de método de pago?        8

PROCESO DE PAGOS        8

Nueva donación recurrente u oportunidad        8

¿Cómo modificar una donación recurrente u oportunidad?        9

¿Cómo cancelar una oportunidad?        10

¿Qué pasa cuándo un TC pago vuelve con el estado rechazado?        10

¿Cómo funciona el estado “Devuelto”?        10

¿Qué monitorear?        10


INTRODUCCIÓN


Este documento brinda información sobre la integración entre TuCuota y Salesforce. Esta integración se va a generar a partir de un objeto personalizado llamado “TuCuotaPago” que funcionará de puente entre Salesforce y TuCuota. A partir de este objeto, se generan los TC Pagos de cada oportunidad mensual en estado comprometida y estos son enviados directamente a TuCuota para ser procesado. Este a su vez devolverá sincrónicamente a Salesforce la respuesta positiva o negativa de recepción del pago, es decir que devolverá el estado del pago luego de procesado.

La integración prevé adicionalmente la creación de métodos de pago de cada donante de manera de garantizar la seguridad de la transacción. Estos métodos de pago permiten almacenar de manera segura la información de los números de medio de pago (tarjeta de crédito, débito o CBU).

OBJETOS


Configuración: 

  1. TC Panel de Control: Será la ficha que permite saber el estado de la integración de TuCuota en Salesforce (Estado autenticado – No autenticado).
  2. TC Pagos: Será el objeto central que se integra en ambos sistemas. Este objeto permite llevar un control de las oportunidades a procesar y el estado de las mismas luego de procesadas.
  3. TC Error Logs: Será el objeto donde se podrán monitorear los errores de la integración. Por ejemplo, errores de validación.
  4. TC Métodos de Pago: Será el objeto donde se almacenarán los métodos de pago de cada donante. 

¿Qué monitorear en el TC Panel de Control?

En este objeto se monitorea el estado de la integración de TuCuota en Salesforce (Estado autenticado – No autenticado).

¿Qué información encontrás en TC Pagos?

  • Nombre del TC Pagos: por ejemplo TCP-2222.
  • Monto a cobrar al medio de pago (tarjeta de crédito, de débito o CBU).
  • Nombre de la oportunidad. Este campo no es obligatorio que esté en TC Pagos.
  • Cliente: es decir el contacto. Es importante que sea un contacto ya cargado en Salesforce.
  • TC Métodos de Pago: Método de pago del donante tokenizado por TuCuota. Ver cómo crear un TC Método de Pago.
  • Estado: ver Estados posibles.
  • Fecha estimada de acreditación: La fecha estimada de acreditación se calcula sumando días hábiles desde el día en que se aprueba el pago según los distintos plazos de liquidación.
  • Fecha de cobro: la fecha en que TuCuota va a intentar cobrar la donación.
  • Fecha de cobro efectiva: la fecha real de cobro.
  • Reintentar hasta: fecha hasta la que se reintenta en la tarjeta.
  • Pagado: se marca con un tilde cuando el TC Pagos esté cobrado.

Se pueden ver también datos de la respuesta del proceso de cobro, especialmente el mensaje de error.

¿Qué es TuCuota Error Logs?

TuCuota Error Logs es el objeto desde donde se podrán monitorear los errores de la integración. Por ejemplo, errores de validación. En este objeto se verán las novedades, es decir, todas las veces que Salesforce y TuCuota intercambiaron información, qué información se envió y qué información volvió.

ESTADOS DE TC PAGOS


Estados posibles

  • Pendiente de envío: El pago se crea en este estado. La TC Pagos todavía no pasó a TuCuota para ser procesado. En esta etapa aún puede cancelarse la Oportunidad o realizar cambios en el monto, el método de pago y la fecha de cobro, sin embargo hay que tener en cuenta que en este estado sólo está unos minutos y luego pasa a “Enviado sin procesar”.
  • Enviado sin procesar: Estado automático. La oportunidad fue enviada a TuCuota, pero TuCuota todavía no la procesó. En este estado aún pueden modificarse el monto, el método de pago y la fecha de cobro.  Además en este estado puede pasar a “Enviado a Cancelar” para que TuCuota no lo cobre. Queda pocos segundos en “Enviado a Cancelar” y pasa a “Cancelado”.
  • Enviado en proceso: Estado automático. TuCuota envío el pago al medio de pago para su cobro. A partir de este momento no se puede cancelar, ni cambiar el monto, el método de pago y la fecha de cobro.
  • Aprobado: Estado automático. El pago fue cobrado con éxito.
  • Rechazado:  Estado automático. Rechazado en Tu Cuota luego de procesar. El pago no pudo ser cobrado.
  • Devuelto: Estado automático. Alguien pidió la devolución de un pago. Ver ¿Cómo funciona el estado “Devuelto”?
  • Con Error: Estado automático. Volvió con error en la comunicación con TuCuota. El pago nunca llegó a tu cuota, por lo que no pudo ser cobrado, ni enviado a procesar. Por ejemplo , porque hubo un error en la integración.
  • Enviado a cancelar: Cuando se elimina una oportunidad o se pierde una oportunidad, y el TC Pago relacionado estaba en Pendiente de envío o Enviado sin procesar, el TC Pagos pasa al estado Enviado a cancelar y se envía a TuCuota a cancelar.
  • Cancelado: Estado automático. Si el TC Pagos enviado a cancelar se cancela con éxito, el estado pasa a “Cancelado”.
  • Reintentando: TuCuota está reintentando el cobro.

Correspondencia de estados

Saleforce TuCuota
Pendiente de envío Estado temporal hasta que llegue a TuCuota
Enviado sin procesar Pendiente de envío (pending_submission)
Enviado en proceso Enviado (submitted)
Aprobado Aprobado (approved)
Rechazado Rechazado (rejected)
Devuelto Devuelto (chargeback)
Con error No existe en TuCuota
Enviado a cancelar Estado temporal hasta que se cancela
Cancelado Cancelado (cancelled)
Reintentando En proceso de reintento en TuCuota

MAPA DE ESTADOS


TC MÉTODO DE PAGO


¿Cómo crear un TC Método de Pago?

Los métodos de pago se crean SIEMPRE desde el contacto.

Link al video tutorial.

En el caso de que se cree una oportunidad de única vez, el TC Método de Pago debe seleccionarse en la oportunidad y luego pasará la información automáticamente al TC Pago relacionado.

IMPORTANTE:

Recordar siempre seleccionar “Procesado con: TuCuota” para activar la creación de los TC Pagos. 

Pasos a seguir para crear un TC Método de Pago:

  1. Se debe ingresar el número de método de pago (tarjeta o CBU). El mes y el año de vencimiento será requerido sólo en países que lo exijan para  el caso de las tarjetas.
  2. Luego, hacer click en “Enviar”.
  3. En relacionado del contacto se pueden visualizar los métodos de pago del contacto. Cada contacto puede tener más de un método de pago.

  1. Una vez creado el método de pago, se debe crear la donación recurrente u oportunidad de única vez y seleccionar como procesador de pago “TuCuota” y el TC Método de pago elegido de ese contacto.

¿Qué se hace si se necesita modificar los datos del número de método de pago?

En el caso que se necesita modificar los números de tarjeta de crédito o CBU, se debe crear un NUEVO TC Métodos de Pago:

  1. Se debe crear desde el contacto un NUEVO TC Métodos de Pago.
  2. Una vez creado el nuevo TC Métodos de Pago, debe actualizarse en la donación recurrente o en la oportunidad de única vez el campo TC Métodos de Pago con el nuevo TC Métodos de Pago creado.

PROCESO DE PAGOS


Nueva donación recurrente u oportunidad

  1. Los TC Pagos pueden crearse tanto para oportunidades creadas a partir de donaciones recurrentes como para oportunidades de única vez.
  2. Cuando una Oportunidad está en estado “Comprometida” (1) y el procesador de pago es “TuCuota” se genera un TC Pagos en estado “Pendiente de Envío”. La información de los TC Pagos puede visualizarse en relacionado de la Oportunidad (2).
  3. Cuando se crea un TC Pagos, se marca en la oportunidad el campo TC Pagos creado. De esta forma se asegura que no se creen por error dos pagos en la misma oportunidad.

  1. El estado “Pendiente de Envío” dura solo unos minutos, luego de lo cual pasa a “Enviado sin procesar”. La integración entre las dos plataformas busca cada 5 minutos aproximadamente nuevas oportunidades.

IMPORTANTE:

En esta etapa SI pueden realizarse cambios en el monto o en el TC Métodos de Pago o  enviarse para cancelar.

  1. Una vez que se llega a la fecha de cobro, el pago se procesa, pasando a la etapa “Enviado en proceso”.

IMPORTANTE:

En esta etapa NO pueden realizarse cambios en el monto o en el TC Métodos de Pago, NI enviarse para cancelar.  

  1. Una vez procesado el pago el estado se actualizará según se haya procesado correctamente o no.
  1. Si se cobra (Oportunidad Cerrada Ganada) pasa a Aprobado.
  2. Si no se puede cobrar (Oportunidad Cerrada Perdida) pasa a:
  1. Rechazado: Rejected en Tu Cuota.
  2. Devuelto: Se devuelve el pago a pedido del donante.

¿Cómo modificar una donación recurrente u oportunidad?

Se puede modificar el monto o el TC Métodos de Pago cuando está en estado “Pendiente de Envío” o “Enviado sin procesar”.

Si el cambio es de monto o TC Métodos de Pago este cambio debe realizarse en la donación recurrentes y luego se actualiza automáticamente la oportunidad y el TC Pago.

Si lo que se quiere cambiar es la fecha de cobro ese cambio debe realizarse en la oportunidad.

IMPORTANTE:

Una donación recurrente u oportunidad SI puede modificarse en estado “Pendiente de Envío” o “Enviado sin procesar”. NO pueden modificarse cuando están en estado “Enviado en proceso”.

¿Cómo cancelar una oportunidad?

Si una oportunidad se elimina o se pasa a “Cerrada Perdida” antes de que pase al estado “Enviado en proceso”, el pago se puede cancelar.

El sistema de forma automática pasará el pago a “Enviado a cancelar”, TuCuota cancela el pago y actualiza el estado  a “Cancelado”.

IMPORTANTE:

Una oportunidad SI puede cancelarse en estado “Pendiente de Envío” o “Enviado sin procesar”. NO puede cancelarse cuando está en estado “Enviado en proceso”.

¿Qué pasa cuándo un TC pago vuelve con el estado rechazado?

En este caso TuCuota SI procesó el pago pero NO pudo ser cobrado.

Si el TC Pagos es de este mes y quieren volver a enviarla a TuCuota porque cambiaron algún valor, se debe hacer click en el botón “Reenviar pago” dentro de la Oportunidad..  Esta acción crea un nuevo TC Pagos.

Solo puede enviar a “Reenviar pago” una oportunidad de este mes o siguientes, no pueden enviarse una oportunidad del mes pasado.

No pueden enviar a “Reenviar pago” oportunidades en estado Cerradas Ganadas.

¿Cómo funciona el estado “Devuelto”?

El estado “Devuelto” está como posibilidad sólo para los débitos con CBU. Es decir, cuando un donante pide un contracargo, el banco ejecuta un reembolso e informa eso a la organización, y TuCuota procesamos ese aviso. Este contracargo NO es posible para tarjetas de débito o crédito.

¿Qué monitorear?

Hemos agregado un panel “TuCuota – Procesados este mes” para poder monitorear:

  • la cantidad de TC Pagos creados en el mes.
  • el monto de la suma de los TC Pagos del mes.
  • los TC Pagos agrupados por estado, tanto cantidad como monto.
  • un cuadro que muestra aquellos TC Pagos que han dado Error o han quedado en Pendiente de Envío.
  • un componente que muestre la cantidad de donaciones sin oportunidades y la cantidad de oportunidades sin TC Pagos. En ambos casos deben dar 0 para asegurarse de que todas las donaciones se cobren ese mes.

última actualización / 3 de mayo de 2022  / Valle Garimberti