Primeros Pasos
Blitz Ecom es una plataforma de orquestacion de pagos open source que te permite conectarse a multiples procesadores de pago con una unica integracion. Sigue estos pasos para comenzar.
Asegurate de tener Docker 20.10+, o Node.js 18+ / Rust 1.75+ instalados en tu maquina.
Instalacion
Elige tu metodo de instalacion preferido. Recomendamos Docker para rapido prototipado y npm/cargo para integracion en proyectos existentes.
# Clonar el repositorio
git clone https://github.com/blitz-ecom/blitz-server.git
cd blitz-server
# Levantar con Docker Compose
docker compose up -d
# Verificar que los servicios estan corriendo
docker compose psConfiguracion
Crea un archivo blitz.toml en la raiz de tu proyecto con la configuracion base. Aqui defines tus procesadores de pago, reglas de routing y credenciales.
# Configuracion de Blitz Ecom
[general]
project_id = "proj_abc123def456"
environment = "sandbox"
currency = "MXN"
[server]
host = "0.0.0.0"
port = 8080
workers = 4
[processors.stripe]
type = "stripe"
api_key = "sk_test_..."
webhook_secret = "whsec_..."
[processors.adyen]
type = "adyen"
api_key = "AQEyhmfx..."
merchant_account = "BlitzEcomECOM"
[routing]
default = ["stripe", "adyen"]
fallback = "adyen"
[[routing.rules]]
condition = "amount > 50000"
processor = "adyen"
reason = "Monto alto - usar Adyen"{
"general": {
"project_id": "proj_abc123def456",
"environment": "sandbox",
"currency": "MXN"
},
"processors": {
"stripe": {
"type": "stripe",
"api_key": "sk_test_..."
},
"adyen": {
"type": "adyen",
"api_key": "AQEyhmfx..."
}
},
"routing": {
"default": ["stripe", "adyen"],
"fallback": "adyen"
}
}Primer Pago
Una vez configurado, crea tu primer pago usando la API de Blitz Ecom. Este ejemplo muestra un pago con tarjeta de prueba.
curl -X POST https://sandbox.blitz-ecom.com/payments \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{
"amount": 15000,
"currency": "MXN",
"method": "card",
"card": {
"number": "4242424242424242",
"exp_month": 12,
"exp_year": 2027,
"cvc": "123"
},
"metadata": {
"order_id": "ORD-001",
"customer_email": "ejemplo@correo.com"
}
}'{
"id": "pay_7sK2mN4xR8wQ",
"status": "processing",
"amount": 15000,
"currency": "MXN",
"processor": "stripe",
"created_at": "2026-07-10T14:30:00Z",
"next_action": {
"type": "redirect",
"url": "https://checkout.stripe.com/..."
}
}Consulta la API Reference para ver todos los endpoints disponibles o revisa las guias de integracion para conectores especificos.
Conceptos Clave
Routing Inteligente
El sistema de routing analiza cada transaccion y determina automaticamente el mejor procesador de pago segun reglas como monto, moneda, tipo de tarjeta y tasa de aprobacion historica.
// Regla: tarjetas internacionales van a Adyen
[[routing.rules]]
condition = "card_country != 'MX'"
processor = "adyen"
priority = 1
// Regla: montos bajos optimizados a Stripe
[[routing.rules]]
condition = "amount <= 5000"
processor = "stripe"
priority = 2
// Fallback si todas las reglas fallan
[routing]
fallback = "adyen"Vault de Pagos
El Vault almacena de forma segura los tokens de pago usando cifrado AES-256. Nunca se almacenan datos sensibles de tarjetas en texto plano. Cumple con PCI DSS Nivel 1.
// Guardar un metodo de pago
curl -X POST https://sandbox.blitz-ecom.com/vault/tokens \
-H "Authorization: Bearer sk_test_..." \
-d '{
"customer_id": "cus_abc123",
"card": {
"number": "4242424242424242",
"exp_month": 12,
"exp_year": 2027
}
}'
// Respuesta: token seguro (no datos de tarjeta)
// { "token": "tok_visa_...4242", "fingerprint": "fp_..." }