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.”