Webhook d'achat

POST/api/webhooks/purchase/:contestId

Webhook Secret

Recevez les événements d'achat depuis votre boutique ou plateforme de paiement pour attribuer automatiquement des points aux participants du concours.

Point de terminaison

text

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

Paramètres de chemin

contestIdstring required

L'identifiant unique du concours

Corps de la requête

emailstring required

Adresse e-mail de l'acheteur

orderIdstring required

Identifiant unique de la commande dans votre système

amountnumber required

Montant de l'achat (nombre positif)

currencystring

Code de la devise (par défaut : 'USD')

Requête

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)

Réponse

json

{
  "success": true,
  "data": {
    "purchaseId": "purchase_xyz789",
    "entryId": "entry_abc123",
    "pointsAwarded": 80,
    "alreadyExists": false,
    "message": "Achat enregistré avec succès"
  }
}

Gestion des doublons

Si le même orderId est envoyé plusieurs fois, le webhook renverra une réponse de succès mais ne créera pas d'achat en double ni n'attribuera de points supplémentaires :

json

{
  "success": true,
  "data": {
    "purchaseId": "purchase_xyz789",
    "entryId": "entry_abc123",
    "pointsAwarded": 0,
    "alreadyExists": true,
    "message": "Achat déjà enregistré"
  }
}

Intégrations de boutique prises en charge

Shopify

Utilisez votre URL de webhook de concours dans les paramètres de webhook de Shopify :

Allez dans Admin Shopify → Paramètres → Notifications → Webhooks
Ajoutez un webhook pour orders/paid
Définissez l'URL sur https://blitzrocket.com/api/webhooks/purchase/{contestId}

Blitz Rocket prend également en charge le webhook de parrainage dédié Shopify à l'adresse :

text

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

Stripe

Utilisez votre URL de webhook de concours dans les paramètres de webhook de Stripe :

Allez dans Tableau de bord Stripe → Développeurs → Webhooks
Ajoutez un point de terminaison pour checkout.session.completed
Définissez l'URL sur https://blitzrocket.com/api/webhooks/referral/stripe/{contestId}

Guide d'installation

Rendez-vous sur votre concours dans le tableau de bord Blitz Rocket
Activez le Suivi des achats dans les paramètres du concours
Configurez les règles de points (ex. : 1 point par dollar dépensé)
Copiez votre URL de webhook et configurez-la dans votre boutique/plateforme de paiement
Testez avec un petit achat pour vérifier l'intégration