DEVELOPER API
Integrate VMESH payments without custody.
Create payment intents, poll public status or receive signed webhooks. Your server never shares a wallet private key with VargaMesh Pay.
Create payment
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}Status
GET /api/v1/payments/VP-XXXXXXXXXXXXStatuses: open, underpaid, detected, confirming, paid, overpaid, expired, cancelled, reorged.
Merchant receive-address pool
Import fresh public VMESH receive addresses through POST /api/v1/merchant/addresses, then create a payment with "use_address_pool": true and omit recipient. Each address is leased once and never automatically reused.
Webhook verification
Every webhook carries X-VMESH-Pay-Signature: sha256=…. Verify HMAC-SHA256 over the exact request body using your configured webhook secret.