# 💳 **SISTEMA DE PAGOS ONLINE - PASO #3**

> **🎯 DESARROLLO FUTURO**: Sistema de pagos integrado para completar el ecosistema SGB

---

## 📋 **ROADMAP COMPLETO SGB**

```
✅ PASO #1: INVENTARIO PÚBLICO (7-10 días)
├── Consentimiento del negocio
├── Token único por negocio
├── QR público para clientes
└── Vista en tiempo real (producto, marca, stock, precio)

✅ PASO #2: PREPARADOR DE PEDIDOS V1.0 (7-9 días)
├── Carrito de compras
├── Datos temporales del cliente (sin registro)
├── Notificaciones internas al negocio
├── Seguimiento por código único
└── Pagos presenciales (efectivo, tarjeta, transferencia)

🚀 PASO #3: SISTEMA DE PAGOS ONLINE V2.0 (10-15 días)
├── Modelo Marketplace Mercado Pago
├── Pagos online integrados
├── Comisión automática para SGB
└── Experiencia de pago unificada
```

---

## 🎯 **CONCEPTO: MARKETPLACE MERCADO PAGO**

### **🔄 Flujo de Pago Integrado CON TRANSPARENCIA:**

```
1. CLIENTE selecciona productos → Carrito (Subtotal: $10.000)
2. CLIENTE completa datos → Nombre, teléfono, horario retiro
3. SISTEMA muestra RESUMEN TRANSPARENTE:
   ┌─────────────────────────────────────────┐
   │ 💳 PAGO ONLINE: $10.440                 │
   │ • Productos: $10.000                    │
   │ • Comisión MP: $290                     │
   │ • Comisión SGB: $150                    │
   │                                         │
   │ 💵 PAGO AL RETIRAR: $10.000             │
   │ • Solo productos, sin comisiones        │
   └─────────────────────────────────────────┘
4. CLIENTE elige método de pago informado
5. Si ONLINE → Mercado Pago → Notificación al negocio
6. Si PRESENCIAL → Confirmación → Pago al retirar
7. NEGOCIO prepara pedido → Cliente retira
```

### **💰 Modelo Financiero TRANSPARENTE:**

#### **🔄 Opción 1: PAGO ONLINE (Con comisión SGB)**
```
Venta: $10.000
├── 🏦 Comisión Mercado Pago: 2.9% = $290
├── 🚀 Comisión SGB: 1.5% = $150
├── 📊 Total comisiones: $440 (4.4%)
└── 💰 Negocio recibe: $9.560 (95.6%)
```

#### **🔄 Opción 2: PAGO PRESENCIAL (Sin comisión SGB)**
```
Venta: $10.000
├── 🏦 Comisión Mercado Pago: 0% = $0 (no hay MP)
├── 🚀 Comisión SGB: 0% = $0 (solo por servicio)
├── 📊 Total comisiones: $0 (0%)
└── 💰 Negocio recibe: $10.000 (100%)
```

#### **📋 TRANSPARENCIA TOTAL EN EL PEDIDO:**
```
┌─────────────────────────────────────────┐
│  RESUMEN DE TU PEDIDO                   │
├─────────────────────────────────────────┤
│  Subtotal productos: $10.000            │
│                                         │
│  💳 PAGO ONLINE:                        │
│  • Comisión Mercado Pago: $290          │
│  • Comisión SGB: $150                   │
│  • TOTAL A PAGAR: $10.440               │
│                                         │
│  💵 PAGO AL RETIRAR:                    │
│  • Sin comisiones adicionales           │
│  • TOTAL A PAGAR: $10.000               │
│                                         │
│  [ELEGIR MÉTODO DE PAGO]                │
└─────────────────────────────────────────┘
```

---

## 🏗️ **ARQUITECTURA TÉCNICA**

### **🔐 Configuración Marketplace:**

#### **SGB como Marketplace:**
- **Application ID**: Único para SGB
- **Access Token**: Maestro de SGB
- **Webhook URL**: Para notificaciones de pago
- **Seller ID**: Cada negocio tiene su ID único

