메인 콘텐츠로 건너뛰기
Dodo Payments는 거래, 구독, 환불, 분쟁 및 라이선스 키 관리와 관련된 중요한 이벤트에 대한 실시간 웹훅 알림을 제공합니다. 아래는 이러한 이벤트에 대한 자세한 가이드로, 명확성을 위해 분류되어 있으며, 구현 팁과 고려 사항이 포함되어 있습니다.

결제 이벤트

Event NameEvent TypeDescription
Payment Succeededpayment.succeeded결제가 성공적으로 처리되면 트리거됩니다.
Payment Failedpayment.failed오류, 거절된 카드 또는 기타 문제로 결제 시도가 실패하면 발생합니다.
Payment Processingpayment.processing결제가 현재 처리 중임을 나타냅니다.
Payment Cancelledpayment.cancelled결제가 완료되기 전에 취소되면 트리거됩니다.

환불 이벤트

Event NameEvent TypeDescription
Refund Succeededrefund.succeeded환불이 성공적으로 처리되면 트리거됩니다.
Refund Failedrefund.failed처리 오류 또는 기타 문제로 환불 시도가 실패하면 발생합니다.

분쟁 이벤트

Event NameEvent TypeDescription
Dispute Openeddispute.opened고객이 분쟁을 시작하면 트리거됩니다.
Dispute Expireddispute.expired분쟁이 해결 없이 만료되었음을 나타냅니다.
Dispute Accepteddispute.accepted가맹점이 분쟁을 수락하면 트리거됩니다.
Dispute Cancelleddispute.cancelled고객 또는 시스템에 의해 분쟁이 취소되면 발생합니다.
Dispute Challengeddispute.challenged가맹점이 분쟁에 이의를 제기하면 트리거됩니다.
Dispute Wondispute.won가맹점이 분쟁에서 승소했음을 나타냅니다.
Dispute Lostdispute.lost가맹점이 분쟁에서 패배하면 발생합니다.

구독 이벤트

Event NameEvent TypeDescription
Subscription Activesubscription.active구독이 이제 활성화되어 반복 청구가 예정되어 있음을 나타냅니다.
Subscription Updatedsubscription.updated구독 필드가 업데이트되면(폴링 없이 실시간 동기화) 트리거됩니다.
Subscription On Holdsubscription.on_hold갱신 실패로 인해 구독이 일시 중지되면 트리거됩니다.
Subscription Renewedsubscription.renewed구독이 성공적으로 갱신되면 발생합니다.
Subscription Plan Changedsubscription.plan_changed구독이 업그레이드, 다운그레이드되거나 다른 애드온으로 수정되면 트리거됩니다.
Subscription Cancelledsubscription.cancelled가맹점 또는 고객이 구독을 취소하면 트리거됩니다.
Subscription Failedsubscription.failed구독 실패를 나타냅니다. 이는 mandate를 생성할 수 없었음을 의미합니다.
Subscription Expiredsubscription.expired구독이 기간 종료로 만료되면 트리거됩니다.

라이선스 키 이벤트

Event NameEvent TypeDescription
License Key Createdlicense_key.created제품에 대한 새 라이선스 키가 생성되면 트리거됩니다.

신용 이벤트

이벤트 이름이벤트 유형설명
신용이 추가됨credit.added신용이 고객에게 부여될 때 트리거됩니다(구독, 일회성, 애드온 또는 API).
신용이 차감됨credit.deducted사용 또는 수동 차감으로 신용이 소비될 때 발생합니다.
신용이 만료됨credit.expired구성된 만료 기간 이후 사용되지 않은 신용이 만료될 때 트리거됩니다.
신용이 이월됨credit.rolled_over사용되지 않은 신용이 사이클 종료 시 새 부여로 이월될 때 발생합니다.
이월이 소멸됨credit.rollover_forfeited최대 이월 횟수에 도달하여 신용이 소멸될 때 트리거됩니다.
초과 요금이 부과됨credit.overage_charged잔액이 0보다 적을 때 사용에 대해 초과 요금이 적용되면 발생합니다.
수동 조정credit.manual_adjustment수동으로 신용 또는 차감 조정이 이루어지면 트리거됩니다.
잔액 부족credit.balance_low신용 잔액이 구성된 임계값 아래로 떨어지면 트리거됩니다.
이 웹후크 이벤트는 상인에게 운영을 효과적으로 관리하는 데 필요한 중요한 업데이트를 제공하도록 설계되었습니다. 원활하고 안정적인 기능을 보장하려면 웹후크 통합에서 관련 이벤트 각각에 대해 견고한 처리기를 구현하세요.