Agent Payments (MCP)

Infraestructura de pagos para agentes

Infraestructura financiera para agentes autónomos.

Infraestructura compatible con agentes

Orangepill ofrece un servidor Model Context Protocol (MCP) que expone capacidades financieras a agentes con políticas estrictas y preflight checks.

  • Descubrir productos y cotizar pagos
  • Iniciar compras con idempotencia y auditoría
  • Leer balances y ledger de forma segura
Agenteorangepill-payments-mcpOrangepill Financial OSRieles financieros

Infraestructura financiera de nivel producción

Diseñada para fintechs con orquestación segura y APIs para desarrolladores.

Plataforma API-firstArquitectura basada en eventosPagos multi-riel

Resumen del servidor MCP

El servidor MCP se identifica como orangepill-payments-mcp y usa autenticación mcp_session_token, con OAuth opcional para agentes ligados a usuarios.

Las sesiones incluyen tenant_id, project_id, agent_id y policy_id para seguridad multi-tenant estricta.

Identidad MCP

  • Servidor: orangepill-payments-mcp
  • Auth: mcp_session_token
  • Opcional: OAuth para agentes con usuario

Grupos de herramientas MCP

Descubrimiento y cotización

Operaciones seguras sin efectos financieros.

catalog_searchcatalog_get_productcheckout_quoterisk_preflight

Compra y liquidación

Operaciones comerciales, con liquidación normalmente disparada por el sistema.

order_createcheckout_initiatepayment_getorder_getorder_settle

Wallet y balances

Lectura de balances por defecto.

wallet_get_balanceswallet_get_voucher_serialsledger_get_journalledger_list_entries

Admin e inventario

Acciones privilegiadas con scopes elevados.

voucher_mint_inventoryvoucher_inventory_getvoucher_redeem

Principios de diseño MCP

  • Superficie de herramientas pequeña con validación estricta
  • Idempotency keys para efectos secundarios
  • Campo reason obligatorio para auditoría
  • Soporte opcional de dry_run
Ejemplo de schema
{
  "name": "order_create",
  "inputSchema": {
    "required": ["items", "currency", "idempotencyKey", "reason"]
  }
}

Risk preflight

Antes de cualquier acción financiera, los agentes llaman a risk_preflight para recibir allowed, requires_review o blocked.

Flujo de agente

catalog_search
checkout_quote
risk_preflight
order_create
checkout_initiate
confirmación de pago

Políticas de agente

Los agentes operan bajo AgentIdentity y AgentPolicy con límites de gasto, allowlists y controles de riesgo.

Restricciones de política

  • Operaciones permitidas
  • Límites de gasto
  • Merchant allowlists
  • Controles de riesgo
Conversación del agente
Encuentra entradas para el evento de esta noche.
Encontré una entrada disponible por 50,000 COP.
catalog_search
{
  "tool": "catalog_search",
  "query": "event ticket"
}

El agente descubre un producto sin efectos financieros.

Bre-BCardWallet
Flujo de infraestructura
Agente
Servidor MCP
Orangepill Financial OS
Rieles financieros
Los agentes no llaman rieles de pago directamente. MCP aplica políticas, preflight y orquestación segura.

Ejemplo para desarrolladores

Los agentes descubren productos, crean órdenes e inician checkout mediante herramientas MCP.

Uso MCP
const quote = await mcp.checkout_quote({
  product_id: "ticket-123",
  currency: "COP"
})

const order = await mcp.order_create({
  items: [{ product_id: "ticket-123" }],
  currency: "COP",
  idempotencyKey: "order-123",
  reason: "user purchase"
})

Infraestructura para comercio con agentes

Orangepill permite delegar acciones financieras a agentes sin exponer los rieles directamente. MCP habilita comercio con políticas y auditoría.

Comienza a construir con Orangepill

Accede a infraestructura financiera programable y acelera tu lanzamiento.