---
name: skeen-pagos
description: >
  Gestion de pagos para SKEEN Derma Experts.
  Genera links de pago (Stripe/MercadoPago), consulta estados,
  y gestiona facturacion. Usar cuando el usuario quiera pagar,
  consultar saldo, o ver sus pagos pendientes.
version: 1.0.0
metadata:
  hermes:
    requires:
      bins: [python]
      env: [STRIPE_SECRET_KEY, MP_ACCESS_TOKEN]
    envVars:
      - name: STRIPE_SECRET_KEY
        required: true
      - name: MP_ACCESS_TOKEN
        required: true
      - name: ODOO_URL
        required: true
    platforms: [whatsapp, webchat, cli]
    activation: keyword
    keywords: ["pagar", "saldo", "deuda", "factura", "pago", "stripe", "mercadopago"]
---

# SKEEN — Gestion de Pagos

## Instrucciones de Uso

### PASO 1: Identificar intencion de pago

- "Quiero pagar" → Generar link de pago
- "Cuanto debo?" / "Saldo pendiente" → Consultar deuda
- "Ya pague" → Verificar pago
- "Necesito factura" → Generar factura (CFDI)

### PASO 2: Consultar servicios pendientes

Usa `odoo_api_call` para consultar modelo account.move:
  Dominio: [['partner_id.phone', '=', PACIENTE_PHONE], ['state', '=', 'posted'], ['payment_state', '!=', 'paid']]
  Campos: ['name', 'amount_residual', 'invoice_date_due']

### PASO 3: Generar link de pago

Para pagos en Mexico (MXN) — usa MercadoPago:
  Crear preference con items del servicio
  notification_url: https://skeen.mx/webhooks/mercadopago
  back_urls: { success: 'https://app.skeen.mx/pagos/exitoso' }

Para pagos internacionales — usa Stripe Checkout:
  Crear session con line_items
  mode: 'payment'
  success_url: 'https://app.skeen.mx/pagos/exitoso'
  metadata: { patient_phone: PACIENTE_PHONE }

### PASO 4: Enviar link de pago

Usa `wacrm_send` para enviar mensaje con resumen y link.

Incluir:
- Listado de servicios con precios
- Total a pagar
- Link de pago
- Metodos aceptados (tarjeta, OXXO, SPEI)
- Puntos de monedero que acumulara

### PASO 5: Confirmacion de pago

Cuando el webhook confirme el pago:
1. Registra pago en Odoo via `odoo_api_call`
2. Calcula puntos de monedero (10% del monto)
3. Envia confirmacion + puntos acumulados

## Reglas

- Siempre confirmar el monto antes de generar el link
- Para pagos >$5,000 MXN, ofrecer opcion de meses sin intereses
- Verificar que el telefono coincida con el paciente
- Guardar referencia de pago en memoria