VARGAMESH PAYVMESH0.00020448 USDTÉLŐ
FEJLESZTŐI API

VMESH Payment API, webhookok és Pay Button integráció

Hozz létre fizetési kérelmeket, kérdezd le a nyilvános állapotot vagy fogadj aláírt webhookokat. A szervered soha nem oszt meg tárca-privátkulcsot a VargaMesh Pay-jel.

Merchant gyorsindítás

Éles checkoutnál a fizetést szerveroldalon hozd létre, irányítsd az ügyfelet a checkout_url címre, és csak aláírt payment.paid vagy payment.overpaid webhook után teljesítsd a rendelést.

  1. 1. A szervered létrehozza a fizetést a POST /api/v1/payments hívással.
  2. 2. Irányítsd az ügyfelet az API checkout_url értékére.
  3. 3. Ellenőrizd az X-VMESH-Pay-Signature fejlécet a webhookoknál.
  4. 4. Csak payment.paid vagy payment.overpaid esetén jelöld fizetettnek a rendelést.
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"}'

Beágyazható Pay Button

Adományokhoz, számlákhoz és egyszerű checkout linkekhez adj hozzá egy scriptet és egy <vmesh-pay-button> elemet. Az API-kulcs nem kerül a böngészőbe.

<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="hu">Pay with VMESH</vmesh-pay-button>

Támogatott attribútumok: recipient, amount, label, reference, confirmations, expires, lang és theme.

Pay with VMESH

PHP példa

<?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 példa

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

Piaci ár API

A GET /api/v1/market a weboldalon is használt, gyorsítótárazott NestEx VMESH/USDT tickert adja vissza. Ez nem garantált végrehajtási ár.

GET /api/v1/market

Kereskedői fogadócím-készlet

Importálj friss nyilvános VMESH fogadócímeket a POST /api/v1/merchant/addresses végponton, majd hozz létre fizetést "use_address_pool": true értékkel és recipient nélkül. Minden címet egyszer foglalunk le, és automatikusan soha nem használjuk újra.

Webhook ellenőrzése

Minden webhook tartalmazza az X-VMESH-Pay-Signature: sha256=… fejlécet. Ellenőrizd a pontos request body HMAC-SHA256 aláírását a beállított webhook titokkal.

X-VMESH-Pay-Event: payment.paid
X-VMESH-Pay-Signature: sha256=<hex HMAC>

Biztonsági ellenőrzőlista

Az API_KEY és WEBHOOK_SECRET maradjon szerveroldalon, használj friss fogadó címeket, HTTPS webhookokat, ellenőrizd a HMAC aláírást, és idempotensen frissítsd a rendelést.

VMESH fizetések integrálása letétkezelés nélkül

A VargaMesh Pay elválasztja a fizetés koordinációját a tárca kezelésétől. A kereskedők saját nyilvános fogadó címeket használhatnak, követhetik az on-chain elszámolást és aláírt webhookokkal kapcsolhatják rendelési rendszerüket.