Zahlungslinks: Anleitung

Was ein Link ist

Ein Zahlungslink ist eine Hülle um Zahlungen. Jeder Kunde, der über den Link zahlt, erhält eine eigene Zahlung auf derselben gehosteten Zahlungsseite wie jede andere Qvard-Zahlung.

Eine Zahlung ist eine Rechnung mit festem Kurs. Der Link ist ein wiederverwendbarer Einstiegspunkt, der solche Zahlungen erzeugt. Ein Link kann viele Zahlungen erzeugen, ersetzt aber nicht die Zahlung selbst.

Der Link hat eine eigene Währung, die der Kunde sieht und in der er zahlt. Jede Zahlung fixiert ihren Kurs bei der Erstellung. Die aktuellen Kurse stehen auf der Seite „Währungskurse“.

Link im Dashboard erstellen

Öffnen Sie im Dashboard den Bereich 'Zahlungslinks' und richten Sie den Link ein. Die Optionen sind:

• Betrag: fest, oder vom Kunden eingegeben, mit Mindest- und Höchstwert.
• Zahlungslimit: ohne Limit, eine Zahlung oder N Zahlungen.
• Laufzeit: 1, 7 oder 30 Tage, oder ohne Laufzeit.
• E-Mail des Käufers: nicht abfragen, optional oder Pflicht.

Jeder Link hat seine eigene Adresse: https://qvard.com/l/<slug>. Der Kunde öffnet sie, wählt Token und Netzwerk und sieht danach die übliche Zahlungsseite.

Den Link können Sie als QR-Code im PNG-Format herunterladen, etwa für gedruckte Rechnungen, Belege und Plakate. Die Schaltfläche Teilen gibt Ihnen den Link zum Versand über einen beliebigen Kanal.

Ein Link pro Kunde über die API

Um genau zu wissen, wer zahlt, legen Sie für jeden Kunden per API von Ihrem Server aus eine Zahlung an und senden dem Kunden die redirectUrl aus der Antwort. Der geheime Schlüssel (qvard_sk_…) bleibt nur auf Ihrem Server.

Beispielanfrage

# Create a payment for one customer
curl -X POST https://api.qvard.com/api/v1/payment \
  -H 'x-api-key: qvard_sk_YOUR_SECRET_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"price":12499.00,"currency":"INR","id":"order-123"}'

# The response contains "data": { "redirectUrl": "https://my.qvard.com/pay/..." }
# Send that redirectUrl to the customer.

// Run on your server only: the secret key must not reach the browser
async function createPaymentLink(orderId, amount) {
  const res = await fetch('https://api.qvard.com/api/v1/payment', {
    method: 'POST',
    headers: {
      'x-api-key': process.env.QVARD_SECRET_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ price: amount, currency: 'INR', id: orderId })
  });
  if (!res.ok) throw new Error('Qvard API error: ' + res.status);
  const payment = await res.json();
  return payment.data.redirectUrl; // send this link to the customer
}

// Usage inside an async handler: const link = await createPaymentLink('order-123', 10);

Die Antwort enthält die Zahlungs-ID und die redirectUrl, zum Beispiel https://my.qvard.com/pay/<uuid>. Senden Sie dem Kunden die redirectUrl. Der Wert id in der Anfrage ist Ihre Bestellnummer.

Geben Sie den geheimen Schlüssel (qvard_sk_…) niemals in Code, der im Browser läuft, oder in ein öffentliches Repository. Legen Sie Zahlungen nur vom Server aus an.

Begrenzter Verkauf und Einmal-Link

Ein Einmal-Link nimmt eine Zahlung an, das passt zu einer Rechnung. Ein Link mit einem Limit von N Zahlungen nimmt N Zahlungen an und stoppt dann, das passt zu einem begrenzten Angebot, etwa 100 Plätzen.

Status des Links

• Aktiv: der Link nimmt Zahlungen an.
• Deaktiviert: Sie haben den Link im Dashboard ausgeschaltet. Er nimmt keine Zahlungen an, bis Sie ihn wieder einschalten.
• Abgelaufen: die Laufzeit (1, 7 oder 30 Tage) ist vorbei.
• Ausgeschöpft: das Zahlungslimit ist erreicht.

Webhook für Zahlungen aus einem Link

Zahlungen aus einem Link senden denselben Webhook mit demselben Header X-Qvard-Signature. Ihr Body hat zwei zusätzliche optionale Felder: paymentLink, also den Slug des Links, und customerEmail, die vom Kunden eingegebene E-Mail, falls der Link sie verlangt hat. Andere Zahlungen haben diese Felder nicht.

So prüfen Sie die Webhook-Signatur

Was der Link nicht verrät

Ein wiederverwendbarer Link zeigt nicht, wer bezahlt hat. Der Webhook meldet die Zahlung, nicht den Käufer.

Das Feld customerEmail ist optional und nicht bestätigt: Der Kunde tippt es selbst ein, und niemand prüft es. Wenn Sie den Käufer genau kennen müssen, legen Sie für jeden Käufer eine Zahlung per API an.

API-Referenz