購入Webhook

POST/api/webhooks/purchase/:contestId

Webhook Secret

ストアや決済プラットフォームからの購入イベントを受け取り、コンテスト参加者に自動でポイントを付与します。

エンドポイント

text

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

パスパラメータ

contestIdstring required

一意のコンテスト識別子

リクエストボディ

emailstring required

購入者のメールアドレス

orderIdstring required

システム内の一意の注文識別子

amountnumber required

購入金額（正の数）

currencystring

通貨コード（デフォルト: 'USD'）

リクエスト例

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)

レスポンス

json

{
  "success": true,
  "data": {
    "purchaseId": "purchase_xyz789",
    "entryId": "entry_abc123",
    "pointsAwarded": 80,
    "alreadyExists": false,
    "message": "購入が正常に記録されました"
  }
}

重複処理

同じ orderId が複数回送信された場合、Webhookは成功レスポンスを返しますが、重複した購入は作成されず、追加ポイントも付与されません：

json

{
  "success": true,
  "data": {
    "purchaseId": "purchase_xyz789",
    "entryId": "entry_abc123",
    "pointsAwarded": 0,
    "alreadyExists": true,
    "message": "購入は既に記録されています"
  }
}

対応ストア連携

Shopify

ShopifyのWebhook設定でコンテストのWebhook URLを使用してください：

Shopify管理画面 → 設定 → 通知 → Webhook
orders/paid のWebhookを追加
URLを https://blitzrocket.com/api/webhooks/purchase/{contestId} に設定

Blitz Rocketは専用のShopifyリファラルWebhookもサポートしています：

text

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

Stripe

StripeのWebhook設定でコンテストのWebhook URLを使用してください：

Stripeダッシュボード → 開発者 → Webhook
checkout.session.completed のエンドポイントを追加
URLを https://blitzrocket.com/api/webhooks/referral/stripe/{contestId} に設定

セットアップガイド

Blitz Rocketダッシュボードでコンテストに移動
コンテスト設定で 購入追跡 を有効化
ポイントルールを設定（例：1ドルごとに1ポイント）
Webhook URLをコピーし、ストアや決済プラットフォームに設定
小額の購入で連携をテストしてください