구매 웹훅

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가 여러 번 전송되면, 웹훅은 성공 응답을 반환하지만 중복 구매를 생성하거나 추가 포인트를 부여하지 않습니다:

json

{
  "success": true,
  "data": {
    "purchaseId": "purchase_xyz789",
    "entryId": "entry_abc123",
    "pointsAwarded": 0,
    "alreadyExists": true,
    "message": "구매가 이미 기록되었습니다"
  }
}

지원되는 상점 통합

Shopify

Shopify의 웹훅 설정에서 대회 웹훅 URL을 사용하세요:

Shopify 관리자 → 설정 → 알림 → 웹훅으로 이동
orders/paid 웹훅 추가
URL을 https://blitzrocket.com/api/webhooks/purchase/{contestId}로 설정

Blitz Rocket은 또한 전용 Shopify 추천 웹훅을 지원합니다:

text

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

Stripe

Stripe의 웹훅 설정에서 대회 웹훅 URL을 사용하세요:

Stripe 대시보드 → 개발자 → 웹훅으로 이동
checkout.session.completed 엔드포인트 추가
URL을 https://blitzrocket.com/api/webhooks/referral/stripe/{contestId}로 설정

설정 가이드

Blitz Rocket 대시보드에서 대회로 이동
대회 설정에서 구매 추적 활성화
포인트 규칙 구성 (예: 1달러당 1포인트)
웹훅 URL을 복사하여 상점/결제 플랫폼에 설정
소액 구매로 통합 테스트 수행