Un marco de trabajo de nivel profesional para construir integraciones de pago seguras y conformes y sistemas automatizados de gestión de suscripciones.
Instalar y Descargar
1. ClawHub CLI
La forma más rápida de instalar una habilidad directamente desde el registro.
npx clawhub@latest install billing
2. Instalación manual
Copia la carpeta de la habilidad a una de estas ubicaciones
~/.openclaw/skills/ <project>/skills/ Prioridad: Espacio de trabajo > Local > Integrado
3. Instalación del prompt
Copia este prompt en OpenClaw para instalarlo automáticamente.
Ayúdame a instalar billing usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).
¿Prefieres descargar?
Obtén los archivos originales de la habilidad en un archivo ZIP.
¿Qué es Facturación?
El módulo de Facturación dentro de Openclaw Skills está diseñado para ayudar a los desarrolladores a arquitectar sistemas financieros robustos, cubriendo todo, desde el procesamiento inicial de pagos hasta operaciones complejas de ingresos. Proporciona un esquema técnico para integrar proveedores como Stripe y Paddle, garantizando al mismo tiempo el estricto cumplimiento de estándares de seguridad como el cumplimiento PCI-DSS y la verificación de firmas de webhooks.
Al aprovechar esta habilidad, los equipos pueden implementar máquinas de estado de suscripción sofisticadas, manejar transacciones multi-moneda utilizando aritmética basada en enteros y automatizar la facturación con lógica de cumplimiento fiscal integrada. Este componente de Openclaw Skills garantiza que los datos financieros permanezcan consistentes y seguros, incluso al tratar con eventos de webhook asíncronos o escenarios complejos de prorrateo.
Casos de uso de Facturación
- Creación de modelos seguros de suscripción SaaS con períodos de prueba y lógica de renovación automática.
- Implementación de repartos de pagos en mercados internacionales y soporte multi-moneda.
- Automatización del cumplimiento fiscal global para jurisdicciones de IVA, MOSS e impuestos sobre las ventas de EE. UU.
- Desarrollo de manejadores de webhooks idempotentes para gestionar eventos de pago y cambios de estado de suscripción de forma segura.
- Gestión de patrones de reconocimiento de ingresos para los estándares contables ASC 606/IFRS 15.
Cómo funciona Facturación
- Inicialice las integraciones de pago utilizando las unidades monetarias más pequeñas (enteros) para garantizar la precisión matemática y evitar errores de punto flotante.
- Configure puntos finales de webhook seguros con verificación de firma obligatoria para manejar eventos asíncronos como invoice.paid o customer.subscription.deleted.
- Asigne los estados de suscripción (en prueba, activo, vencido, cancelado) a los controles de acceso de la aplicación interna mediante una máquina de estados robusta.
- Aplique lógica explícita de prorrateo e impuestos para manejar cambios de plan a mitad de ciclo y requisitos de cumplimiento internacional.
- Implemente transacciones de base de datos idempotentes para conciliar los datos del proveedor de pagos con los registros locales, mitigando condiciones de carrera.
Configuración de Facturación
Para integrar la lógica de Facturación en su proyecto a través de Openclaw Skills, asegúrese de que su entorno esté configurado para el proveedor de pagos elegido:
# Ejemplo: Configuración de un entorno basado en Stripe
# 1. Instale el SDK del proveedor
npm install stripe
# 2. Configure las variables de entorno necesarias
export STRIPE_SECRET_KEY="your_secret_key"
export STRIPE_WEBHOOK_SECRET="your_webhook_signing_secret"
# 3. Inicialice su máquina de estados local para que coincida con el esquema de la habilidad de Facturación
Esquema de datos y taxonomía de Facturación
La habilidad de Facturación organiza los datos financieros para garantizar la auditabilidad y la precisión. Las estructuras de datos clave incluyen:
| Objeto | Método de Organización | Metadatos Primarios |
|---|---|---|
| Montos Monetarios | Basado en enteros (Centavos) | amount_cents, currency_code |
| Estado de Suscripción | Enum basado en estado | status, current_period_end, cancel_at_period_end |
| Eventos de Webhook | Mapeo de Idempotencia | event_id, processed_at, signature_verified |
| Tokens PCI | Solo Referencia Externa | cus_id, pm_id (Sin datos brutos de tarjeta) |
| Registros Fiscales | Mapeo de Jurisdicción | vat_id, reverse_charge_status, tax_rate |
Funciones avanzadas de Facturación
- Lógica avanzada de idempotencia de webhooks para manejar la entrega de eventos fuera de orden.
- Soporte integrado para facturación basada en el uso y niveles de precios empresariales complejos.
- Verificación automatizada del número de IVA VIES para el cumplimiento de la inversión del sujeto pasivo B2B.
- Patrones integrados de reconocimiento de ingresos para manejar ingresos diferidos en planes anuales.
- Gestión automatizada de contracargos y flujos de trabajo proactivos de envío de pruebas.
SKILL.md
Cargando
Habilidades relacionadas de Openclaw
Biblia
Una habilidad de estudio teológico de alta precisión para agentes de IA centrada en la precisión de las citas, el análisis del idioma original y la metodología de interpretación sistemática.
Beszel
Una herramienta especializada para implementar, asegurar y optimizar el monitoreo de infraestructura Beszel utilizando agentes Docker y manuales operativos automatizados.
Guía de la Ciudad de Berlín
Un sofisticado módulo de inteligencia que proporciona datos localizados para visitantes, expatriados y emprendedores en Berlín.
Optimización del Idioma Bengalí
Una habilidad especializada diseñada para hacer que el bengalí generado por IA suene humano, expresivo y culturalmente auténtico en lugar de robótico o excesivamente formal.
Binance API
Gestione de forma segura el trading de Binance Spot, los flujos de datos de mercado y las firmas de API a través de flujos de trabajo automatizados basados en terminales.
Bioinformática
Una habilidad especializada para ejecutar flujos de trabajo de análisis genómico, alineación de secuencias y detección de variantes utilizando herramientas de línea de comandos estándar de la industria.
Presentado*