#### **Flujo de Configuración:**
```
1. SGB se registra como Marketplace en Mercado Pago
2. Cada negocio se vincula como "Seller" de SGB
3. SGB maneja todos los pagos centralizadamente
4. Redistribución automática a negocios
```

### **🗄️ Nuevas Tablas de Base de Datos:**

#### **Tabla: `pagos_online`**
```sql
CREATE TABLE pagos_online (
    id INT PRIMARY KEY AUTO_INCREMENT,
    pedido_id INT NOT NULL,
    negocio_id INT NOT NULL,
    mp_payment_id VARCHAR(50) UNIQUE,
    mp_preference_id VARCHAR(50),
    monto_total DECIMAL(10,2) NOT NULL,
    comision_mp DECIMAL(10,2) NOT NULL,
    comision_sgb DECIMAL(10,2) NOT NULL,
    monto_negocio DECIMAL(10,2) NOT NULL,
    estado ENUM('pendiente', 'aprobado', 'rechazado', 'cancelado') DEFAULT 'pendiente',
    fecha_pago TIMESTAMP NULL,
    fecha_creacion TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (pedido_id) REFERENCES pedidos(id),
    FOREIGN KEY (negocio_id) REFERENCES negocios(id)
);
```

#### **Tabla: `marketplace_config`**
```sql
CREATE TABLE marketplace_config (
    id INT PRIMARY KEY AUTO_INCREMENT,
    negocio_id INT NOT NULL,
    mp_seller_id VARCHAR(50) UNIQUE,
    activo BOOLEAN DEFAULT FALSE,
    fecha_vinculacion TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (negocio_id) REFERENCES negocios(id)
);
```

---

## 📁 **ESTRUCTURA DE ARCHIVOS**

```
negocio/inventario/
├── publico/
│   ├── index.php              # Router principal
│   ├── ver.php                 # Vista inventario
│   ├── carrito.php             # Carrito de compras
│   ├── pedido.php              # Formulario pedido
│   ├── pago.php                # NUEVO: Selección método pago
│   ├── pago_online.php         # NUEVO: Integración Mercado Pago
│   ├── confirmacion.php        # Confirmación pedido
│   └── seguimiento.php         # Tracking pedido
├── dashboard/
│   ├── pedidos.php             # Lista pedidos
│   ├── pagos.php               # NUEVO: Gestión pagos online
│   └── marketplace.php         # NUEVO: Configuración MP
└── api/
    ├── webhook_mp.php          # NUEVO: Webhook Mercado Pago
    ├── crear_preferencia.php   # NUEVO: Crear preferencia MP
    └── procesar_pago.php       # NUEVO: Procesar pago
```

---

## 🔄 **FLUJO TÉCNICO DETALLADO**

### **1. Cliente Selecciona "Pagar Online":**
```php
// En pedido.php
if ($_POST['metodo_pago'] == 'online') {
    // Crear preferencia en Mercado Pago
    $preferencia = crearPreferenciaMercadoPago($pedido_data);
    
    // Redirigir a checkout de MP
    header('Location: ' . $preferencia['init_point']);
}
```

### **2. Webhook de Confirmación:**
```php
// En webhook_mp.php
if ($payment_status == 'approved') {
    // Actualizar estado del pedido
    actualizarEstadoPedido($payment_id, 'pagado');
    
    // Notificar al negocio
    notificarNegocioPagado($negocio_id, $pedido_id);
    
    // Calcular y registrar comisiones
    registrarComisiones($payment_data);
}
```

### **3. Dashboard del Negocio:**
```php
// Mostrar pedidos pagados online
$pedidos_pagados = obtenerPedidosPagados($negocio_id);
foreach ($pedidos_pagados as $pedido) {
    echo "<div class='pedido-pagado'>";
    echo "Pedido #{$pedido['codigo']} - PAGADO ONLINE";
    echo "Monto: ${$pedido['monto_negocio']}";
    echo "</div>";
}
```

---

## 💡 **VENTAJAS DEL MODELO MARKETPLACE**

