웹훅 목록

부트페이 커머스에서 발생하는 이벤트를 실시간으로 수신할 수 있는 웹훅 목록입니다.

각 웹훅은 설정된 URL로 POST 요청으로 전송됩니다.

ℹ️

웹훅 설정 필요

웹훅을 수신하려면 먼저 관리자 페이지에서 웹훅 URL을 설정해야 합니다.웹훅 설정 가이드 →

Webhook

웹훅 타입 목록

부트페이에서 지원하는 웹훅 이벤트 타입입니다. 우측에서 각 웹훅의 페이로드를 확인할 수 있습니다.

subscription.requested_done

구독 신청 완료

구독 결제 신청 요청이 완료되었을 때 전달됩니다.

subscription.approved

구독 승인

구독 신청이 계약완료 및 승인되었을 때 전달됩니다.

subscription.canceled

구독 취소

구독이 취소되었을 때 전달됩니다.

subscription.payment.done

구독 결제 완료

구독 회차 결제가 완료되었을 때 전달됩니다.

subscription.payment.failed

구독 결제 실패

구독 회차 결제가 실패했을 때 전달됩니다.

order.done

주문 완료

일반 주문이 완료되었을 때 전달됩니다.

order.canceled

주문 취소

주문이 취소되었을 때 전달됩니다.

Payload

공통 필드

모든 웹훅에 포함되는 공통 필드입니다.

필드명

타입

설명

event

string

웹훅 이벤트 타입

timestamp

string

이벤트 발생 시간 (ISO 8601)

data

object

이벤트 관련 데이터

Settings

재시도 정책

웹훅 전송 실패 시 재시도 정책입니다.

재시도 횟수

최대 25회 (설정 가능)

재시도 간격

지수 백오프 (1분, 2분, 4분, ...)

성공 응답

HTTP 200 응답 시 성공 처리

Content-Type

application/json (설정 가능)

구독 신청 완료

{
  "event": "subscription.requested_done",
  "timestamp": "2025-06-25T10:30:00Z",
  "data": {
    "order_subscription_id": "685b7b10b0eacea5cd974a93",
    "order_number": "25062561922007230139",
    "user_id": "67c9428f7b47af25bee631e7",
    "status": 1,
    "payment_method": "card",
    "total_price": 10000,
    "products": [
      {
        "product_id": "6858fe779ee6691f52f21e90",
        "name": "구독상품",
        "price": 10000,
        "quantity": 1
      }
    ],
    "billing_cycle": "monthly",
    "total_duration": 12,
    "service_start_at": "2025-06-25T00:00:00Z"
  }
}