VMESH Payment API, webhooks и интеграция Pay Button
Создавайте платёжные запросы, опрашивайте публичный статус или получайте подписанные webhooks. Ваш сервер никогда не передаёт приватный ключ кошелька VargaMesh Pay.
Быстрый старт для магазина
В production создавайте платёж на сервере, перенаправляйте клиента на checkout_url и выполняйте заказ только после подписанного webhook payment.paid или payment.overpaid.
- 1. Сервер создаёт платёж через POST /api/v1/payments.
- 2. Перенаправьте клиента на checkout_url из ответа API.
- 3. Проверяйте X-VMESH-Pay-Signature для входящих webhooks.
- 4. Отмечайте заказ оплаченным только при payment.paid или payment.overpaid.
curl -X POST https://pay.vargamesh.com/api/v1/payments \
-H 'X-VMESH-Pay-API-Key: YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{"use_address_pool":true,"amount":"125.00","description":"Order #1841","confirmations_required":2,"expires_in":1800,"webhook_url":"https://shop.example/vmesh/webhook"}'Встраиваемый Pay Button
Для пожертвований, счетов и простых ссылок достаточно одного script и элемента <vmesh-pay-button>. API-ключ не попадает в браузер.
<script src="https://pay.vargamesh.com/assets/vmesh-pay-button.js" async></script>
<vmesh-pay-button recipient="shop.vmesh" amount="25" label="My Shop" reference="Order #1841" confirmations="2" expires="1800" lang="ru">Pay with VMESH</vmesh-pay-button>Атрибуты: recipient, amount, label, reference, confirmations, expires, lang и theme.
Пример PHP
<?php
$payload = json_encode([
'use_address_pool' => true,
'amount' => '125.00',
'description' => 'Order #1841',
'confirmations_required' => 2,
'expires_in' => 1800,
'webhook_url' => 'https://shop.example/vmesh/webhook',
]);
$ch = curl_init('https://pay.vargamesh.com/api/v1/payments');
curl_setopt_array($ch, [CURLOPT_POST=>true, CURLOPT_POSTFIELDS=>$payload, CURLOPT_RETURNTRANSFER=>true, CURLOPT_HTTPHEADER=>['Content-Type: application/json','X-VMESH-Pay-API-Key: '.getenv('VMESH_PAY_API_KEY')]]);
$payment = json_decode(curl_exec($ch), true);
header('Location: '.$payment['checkout_url']);Пример Node/JavaScript
const response = await fetch('https://pay.vargamesh.com/api/v1/payments', {
method: 'POST',
headers: {'Content-Type':'application/json','X-VMESH-Pay-API-Key':process.env.VMESH_PAY_API_KEY},
body: JSON.stringify({use_address_pool:true, amount:'125.00', description:'Order #1841', confirmations_required:2, expires_in:1800, webhook_url:'https://shop.example/vmesh/webhook'})
});
const payment = await response.json();
// Redirect the customer to payment.checkout_urlAPI рыночной цены
GET /api/v1/market возвращает кэшированный тикер VMESH/USDT NestEx, который использует сайт. Это не гарантированная цена исполнения.
GET /api/v1/marketПул адресов продавца
Импортируйте новые публичные VMESH-адреса через POST /api/v1/merchant/addresses, затем создайте платёж с "use_address_pool": true без recipient. Каждый адрес резервируется один раз и автоматически не используется повторно.
Проверка webhook
Каждый webhook содержит X-VMESH-Pay-Signature: sha256=…. Проверьте HMAC-SHA256 точного тела запроса с помощью настроенного webhook-секрета.
X-VMESH-Pay-Event: payment.paid
X-VMESH-Pay-Signature: sha256=<hex HMAC>Проверка безопасности
Храните API_KEY и WEBHOOK_SECRET только на сервере, используйте свежие адреса, HTTPS-webhooks, проверяйте HMAC и обновляйте заказ идемпотентно.
Интеграция VMESH без хранения средств
VargaMesh Pay отделяет координацию платежа от хранения кошелька. Магазины используют собственные публичные адреса, отслеживают on-chain расчёты и подключают заказы через подписанные webhooks.
