🔗 Integración de Salesforce con Debi: Objetos creados y funcionamiento
🧭 Introducción
Cuando una organización instala el paquete de Debi en su instancia de Salesforce, se habilita una integración que permite procesar pagos directamente desde oportunidades comprometidas. Esta integración gira en torno a un objeto principal llamado Debi Pagos, que actúa como puente entre Salesforce y Debi, facilitando la sincronización, seguimiento y validación de transacciones.
En este documento te explicamos:
- Qué objetos se crean en Salesforce al instalar el paquete de Debi
- Cómo funciona el flujo de integración
- Qué información contiene cada objeto
- Qué estados puede tomar un Debi Pago y cómo se reflejan entre ambos sistemas
🧩 Objetos creados al instalar el paquete de Debi
A continuación, se listan los objetos personalizados que se incorporan a tu organización Salesforce con la instalación del paquete de Debi:
| Objeto | Descripción |
|---|---|
| Debi Panel de Control | Monitorea el estado de autenticación de la integración (Autenticado / No autenticado). |
| Debi Pagos | Objeto central que sincroniza oportunidades con Debi y gestiona su procesamiento. |
| Debi Métodos de Pago | Almacena de forma segura los métodos de pago (tarjeta, débito, CBU) de los donantes. |
| Debi Error Logs | Registra errores surgidos durante la integración, por ejemplo, de validación. |
| Debi Formularios | Captura los datos ingresados por donantes a través de formularios web. |
⚙️ Funcionamiento general de la integración
- Cuando se crea una Oportunidad comprometida que provenga de Donaciones Recurrentes o de Única vez en Salesforce, con procesador de pagos TuCuota y un Debi Método de Pago asociado, se genera un Debi Pago.
- Este Debi Pago es enviado automáticamente a la plataforma Debi.
- Debi responde en tiempo real con el resultado del procesamiento (aprobado, rechazado, error, etc.).
- La información del estado del pago se actualiza en Salesforce dentro del objeto Debi Pagos, y modifica la Oportunidad cerrando su etapa.
💡 Solo se procesan oportunidades con método de pago vinculado y procesador TuCuota.
🧾 Detalle de los objetos principales
📌 Debi Panel de Control
Permite monitorear el estado de autenticación de la integración:
- Autenticado: integración activa
- No autenticado: conexión fallida o no configurada
📌 Debi Pagos
Contiene toda la información del pago sincronizado:
| Campo | Descripción |
|---|---|
| Nombre del Debi Pago | Identificador único, por ejemplo: TCP-2222 |
| Monto a cobrar | Importe del cobro |
| Nombre de la Oportunidad | Oportunidad asociada al Debi Pago |
| Cliente | Contacto vinculado a la oportunidad |
| Método de pago | Token asociado desde Debi |
| Estado | Estado actual del pago (ver sección “Estados”) |
| Fecha estimada de acreditación | Calculada según plazo de liquidación del medio de pago |
| Fecha de cobro | Fecha tentativa para ejecutar el débito |
| Fecha de cobro efectiva | Fecha en que realmente se ejecutó el débito |
| Reintentar hasta | Fecha límite de reintento si el cobro falla |
| Pagado | Indicador de pago exitoso |
| Medio de pago / proveedor | Gateway utilizado |
| Cantidad de reintentos | Número de intentos realizados para cobrar |
| Mensaje de error | Texto devuelto en caso de fallas durante el proceso de cobro |
📌 Debi Métodos de Pago
Este objeto almacena los medios de pago registrados por cada donante de forma segura:
- Tarjetas de crédito
- Tarjetas de débito
- CBU / cuentas bancarias
🔐 Los datos están tokenizados y cumplen con estándares de seguridad.
📌 Debi Error Logs
Contiene información detallada sobre errores producidos en la integración, como:
- Validaciones fallidas
- Problemas de conexión
- Campos obligatorios incompletos
Este registro es útil para monitoreo y debugging por parte del equipo técnico.
📌 Debi Formularios
Guarda la información recopilada a través de formularios web completados por los donantes.
(Se puede vincular con automatizaciones – ver artículo)
🔄 Estados de los Debi Pagos
Los Debi Pagos pueden tener distintos estados, tanto en Salesforce como en Debi. Aquí los explicamos y cómo se corresponden:
📍 Estados posibles en Salesforce
| Estado Salesforce | Descripción |
|---|---|
| Pendiente de envío | Pago creado pero aún no procesado. Se puede editar monto, fecha y método. |
| Enviado sin procesar | Enviado a Debi, pero aún no cobrado. Se puede cancelar o modificar. |
| Enviado en proceso | Ya fue enviado a cobrar. No se puede modificar ni cancelar. |
| Aprobado | Pago exitoso. |
| Rechazado | Pago rechazado. |
| Devuelto | Solicitud de devolución realizada. |
| Con Error | Error en la comunicación, no llegó a Debi. |
| Enviado a cancelar | En proceso de cancelación. |
| Cancelado | Cancelación exitosa. |
| Reintentando | Intento activo de cobro por parte de Debi. |
🔁 Correspondencia con Debi
| Salesforce | Debi |
|---|---|
| Pendiente de envío | Estado temporal |
| Enviado sin procesar | pending_submission |
| Enviado en proceso | Submitted |
| Aprobado | approved |
| Rechazado | rejected |
| Devuelto | chargeback o refunded |
| Con error | No existe |
| Enviado a cancelar | Estado temporal |
| Cancelado | Cancelled |
| Reintentando | Reintentando en Debi |