Aankoop Webhook

POST/api/webhooks/purchase/:contestId

Webhook Secret

Ontvang aankoopgebeurtenissen van je winkel of betalingsplatform om automatisch punten toe te kennen aan wedstrijddeelnemers.

Endpoint

text

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

Padparameters

contestIdstring required

De unieke wedstrijdidentificatie

Verzoek Body

emailstring required

E-mailadres van de koper

orderIdstring required

Unieke orderidentificatie uit jouw systeem

amountnumber required

Aankoopbedrag (positief getal)

currencystring

Valutacode (standaard: 'USD')

Verzoek

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)

Antwoord

json

{
  "success": true,
  "data": {
    "purchaseId": "purchase_xyz789",
    "entryId": "entry_abc123",
    "pointsAwarded": 80,
    "alreadyExists": false,
    "message": "Aankoop succesvol geregistreerd"
  }
}

Dubbele Verwerking

Als dezelfde orderId meerdere keren wordt verzonden, zal de webhook een succesrespons teruggeven maar geen dubbele aankoop aanmaken of extra punten toekennen:

json

{
  "success": true,
  "data": {
    "purchaseId": "purchase_xyz789",
    "entryId": "entry_abc123",
    "pointsAwarded": 0,
    "alreadyExists": true,
    "message": "Aankoop al geregistreerd"
  }
}

Ondersteunde Winkelintegraties

Shopify

Gebruik je wedstrijd webhook-URL in de webhook-instellingen van Shopify:

Ga naar Shopify Admin → Instellingen → Meldingen → Webhooks
Voeg een webhook toe voor orders/paid
Stel de URL in op https://blitzrocket.com/api/webhooks/purchase/{contestId}

Blitz Rocket ondersteunt ook de speciale Shopify referral webhook op:

text

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

Stripe

Gebruik je wedstrijd webhook-URL in de webhook-instellingen van Stripe:

Ga naar Stripe Dashboard → Developers → Webhooks
Voeg een endpoint toe voor checkout.session.completed
Stel de URL in op https://blitzrocket.com/api/webhooks/referral/stripe/{contestId}

Installatiehandleiding

Navigeer naar je wedstrijd in het Blitz Rocket dashboard
Schakel Aankooptracking in de wedstrijdinstellingen in
Configureer puntregels (bijv. 1 punt per uitgegeven dollar)
Kopieer je webhook-URL en configureer deze in je winkel/betalingsplatform
Test met een kleine aankoop om de integratie te verifiëren