Crear contexto
Describe el pedido, la sesión, la evidencia o la tarea del agente por separado de los hechos del pago.
Solicita un pago sin tomar control de la wallet.
Crea un Payment Request estándar, adjunta el contexto comercial, deja que la persona cliente revise y firme localmente, y luego sigue el resultado mediante un modelo de estado consistente.
Official Testnet integration is open for supported flows. Mainnet settlement, commercial pricing, and service-level commitments are not offered.
Un límite más claro
Tu sistema solicita. La wallet del cliente decide.
VelarumPay mantiene diferenciados los sistemas de comercios, los sistemas de agentes y las responsabilidades de firma de la wallet.
Solicitar pago
Envía un monto exacto, activo, red, destinatario, vencimiento y clave de idempotencia.
El usuario aprueba
La persona cliente revisa el riesgo y los hechos de la transacción antes de firmar en su dispositivo.
Observar estado
Tu integración lee estado y eventos deterministas sin obtener autoridad de firma.
Rutas de integración
Un protocolo, varias formas de conectar.
Elige la superficie que se adapte a tu aplicación. Cada ruta compatible converge en velarum.payment_request.v1.
Integra directamente con Platform API.
Usa el contrato OpenAPI publicado para emparejamiento, conexiones, contextos de transacción, Payment Requests, estado y eventos. Los servicios del lado del servidor validan alcances, vencimiento, montos exactos e idempotencia.
Usa helpers tipados sobre los mismos contratos.
JavaScript SDK reúne emparejamiento, validación, creación de contexto, creación de Payment Request y consulta de estado en una superficie de cliente más reducida. API y JSON Schema siguen siendo la fuente de verdad.
Dales a los agentes herramientas de solicitud, nunca claves de wallet.
El servidor MCP y los conectores exponen un conjunto de herramientas deliberadamente pequeño para emparejar, crear contexto, solicitar pago y leer estado. No pueden aprobar, firmar, exportar claves ni omitir la revisión de la wallet.
Compatibilidad con Official Testnet
Empieza donde el modelo de control importa.
Una integración compatible debe tener un usuario, solicitante, motivo de pago y flujo de aprobación comprobable claramente definidos.
Checkout del comercio
Evalúa el emparejamiento de la wallet y las solicitudes de pago desde un flujo de pedido sin pedirle al comercio que maneje las claves del usuario.
Aplicaciones de confianza
Conecta software que necesita pagos aprobados por la persona usuaria y estado auditable, sin autoridad de custodia.
Flujos de trabajo de agentes de AI
Permite que un agente local o alojado proponga una compra, conservando la validación determinista y la aprobación humana.
Lo que tu integración debe preservar
Hechos claros, alcances limitados y estado observable.
Una buena integración facilita que la persona usuaria de la wallet verifique la solicitud y que tu equipo diagnostique el resultado.
- Cadenas decimales exactas de monto e identidad explícita del activo
- Controles de red, destinatario, comisión, vencimiento e idempotencia
- Contexto de transacción separado de los hechos inmutables del pago
- Alcances limitados a las capacidades que tu aplicación realmente necesita
- Manejo seguro de tokens de conexión y estados de error deterministas
- No incluyas claves privadas, frases de recuperación ni material de firma en tu servicio
Official Testnet integration support
Tell us what you want to integrate.
Share your use case, integration surface, intended user approval flow, and test environment. This support request does not grant mainnet or commercial production access.
Sin datos sensiblesNo incluyas claves de API, direcciones de wallet, frases de recuperación, claves privadas, datos de clientes de producción ni material de firma.
¿Prefieres inspeccionar primero los contratos?
El subdominio para desarrolladores contiene Quickstart, la superficie REST, los esquemas del protocolo y la guía de MCP.