81 Pass Docs · SDK, MCP & OpenAPI 3.0

Documentación Técnica, Pagos Agénticos y Especificación MCP

Referencia pública e interactiva de @81pass/sdk, @81pass/mcp-server, credenciales verificables W3C VCDM 2.0 / OIDC4VP y arquitectura criptográfica de Pagos Agénticos.

1. Autorización Dual en Pagos Agénticos (Zero-Tap vs. 1-Tap)

Liquidación Autónoma Instantánea (Zero-Tap)

Cuando la transacción cumple estrictamente las políticas activas de guardrails.json (monto ≤ zero_tap_max_amount, presupuesto diario disponible, comercio permitido, ventana horaria y geocerca), el enclave liquida en tiempo real sin fricción manual.

Desafío Asíncrono Out-of-Band OOB (1-Tap)

Cuando el monto supera zero_tap_max_amount (sin exceder hard_max_limit_per_tx), se emite un desafío Out-of-Band (OOB) vía Push Notification resuelto criptográficamente con Passkeys / WebAuthn (FIDO2) en el enclave seguro del teléfono.

2. Motor Determinista de Políticas (guardrails.json)

Evaluación en tiempo real de límites por transacción (zero_tap_max_amount, hard_max_limit_per_tx), presupuesto diario (daily_budget), listas blancas de comercios (allowed_merchants, ej. merch_cloud_compute_09), ventanas horarias y geocercas (geofencing).

Códigos de Excepción Deterministas: ERR_EXCEEDS_HARD_LIMIT · ERR_DAILY_BUDGET_EXHAUSTED · ERR_MERCHANT_NOT_ALLOWED · ERR_GEOFENCE_RESTRICTION · ERR_OUT_OF_TIME_WINDOW

3. Contratos JSON-RPC 2.0 MCP y Recibos W3C Ed25519

Flujo transaccional estandarizado: request_agentic_payment → PENDING_USER_APPROVAL (retornando auth_url y nonce criptográfico de un solo uso) → SETTLED adjuntando la Verifiable Credential W3C AgenticPaymentReceiptCredential firmada con Ed25519Signature2020.

4. Resiliencia SDK (SSE) y Seguridad de Webhooks (HMAC SHA-256)

  • Transporte Persistente SSE: Conexión vía Server-Sent Events (SSE) con @modelcontextprotocol/sdk y reconexión automática mediante Exponential Backoff + Jitter.
  • Webhooks Firmados: Eventos asíncronos payment.settled y payment.rejected autenticados con firma HMAC SHA-256 y ventana Anti-Replay de 5 minutos (300 segundos).
  • SDK Oficial: npm install @81pass/sdk (PassIdClient) y servidor MCP npx -y @81pass/mcp-server.

5. Protección Oficial de Propiedad Intelectual USPTO y Prohibición de Ingeniería Inversa

  • Titular Exclusivo: 81 Pass, Inc. (Delaware C-Corp · File No. 10762120 · IRS EIN: 38-4412929 · 131 Continental Dr, Suite 305, Newark, DE 19713).
  • Patente Federal en Trámite (U.S. Patent Pending): USPTO Provisional Patent Application No. 64/189,380 (Confirmation No. 2773 · Docket 81PASS-PPA-001 · Filing Date: November 2, 2026).
  • Marca Federal Registrada: 81 PASS™ — USPTO Serial No. 50/194,222 (Filing Date: November 2, 2026 · Clases Internacionales 042 Cloud SaaS/PaaS y 009 Downloadable SDK @81pass/sdk, MCP Server @81pass/mcp-server & .pkpass).

“La arquitectura de ejecución aislada Zero-Knowledge, la autorización biométrica Out-of-Band (Zero-Tap / 1-Tap Passkey), el emparejamiento criptográfico de identidad agéntica y la defensa automatizada ante disputas constituyen propiedad intelectual exclusiva protegida ante la USPTO. Queda estrictamente prohibida su copia, imitación, descompilación o ingeniería inversa.”