PayWithSolana

API Documentation

REST API für Zahlungsintegration. Erstellen, abfragen und verwalten Sie Zahlungen programmatisch.

Authentication

API-Key im Header: Authorization: Bearer YOUR_API_KEY

Base URL

https://api.paywithsolana.de/v1

Rate Limits

100 Requests/Minute. Höhere Limits im Enterprise-Plan.

Endpoints

POST/payments
GET/payments/:id
GET/payments
POST/refunds
GET/shop
GET/terminals

Beispiel: Zahlung erstellen

cURL
curl -X POST \
  https://api.paywithsolana.de/v1/payments \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 25.99,
    "currency": "EUR",
    "description": "Order #12345"
  }'
Response
{
  "id": "pay_abc123",
  "status": "pending",
  "amount": 25.99,
  "currency": "EUR",
  "solana_pay_url": "solana:...",
  "qr_code_url": "https://...",
  "checkout_url": "https://...",
  "expires_at": "2026-04-04T12:00:00Z"
}

Webhooks

Konfigurieren Sie eine Webhook-URL in Ihren Shop-Einstellungen. Wir senden POST-Requests bei Statusänderungen:

payment.completed — Zahlung erfolgreich abgeschlossen

payment.failed — Zahlung fehlgeschlagen oder abgelaufen

refund.completed — Rückerstattung abgeschlossen

Webhooks werden mit HMAC-SHA256 signiert. Verifizieren Sie die Signatur im Header x-pws-signature.