VARGAMESH PAY实时
开发者 API

无需托管即可集成 VMESH 支付。

创建支付请求、查询公开状态或接收签名 webhook。你的服务器永远不会向 VargaMesh Pay 共享钱包私钥。

创建支付

POST /api/v1/payments\nX-VMESH-Pay-API-Key: YOUR_KEY\nContent-Type: application/json\n\n{\n  "recipient": "shop.vmesh",\n  "amount": "125.00",\n  "description": "Order #1841",\n  "confirmations_required": 2,\n  "expires_in": 1800,\n  "webhook_url": "https://shop.example/callback"\n}

状态

GET /api/v1/payments/VP-XXXXXXXXXXXX

状态值: open, underpaid, detected, confirming, paid, overpaid, expired, cancelled, reorged.

商户收款地址池

通过 POST /api/v1/merchant/addresses 导入新的公开 VMESH 收款地址,然后使用 "use_address_pool": true 创建支付并省略 recipient。每个地址只分配一次,不会自动重复使用。

Webhook 验证

每个 webhook 都包含 X-VMESH-Pay-Signature: sha256=…。请使用配置的 webhook 密钥,对完整请求正文验证 HMAC-SHA256。