VARGAMESH PAYVMESH0.00020448 USDTLIVE
ENTWICKLER-API

VMESH Payment API, Webhooks & Pay-Button-Integration

Erstelle Zahlungsanforderungen, frage den öffentlichen Status ab oder empfange signierte Webhooks. Dein Server teilt niemals einen Wallet-Private-Key mit VargaMesh Pay.

Merchant Quick Start

Für produktive Checkouts erstellst du die Zahlung serverseitig, leitest den Kunden auf checkout_url weiter und erfüllst die Bestellung erst, wenn ein signierter Webhook payment.paid oder payment.overpaid meldet.

  1. 1. Dein Server erstellt die Zahlung über POST /api/v1/payments.
  2. 2. Leite den Kunden auf die von der API gelieferte checkout_url weiter.
  3. 3. Prüfe X-VMESH-Pay-Signature bei eingehenden Webhooks.
  4. 4. Markiere die Bestellung nur bei payment.paid oder payment.overpaid als bezahlt.
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"}'

Einbettbarer Pay Button

Für Spenden, Rechnungen und einfache Checkout-Links genügt ein Script und ein <vmesh-pay-button>-Element. Der Button öffnet VargaMesh Pay mit vorausgefülltem Empfänger und Betrag; kein API-Key landet im Browser.

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

Unterstützte Attribute: recipient, amount, label, reference, confirmations, expires, lang und theme.

Pay with VMESH

PHP-Beispiel

<?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-Beispiel

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

Marktpreis-API

GET /api/v1/market liefert den gecachten VMESH/USDT-Ticker von NestEx, den auch diese Seite nutzt. Die Daten sind öffentlich und kein garantierter Ausführungspreis.

GET /api/v1/market

Händler-Empfangsadressenpool

Importiere frische öffentliche VMESH-Empfangsadressen über POST /api/v1/merchant/addresses. Erstelle danach eine Zahlung mit "use_address_pool": true und ohne recipient. Jede Adresse wird einmal reserviert und niemals automatisch wiederverwendet.

Webhook-Verifizierung

Jeder Webhook enthält X-VMESH-Pay-Signature: sha256=…. Prüfe HMAC-SHA256 über den exakten Request-Body mit deinem konfigurierten Webhook-Secret.

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

Sicherheits-Checkliste

API_KEY und WEBHOOK_SECRET bleiben ausschließlich serverseitig. Nutze frische Empfangsadressen, HTTPS-Webhooks, prüfe HMAC-Signaturen, aktualisiere Bestellungen idempotent und erfülle nie aufgrund eines ungeprüften Browser-Callbacks.

VMESH-Zahlungen ohne Verwahrung integrieren

VargaMesh Pay trennt Zahlungskoordination und Wallet-Verwahrung. Händler können eigene öffentliche Empfangsadressen verwenden, On-Chain-Settlement überwachen und Bestellsysteme über signierte Webhooks anbinden.