VARGAMESH PAYVMESH0.00020448 USDTLIVE
API ДЛЯ РАЗРАБОТЧИКОВ

VMESH Payment API, webhooks и интеграция Pay Button

Создавайте платёжные запросы, опрашивайте публичный статус или получайте подписанные webhooks. Ваш сервер никогда не передаёт приватный ключ кошелька VargaMesh Pay.

Быстрый старт для магазина

В production создавайте платёж на сервере, перенаправляйте клиента на checkout_url и выполняйте заказ только после подписанного webhook payment.paid или payment.overpaid.

  1. 1. Сервер создаёт платёж через POST /api/v1/payments.
  2. 2. Перенаправьте клиента на checkout_url из ответа API.
  3. 3. Проверяйте X-VMESH-Pay-Signature для входящих webhooks.
  4. 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.

Pay with VMESH

Пример 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_url

API рыночной цены

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.