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. A szervered létrehozza a fizetést a POST /api/v1/payments hívással.
- 2. Irányítsd az ügyfelet az API checkout_url értékére.
- 3. Ellenőrizd az X-VMESH-Pay-Signature fejlécet a webhookoknál.
- 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.
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_urlPiaci á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/marketKereskedő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.
