이벤트 타입

이벤트	트리거	data.object 타입
payment.created	Payment 생성	Payment
payment.pending	결제의 멤풀 트랜잭션 감지	Payment
payment.succeeded	결제 컨펌됨 (네트워크 finality 도달)	Payment
payment.failed	온체인 실패 또는 되돌림	Payment
payment.expired	결제 없이 expires_at 경과	Payment
checkout.session.completed	Hosted Checkout 결제 컨펌됨	CheckoutSession
checkout.session.expired	결제 없이 세션 만료	CheckoutSession
qr.session.completed	QR Session 결제 컨펌됨	QRSession
refund.created	환불 시작	Refund
refund.succeeded	환불 온체인 컨펌	Refund
refund.failed	환불 발송 실패 (예: 유동성 부족)	Refund

순서 보장

ParaSta 는 동일 결제에 대해 payment.succeeded 가 payment.pending 이후 에 발송됨을 보장합니다. 그 외에는 결제 간이나 객체 타입 간 순서를 보장하지 않습니다.

이벤트 구독

웹훅 엔드포인트 생성 시 enabled_events 를 지정합니다.

{
  "url": "https://your-site.com/webhook",
  "enabled_events": ["checkout.session.completed", "payment.failed", "refund.succeeded"]
}

지정한 이벤트만 수신합니다. 모든 이벤트(현재·미래)를 구독하려면 ["*"] 를 사용하세요.