Kauf-Webhook

POST/api/webhooks/purchase/:contestId

Webhook Secret

Empfangen Sie Kaufereignisse von Ihrem Shop oder Ihrer Zahlungsplattform, um automatisch Punkte an Wettbewerbsteilnehmer zu vergeben.

Endpunkt

text

POST https://blitzrocket.com/api/webhooks/purchase/:contestId

Pfadparameter

contestIdstring required

Die eindeutige Wettbewerbskennung

Anfragekörper

emailstring required

E-Mail-Adresse des Käufers

orderIdstring required

Eindeutige Bestellkennung aus Ihrem System

amountnumber required

Kaufbetrag (positive Zahl)

currencystring

Währungscode (Standard: 'USD')

Anfrage

bash

curl -X POST https://blitzrocket.com/api/webhooks/purchase/clx1abc123 \
  -H "Content-Type: application/json" \
  -d '{
    "email": "buyer@example.com",
    "orderId": "order-12345",
    "amount": 79.99,
    "currency": "USD"
  }'

javascript

const contestId = "clx1abc123";
const response = await fetch(
  `https://blitzrocket.com/api/webhooks/purchase/${contestId}`,
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      email: "buyer@example.com",
      orderId: "order-12345",
      amount: 79.99,
      currency: "USD",
    }),
  }
);

const data = await response.json();
console.log(data);

python

import requests

contest_id = "clx1abc123"
response = requests.post(
    f"https://blitzrocket.com/api/webhooks/purchase/{contest_id}",
    json={
        "email": "buyer@example.com",
        "orderId": "order-12345",
        "amount": 79.99,
        "currency": "USD"
    }
)

data = response.json()
print(data)

Antwort

json

{
  "success": true,
  "data": {
    "purchaseId": "purchase_xyz789",
    "entryId": "entry_abc123",
    "pointsAwarded": 80,
    "alreadyExists": false,
    "message": "Kauf erfolgreich erfasst"
  }
}

Umgang mit Duplikaten

Wenn dieselbe orderId mehrfach gesendet wird, gibt der Webhook eine Erfolgsmeldung zurück, erstellt jedoch keinen doppelten Kauf und vergibt keine zusätzlichen Punkte:

json

{
  "success": true,
  "data": {
    "purchaseId": "purchase_xyz789",
    "entryId": "entry_abc123",
    "pointsAwarded": 0,
    "alreadyExists": true,
    "message": "Kauf bereits erfasst"
  }
}

Unterstützte Shop-Integrationen

Shopify

Verwenden Sie Ihre Wettbewerbs-Webhook-URL in den Shopify-Webhook-Einstellungen:

Gehen Sie zu Shopify Admin → Einstellungen → Benachrichtigungen → Webhooks
Fügen Sie einen Webhook für orders/paid hinzu
Setzen Sie die URL auf https://blitzrocket.com/api/webhooks/purchase/{contestId}

Blitz Rocket unterstützt außerdem den dedizierten Shopify-Referral-Webhook unter:

text

POST /api/webhooks/referral/shopify/:contestId

Stripe

Verwenden Sie Ihre Wettbewerbs-Webhook-URL in den Stripe-Webhook-Einstellungen:

Gehen Sie zu Stripe Dashboard → Entwickler → Webhooks
Fügen Sie einen Endpunkt für checkout.session.completed hinzu
Setzen Sie die URL auf https://blitzrocket.com/api/webhooks/referral/stripe/{contestId}

Einrichtungsanleitung

Navigieren Sie in Ihrem Blitz Rocket Dashboard zu Ihrem Wettbewerb
Aktivieren Sie Kaufverfolgung in den Wettbewerbseinstellungen
Konfigurieren Sie Punktregeln (z.B. 1 Punkt pro ausgegebenem Dollar)
Kopieren Sie Ihre Webhook-URL und konfigurieren Sie sie in Ihrem Shop/Zahlungsplattform
Testen Sie mit einem kleinen Kauf, um die Integration zu überprüfen