### **✅ Para SGB:**
- **Ingresos recurrentes**: Comisión por cada transacción
- **Control total**: Manejo centralizado de pagos
- **Escalabilidad**: Agregar negocios sin configuración
- **Analytics**: Datos completos de transacciones

### **✅ Para Negocios:**
- **Cero configuración**: SGB maneja todo
- **Pagos garantizados**: Mercado Pago + SGB
- **Menos riesgo**: No manejan pagos directamente
- **Reportes automáticos**: Via dashboard SGB

### **✅ Para Clientes:**
- **Experiencia unificada**: Mismo proceso en todos los negocios
- **Confianza**: Mercado Pago + marca SGB
- **Múltiples métodos**: Tarjetas, transferencias, etc.
- **Seguridad**: Estándares de MP

---

## 📊 **MÉTRICAS Y ANALYTICS**

### **Dashboard SGB Admin:**
- Total transacciones por mes
- Comisiones generadas
- Negocios más activos
- Métodos de pago preferidos
- Tickets promedio

### **Dashboard Negocio - TRANSPARENCIA TOTAL:**
```
┌─────────────────────────────────────────────────────────┐
│  📊 RESUMEN DE VENTAS - MARZO 2024                     │
├─────────────────────────────────────────────────────────┤
│  💳 VENTAS ONLINE:                                      │
│  • Total vendido: $50.000                              │
│  • Comisión Mercado Pago: $1.450 (2.9%)               │
│  • Comisión SGB: $750 (1.5%)                           │
│  • TU RECIBES: $47.800 (95.6%)                         │
│                                                         │
│  💵 VENTAS PRESENCIALES:                               │
│  • Total vendido: $30.000                              │
│  • Comisiones: $0                                      │
│  • TU RECIBES: $30.000 (100%)                          │
│                                                         │
│  📈 TOTAL RECIBIDO: $77.800                            │
│  📊 Ahorro vs comisión tarjeta: $450                   │
└─────────────────────────────────────────────────────────┘
```

**Desglose por pedido:**
- Pedido #001: Online $5.000 → Recibes $4.780
- Pedido #002: Presencial $3.000 → Recibes $3.000
- Pedido #003: Online $2.000 → Recibes $1.912

---

## 🚀 **PLAN DE IMPLEMENTACIÓN**

### **Semana 1-2: Configuración Marketplace**
- Registro SGB como Marketplace en MP
- Desarrollo de API de integración
- Configuración de webhooks
- Testing con cuenta de prueba

### **Semana 3: Integración Frontend**
- Botón "Pagar Online" en formulario pedido
- Página de selección método pago
- Integración checkout MP
- Página de confirmación

### **Semana 4: Dashboard y Reportes**
- Vista de pagos online en dashboard negocio
- Configuración marketplace por negocio
- Reportes de comisiones
- Analytics de transacciones

### **Semana 5: Testing y Deploy**
- Testing completo del flujo
- Pruebas de carga
- Documentación técnica
- Deploy en producción

---

## 💰 **PROYECCIÓN FINANCIERA**

### **Escenario Conservador:**
```
50 negocios activos
20% adopta pagos online
$50.000 promedio mensual por negocio online
Comisión SGB: 1.5%

Ingresos mensuales SGB: 10 negocios × $50.000 × 1.5% = $7.500
Ingresos anuales: $90.000
```

### **Escenario Optimista:**
```
200 negocios activos
40% adopta pagos online
$100.000 promedio mensual por negocio online
Comisión SGB: 1.5%

Ingresos mensuales SGB: 80 negocios × $100.000 × 1.5% = $120.000
Ingresos anuales: $1.440.000
```

---

## 🎯 **CONCLUSIÓN**

El **Sistema de Pagos Online** como **Paso #3** completará el ecosistema SGB, transformándolo de una herramienta de gestión a una **plataforma de comercio electrónico completa** para negocios de barrio.

**ROI Estimado**: 6-12 meses
**Diferenciación**: Único en el mercado chileno
**Escalabilidad**: Ilimitada

**Este desarrollo posicionará a SGB como líder en digitalización de negocios locales.**