创建上下文
请将订单、会话、证据或代理任务与付款事实分开描述。
在不接管钱包控制权的情况下请求付款。
创建标准 Payment Request，附加业务上下文，让客户在本地审核并签名，然后通过一致的状态模型跟踪结果。
Official Testnet integration is open for supported flows. Mainnet settlement, commercial pricing, and service-level commitments are not offered.
更清晰的边界
由你的系统发起请求，由客户的钱包做出决定。
VelarumPay 将商户系统、代理系统和钱包签名职责明确区分。
请求付款
发送精确的金额、资产、网络、收款方、到期时间和幂等键。
用户批准
客户会在自己的设备上签名前审核风险和交易事实。
查看状态
你的集成可以读取确定性的状态和事件，而不会获得签名权限。
集成路径
一个 protocol，多种连接方式。
选择适合你应用的接入方式。所有受支持的路径最终都会汇聚到 velarum.payment_request.v1.
直接集成 Platform API。
使用已发布的 OpenAPI 契约处理配对、连接、交易上下文、Payment Requests、状态和事件。服务端会校验权限范围、到期时间、精确金额和幂等性。
围绕相同契约使用类型化辅助工具。
JavaScript SDK 将配对、校验、上下文创建、Payment Request 创建和状态轮询封装为更小的客户端接口。API 和 JSON Schema 仍是事实依据。
给代理请求工具，不给钱包密钥。
MCP 服务器和连接器只暴露一组有意缩小的工具，用于配对、创建上下文、请求付款和读取状态。它们不能批准、签名、导出密钥，也不能绕过钱包审核。
Official Testnet 适用场景
从控制模型最关键的地方开始。
受支持的集成应具有明确的用户、请求方、付款原因和可测试的审批流程。
商户结账
在不让商户处理用户密钥的前提下，评估订单流程中的钱包配对和付款请求。
受信任应用
连接那些需要用户批准付款且状态可审计、但不具备托管权限的软件。
AI 代理工作流
让本地或托管代理提出购买建议，同时保留确定性校验和人工批准。
你的集成必须保留的内容
事实清晰、范围受限、状态可观测。
良好的集成应让钱包用户易于核验请求，也让你的团队易于诊断结果。
- 精确的小数字符串金额与明确的资产标识
- 网络、收款方、费用、到期时间和幂等性控制
- 交易上下文与不可变付款事实分离
- 权限范围仅限于你的应用实际需要的能力
- 安全处理连接令牌和确定性错误状态
- 你的服务中不得包含私钥、助记词或签名材料
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.
不含敏感数据请勿包含 API keys、钱包地址、助记词、私钥、生产客户数据或签名材料。