# 🌍 Terminal de Cobros Globales e Internacionales (Stripe API)

> **Resumen para No Técnicos**: Permite que tu empresa latinoamericana cobre a clientes de Estados Unidos, Europa o cualquier parte del mundo en dólares ($USD), euros (€EUR) o su moneda local, aceptando tarjetas de crédito internacionales, Apple Pay, Google Pay y suscripciones recurrentes automáticas.

| Metadato | Detalle |
|---|---|
| **Tipo** | API REST Oficial de Pagos Internacionales |
| **Área Empresarial** | 03. Finanzas, Comercio Exterior y Suscripciones |
| **Nivel de Dificultad** | 🟢 Fácil |
| **Modelo de Costo** | Sin costo mensual fijo. Comisión estándar de 2.9% + $0.30 USD por cobro internacional |
| **Enlace Oficial** | [Stripe Documentation](https://stripe.com/docs) |

---

## 💡 ¿Para qué le sirve a tu empresa? (Valor Real)

Si vendes servicios profesionales (diseño, desarrollo, consultoría, marketing, cursos online, arquitectura) a clientes fuera de tu país, cobrar mediante transferencias bancarias internacionales (SWIFT) es costoso y lento (los bancos cobran comisiones de hasta $40 USD por transferencia y tardan 3 días hábiles).

Con **Stripe**:
- Creas un enlace de cobro seguro (*Payment Link*) en 5 segundos.
- El cliente en Miami, Madrid o Toronto paga con su tarjeta de crédito o con un toque en su iPhone usando Apple Pay.
- El dinero se deposita directamente en tu cuenta bancaria local o cuenta en dólares.

---

## 🎁 ¿Qué valor aporta frente a soluciones tradicionales?

- **Conversión Global de Divisas**: El cliente ve el precio en su moneda y tú lo recibes en la tuya sin complicaciones contables.
- **Suscripciones y Cobros Recurrentes**: Si cobras un servicio mensual (ej: $50 USD al mes por soporte o consultoría), Stripe hace el cargo automático mes a mes sin que tengas que pedirlo.
- **Factura y Recibo Automático en PDF**: Envía un recibo fiscal internacional de forma automática al correo del cliente tan pronto se aprueba la tarjeta.

---

## 🔑 ¿Qué necesitas para activarlo?

1. Una cuenta en [Stripe.com](https://stripe.com) (Disponible en México, Brasil y a través de programas como Stripe Atlas o cuentas multimoneda tipo Wise/Payoneer para el resto de LATAM).
2. Tus claves `STRIPE_PUBLISHABLE_KEY` y `STRIPE_SECRET_KEY` (inician con `pk_test_...` / `sk_test_...` para pruebas y `pk_live_...` / `sk_live_...` para cobros reales).

---

## ⚙️ Configuración Paso a Paso

Variables de entorno para tu backend o servidor MCP:

```env
# Variables de entorno (.env)
STRIPE_SECRET_KEY=tu_clave_secreta_stripe_aqui
STRIPE_PUBLISHABLE_KEY=tu_clave_publica_stripe_aqui
STRIPE_WEBHOOK_SECRET=tu_webhook_secret_stripe_aqui
```

---

## 🤖 Consultor Interactivo (Prompt Guiado para tu IA)

Copia y pega este prompt en tu chat con la IA:

```markdown
Actúa como mi Asesor de Cobranza Internacional con Stripe.
Vamos a generar un enlace de cobro internacional para un cliente extranjero.

Por favor, pregúntame:
1. ¿Cuál es el nombre del cliente y el país donde se encuentra?
2. ¿Cuál es el concepto del servicio o producto exportado?
3. ¿Cuál es el valor en dólares ($USD) o euros (€EUR)?
4. ¿Se trata de un pago único o una suscripción mensual recurrente?

Con esa información, generaré la estructura del enlace de cobro en Stripe y redactaré un correo comercial formal en inglés o español con los detalles de la factura y las instrucciones de pago.
```

---

## 🌎 Caso de Uso Real en América Latina

**Empresa**: "DevStudio Andino" (Agencia de desarrollo web y diseño UI/UX en San José, Costa Rica).
- **Problema**: Conseguían clientes en Estados Unidos, pero muchos prospectos desistían cuando les pedían hacer una transferencia bancaria tradicional a un banco costarricense por los altos costos de intermediación bancaria.
- **Resultado con la API**: Implementaron enlaces de Stripe con cobro en dólares. La tasa de cierre con clientes norteamericanos aumentó un 55% al permitir pagos con tarjeta corporativa en 1 clic.

---

## 🛡️ Consideraciones de Seguridad y Buenas Prácticas

- **Nunca expongas tu clave secreta `sk_live_...` en el navegador**: Las transacciones y cobros deben procesarse siempre desde el lado del servidor o mediante enlaces seguros de Stripe (*Stripe Hosted Checkout*).
- **Control Antifraude (Stripe Radar)**: Mantén activadas las reglas de Radar para bloquear tarjetas robadas o intentos de pago masivos.