Integration Guide

In wenigen Schritten Solana-Zahlungen in Ihre Anwendung integrieren.

Account erstellen & API-Key generieren

Registrieren Sie sich kostenlos und erstellen Sie Ihren Shop im Dashboard. Unter Einstellungen finden Sie Ihren API-Key.

SDK installieren

npmnpm install @paywithsolana/sdk

pippip install paywithsolana

composercomposer require paywithsolana/sdk

cargocargo add paywithsolana

Zahlung erstellen

JavaScript

const payment = await pws.payments.create({
  amount: 25.99,
  currency: 'EUR',
  description: 'Bestellung #12345',
  webhookUrl: 'https://your-app.de/webhook'
});

// Option A: Redirect
window.location.href = payment.checkoutUrl;

// Option B: QR-Code anzeigen
showQRCode(payment.qrCodeUrl);

Webhook-Handler einrichten

Express.js

app.post('/webhook', (req, res) => {
  // Signatur verifizieren
  const valid = pws.webhooks.verify(
    req.body, req.headers['x-pws-signature']
  );
  if (!valid) return res.status(401).send();

  const event = req.body;
  if (event.type === 'payment.completed') {
    // Bestellung als bezahlt markieren
    completeOrder(event.data.metadata.orderId);
  }
  res.status(200).send('OK');
});

On-Chain verifizieren (optional)

Für maximale Sicherheit können Sie die Transaktion zusätzlich on-chain verifizieren:

const verified = await pws.payments.verifyOnChain(
  payment.id
);
// verified.signature — Solana TX Signature
// verified.confirmed — true/false

Live schalten

Wechseln Sie von devnet zu mainnet in Ihrer Konfiguration. Fertig!

Troubleshooting

API-Key wird nicht akzeptiert: Prüfen Sie ob der Key für das richtige Network (devnet/mainnet) ist.
Webhook kommt nicht an: URL muss öffentlich erreichbar sein. Nutzen Sie ngrok für lokales Testen.
Zahlung wird nicht erkannt: Prüfen Sie die Network-Einstellung und Wallet-Adresse.
QR-Code funktioniert nicht: Wallet-App muss Solana Pay unterstützen (Phantom, Solflare).