웹훅 목록

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

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

ℹ️

웹훅 설정 필요

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

Webhook

웹훅 타입 목록

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

subscription.requested_done

구독 신청 완료

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

subscription.approved

구독 승인

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

subscription.cancelled

구독 취소

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

order.done

주문 완료 / 구독주문 완료

일반/구독 주문이 완료되었을 때 전달됩니다. 일반 상품과 구독상품을 구분하는 방법은 "order_request_type" 필드가 subscription/item로 구분이 가능합니다.

order.cancelled

일반 / 구독주문 전체 금액 취소

일반 상품 / 구독회차 결제 주문 전체 금액이 취소되었을 때 전달됩니다.

order.partial_cancelled

일반 / 구독주문 부분 취소

일반 상품 / 구독회차 결제 주문이 부분 취소되었을 때 전달됩니다.

order.confirm_error

일반 / 구독주문 결제 오류

일반 상품 / 구독회차 결제 주문이 오류 혹은 결제 실패로 인해 승인되지 못했을 때 전달됩니다.

order.cancel_error

일반 / 구독주문 부분취소 혹은 전체취소 오류

일반 상품 / 구독회차 결제 부분취소 혹은 전체 취소 중 오류가 발생했을 때 전달됩니다.

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"
  }
}