구독결제 웹훅

구독 결제 관련 이벤트가 발생할 때 전송되는 웹훅입니다.

구독 신청, 승인, 취소 및 회차별 결제 완료/실패 시점에 웹훅이 전달됩니다.

ℹ️

웹훅 활용

웹훅을 통해 구독 상태 변경을 실시간으로 감지하고, 서비스 제공 및 고객 알림을 자동화할 수 있습니다.

Webhook

웹훅 이벤트 선택

확인하고 싶은 웹훅 이벤트를 선택하세요.

Payload

페이로드 필드

subscription.requested_done 이벤트의 페이로드 필드입니다.

필드명

타입

설명

event

string

이벤트 타입 (subscription.requested_done)

timestamp

string

이벤트 발생 시간

data.order_subscription_id

string

구독 계약 고유 ID

data.order_number

string

주문 번호

data.user_id

string

사용자 ID

data.status

number

구독 상태 (1: 신청완료)

data.payment_method

string

결제 수단

data.total_price

number

총 결제 금액

data.products

array

구독 상품 목록

data.billing_cycle

string

결제 주기

data.total_duration

number

총 구독 기간 (회차)

data.service_start_at

string

서비스 시작일

Guide

처리 가이드

구독 신청 완료 처리

상품 설정에 따라 즉시 승인 또는 관리자 승인 대기 상태가 됩니다
status 필드를 확인하여 현재 상태를 파악하세요
즉시 승인인 경우 subscription.approved 웹훅이 바로 이어서 전송됩니다

구독 신청 완료

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