Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
Dodo Payments는 거래, 구독, 환불, 분쟁 및 라이선스 키 관리와 관련된 중요한 이벤트에 대한 실시간 웹훅 알림을 제공합니다. 아래는 이러한 이벤트에 대한 자세한 가이드로, 명확성을 위해 분류되어 있으며, 구현 팁과 고려 사항이 포함되어 있습니다.
결제 이벤트
| Event Name | Event Type | Description |
|---|
| Payment Succeeded | payment.succeeded | 결제가 성공적으로 처리되면 트리거됩니다. |
| Payment Failed | payment.failed | 오류, 거절된 카드 또는 기타 문제로 결제 시도가 실패하면 발생합니다. |
| Payment Processing | payment.processing | 결제가 현재 처리 중임을 나타냅니다. |
| Payment Cancelled | payment.cancelled | 결제가 완료되기 전에 취소되면 트리거됩니다. |
환불 이벤트
| Event Name | Event Type | Description |
|---|
| Refund Succeeded | refund.succeeded | 환불이 성공적으로 처리되면 트리거됩니다. |
| Refund Failed | refund.failed | 처리 오류 또는 기타 문제로 환불 시도가 실패하면 발생합니다. |
분쟁 이벤트
| Event Name | Event Type | Description |
|---|
| Dispute Opened | dispute.opened | 고객이 분쟁을 시작하면 트리거됩니다. |
| Dispute Expired | dispute.expired | 분쟁이 해결 없이 만료되었음을 나타냅니다. |
| Dispute Accepted | dispute.accepted | 가맹점이 분쟁을 수락하면 트리거됩니다. |
| Dispute Cancelled | dispute.cancelled | 고객 또는 시스템에 의해 분쟁이 취소되면 발생합니다. |
| Dispute Challenged | dispute.challenged | 가맹점이 분쟁에 이의를 제기하면 트리거됩니다. |
| Dispute Won | dispute.won | 가맹점이 분쟁에서 승소했음을 나타냅니다. |
| Dispute Lost | dispute.lost | 가맹점이 분쟁에서 패배하면 발생합니다. |
구독 이벤트
| Event Name | Event Type | Description |
|---|
| Subscription Active | subscription.active | 구독이 이제 활성화되어 반복 청구가 예정되어 있음을 나타냅니다. |
| Subscription Updated | subscription.updated | 구독 필드가 업데이트되면(폴링 없이 실시간 동기화) 트리거됩니다. |
| Subscription On Hold | subscription.on_hold | 갱신 실패로 인해 구독이 일시 중지되면 트리거됩니다. |
| Subscription Renewed | subscription.renewed | 구독이 성공적으로 갱신되면 발생합니다. |
| Subscription Plan Changed | subscription.plan_changed | 구독이 업그레이드, 다운그레이드되거나 다른 애드온으로 수정되면 트리거됩니다. |
| Subscription Cancelled | subscription.cancelled | 가맹점 또는 고객이 구독을 취소하면 트리거됩니다. |
| Subscription Failed | subscription.failed | 구독 실패를 나타냅니다. 이는 mandate를 생성할 수 없었음을 의미합니다. |
| Subscription Expired | subscription.expired | 구독이 기간 종료로 만료되면 트리거됩니다. |
라이선스 키 이벤트
| Event Name | Event Type | Description |
|---|
| License Key Created | license_key.created | 제품에 대한 새 라이선스 키가 생성되면 트리거됩니다. |
권한 부여 이벤트
| 이벤트 이름 | 이벤트 유형 | 설명 |
|---|
| Grant Created | entitlement_grant.created | 고객에게 새로운 권한 부여가 생성됩니다. 라이선스 키 부여는 delivered에서 도착합니다. OAuth 기반 부여(Discord, GitHub, Notion)는 pending에서 도착합니다. |
| Grant Delivered | entitlement_grant.delivered | 권한 이행이 완료되었습니다 — 라이선스 키 발급, 파일 링크 해결, 또는 플랫폼 접근이 허가되었습니다. |
| Grant Failed | entitlement_grant.failed | 권한 이행에 실패했습니다; error_code 및 error_message를 확인하십시오. |
| Grant Revoked | entitlement_grant.revoked | 접근이 철회 되었습니다; revocation_reason를 확인하십시오 (구독 상태, 환불, 계획 변경, 또는 수동). |
revocation_reason 참조는 Entitlement Grant Webhooks를 참조하세요.
크레딧 이벤트
| 이벤트 이름 | 이벤트 유형 | 설명 |
|---|
| Credit Added | credit.added | 고객에게 크레딧이 부여될 때 (구독, 일회성, 애드온 또는 API) 트리거됩니다. |
| Credit Deducted | credit.deducted | 사용이나 수동 차변을 통해 크레딧이 소비될 때 발생합니다. |
| Credit Expired | credit.expired | 설정된 만료 기간 후 사용되지 않은 크레딧이 만료될 때 트리거됩니다. |
| Credit Rolled Over | credit.rolled_over | 사용하지 않은 크레딧이 주기가 끝날 때 새 부여로 이월될 때 발생합니다. |
| Rollover Forfeited | credit.rollover_forfeited | 최대 이월 횟수에 도달하여 크레딧이 포기될 때 트리거됩니다. |
| Overage Charged | credit.overage_charged | 잔액이 0 보다 클 때 사용량 초과 요금이 적용될 때 발생합니다. |
| Manual Adjustment | credit.manual_adjustment | 수동 크레딧 또는 차변 조정이 이루어질 때 트리거됩니다. |
| Balance Low | credit.balance_low | 잔액이 설정된 임계값 이하로 떨어질 때 트리거됩니다. |
복구 이벤트
| 이벤트 이름 | 이벤트 유형 | 설명 |
|---|
| Abandoned Checkout Detected | abandoned_checkout.detected | 60분 후 완료되지 않거나 실패한 결제가 감지될 때 트리거됩니다. |
| Abandoned Checkout Recovered | abandoned_checkout.recovered | 고객이 복구 링크를 통해 결제를 완료할 때 발생합니다. |
차징 이벤트
| 이벤트 이름 | 이벤트 유형 | 설명 |
|---|
| Dunning Started | dunning.started | 보류되거나 취소된 구독에 대해 차징 시도가 시작될 때 트리거됩니다. |
| Dunning Recovered | dunning.recovered | 고객이 결제 방법을 업데이트하고 그에 따른 청구가 성공할 때 발생합니다. |
