Pagos con PayPal y transferencia bancaria
Agentes SaaS permite al agente generar órdenes de pago durante la llamada usando la herramienta crear_orden_y_link_pago. Soporta dos métodos: PayPal (link directo al pago) y transferencia bancaria (con upload de comprobante).
Método A — PayPal Orders v2
Configurar PayPal en el dashboard
1. Ve a developer.paypal.com → My Apps & Credentials.
2. Crea una app de tipo Merchant.
3. Copia el Client ID y el Client Secret del entorno de producción (o sandbox para pruebas).
4. En /dashboard/settings → pestaña Billing → sección PayPal, ingresa:
- Client ID
- Client Secret
- Moneda (p. ej.
USD,PEN,MXN,COP)
5. Guarda. El sistema creará un token de acceso automáticamente.
# Variables para self-hosted
PAYPAL_CLIENT_ID=AXxxxxxxxxxxxxxxxxxxxxxxxxxxxx
PAYPAL_CLIENT_SECRET=EGxxxxxxxxxxxxxxxxxxxxxxxxxxxx
PAYPAL_MODE=live # o "sandbox" para pruebas
PAYPAL_CURRENCY=USD
Flujo del pago PayPal
1. El agente invoca crear_orden_y_link_pago con el monto y descripción.
2. El sistema llama a la API PayPal Orders v2 y genera un order_id y un approve_link.
3. El agente envía el enlace al cliente por el canal preferido (WhatsApp, email, SMS, Telegram).
4. El cliente abre el enlace, paga en PayPal.
5. PayPal notifica el webhook de Agentes SaaS.
6. El dashboard actualiza el estado de la orden a COMPLETED.
Estados de la orden PayPal
| Estado | Descripción |
|---|---|
| CREATED | Orden generada, cliente aún no ha pagado |
| APPROVED | Cliente aprobó el pago, pendiente de captura |
| COMPLETED | Pago capturado exitosamente |
| VOIDED | Orden cancelada |
Método B — Transferencia bancaria
Configurar datos bancarios
1. En /dashboard/settings → Billing → Transferencia bancaria, ingresa:
- Banco
- Tipo de cuenta (corriente / ahorros)
- Número de cuenta
- Titular de la cuenta
- RUC / Cédula del titular
- Instrucciones adicionales (referencia que el cliente debe usar)
2. Guarda.
Flujo de transferencia
1. El agente informa los datos bancarios al cliente verbalmente y por mensaje.
2. El cliente realiza la transferencia y sube el comprobante en su portal de cliente (/c/[token]).
3. El comprobante llega al dashboard en /dashboard/payments para revisión manual.
4. El operador confirma o rechaza el pago (ver Confirmar pago manual).
Ver historial de pagos
En /dashboard/payments puedes filtrar por:
- Método (PayPal / Transferencia)
- Estado
- Rango de fechas
- Cliente o cita asociada
Cada registro muestra el monto, la moneda, la cita relacionada y el historial de cambios de estado.