AgentPay JS SDK

La infraestructura financiera universal para Agentes de IA en la Web.

AgentPay permite a tus agentes de inteligencia artificial realizar pagos de manera autónoma, segura y controlada. Integra capacidades financieras directamente en tu código con mecanismos de aprobación humana y límites de gasto.

📦 Instalación

Instala el paquete mediante npm:

npm install agentpay

(Nota: Asegúrate de tener configurado tu package.json con "type": "module" si usas import/export, o usa require en entornos CommonJS).

🚀 Uso Rápido

A continuación, un ejemplo básico de cómo inicializar la billetera y realizar un pago:

import { AgentPay } from 'agentpay';

// 1. Inicializa con tu API Key (sk_live_...)
const wallet = new AgentPay('sk_live_tu_api_key_aqui');

async function procesarPago() {
    console.log("Iniciando pago...");

    // 2. Ejecuta el pago
    // pay(vendor, amount, description)
    const resultado = await wallet.pay(
        'aws.amazon.com',  // Proveedor
        15.50,             // Monto en USD
        'Pago de servidores de inferencia' // Motivo
    );

    // 3. Imprime el resultado
    console.log(resultado);
}

procesarPago();

📚 Referencia del API

new AgentPay(apiKey, [baseUrl])

Constructor para inicializar la instancia del cliente.

• apiKey (string, requerido): Tu clave secreta de producción (empieza por sk_live_...).
• baseUrl (string, opcional): URL del servidor AgentPay. Por defecto apunta a la API de producción (https://agentpay-core.onrender.com).

async AgentPay.pay(vendor, amount, description)

Realiza una solicitud de pago. Esta función maneja la comunicación con la API y devuelve un mensaje formateado con el estado de la transacción.

Parámetros:

| Parámetro | Tipo | Descripción | |---------------|----------|-----------------------------------------------------------------------------| | vendor | string | Dominio o identificador del proveedor (ej. openai.com, aws.amazon.com). | | amount | number | Cantidad a pagar en USD (ej. 20.00). | | description | string | Descripción corta del pago para propósitos de auditoría y logs. |

Retornos:

La función devuelve un Promise<string> con uno de los siguientes mensajes, incluyendo iconos para fácil lectura en logs:

• Éxito: ✅ PAGO EXITOSO: $50 a 'vendor' (Ref: COMPLETED)

• Requiere Aprobación (Gobernanza): ⏸️ ALTO: Aprobación requerida. Link enviado al dueño: https://... (Ocurre si el monto supera los límites configurados o si el agente requiere supervisión)

• Denegado: ⛔ DENEGADO: Fondos insuficientes o ⛔ DENEGADO: Riesgo detectado

• Error de Servidor/Red: ❌ ERROR SERVIDOR (500): ... o ⚠️ ERROR DE CONEXIÓN: ...

🛡️ Gobernanza y Seguridad

AgentPay está diseñado pensando en la seguridad de los agentes autónomos:

1. Límites de Gasto: Configura límites diarios o por transacción desde tu dashboard.
2. Aprobación Humana: Si un pago es sospechoso o excede los límites, el SDK pausará la ejecución y solicitará aprobación vía enlace seguro.
3. Auditoría Total: Cada transacción lleva una descripción y queda registrada inmutablemente.

📄 Licencia

Este proyecto está bajo la licencia MIT. Consulta el archivo package.json para más detalles.

creado por Jairo Gelpi