결제 재시도는 실패한 구독 갱신 결제를 점진적인 백오프 일정에 따라 자동으로 재시도합니다. 재시도가 성공하면 구독이 자동으로 재활성화됩니다. 고객의 행동이나 통합 작업이 필요하지 않습니다.
결제 재시도란?
구독 갱신 결제가 실패하면 구독은 보류 상태로 놓입니다. 결제 재시도를 활성화하면 Dodo Payments는 스마트 일정에 따라 고객의 기존 결제 수단을 자동으로 다시 청구하여 결제가 성공하거나 복구 창이 닫힐 때까지 진행합니다. 이 방식은 만료된 카드 보류, 충전 가능한 부적절한 자금, 일시적인 네트워크 오류 등으로 인한 임시 실패로 인한 수익 손실을 복구하며, 고객에게 이메일을 보내거나 업데이트를 요청하지 않습니다.결제 재시도는 구독 갱신 결제에만 적용됩니다. 첫 번째 결제(위임 설정), 일회성 결제, 계획 변경 요금 및 요구 시 요금은 이 기능으로 재시도되지 않습니다.
결제 재시도가 작동하는 방법
Retryability check
실패의 오류 코드를 검사합니다. 소프트 거절(부족한 자금, 일반 거절, 처리 또는 네트워크 오류 등)은 재시도가 가능합니다. 하드 거절은 결과가 변경되지 않으므로 재시도가 즉시 종료됩니다.
Scheduled retry
거절이 재시도가 가능하고 복구 창이 허용한다면, 다음 시도가 예약됩니다. 재시도는 고객의 기존 결제 수단을 상대로 오프세션에서 점진적인 백오프 일정에 따라 실행됩니다.
결제 재시도 구성
대시보드의 설정 → 복구에서 결제 재시도를 활성화하고 구성합니다.
| 설정 | 설명 | 기본값 |
|---|---|---|
| 결제 재시도 활성화 | 실패한 구독 갱신 결제를 자동으로 재시도하여 수익을 복구합니다. | 꺼짐 (옵트인) |
| 복구 창(일) | 실패한 결제를 포기하기 전에 재시도하는 기간. 1에서 30 사이여야 합니다. | 13 |
재시도 일정
재시도는 점진적으로 백오프합니다. 최대 8번의 시도가 이루어지며, 각 시도가 복구 창 내에 맞는 한 계속됩니다:| 시도 | 이전 시도 후 지연 | 실패 후 대략적인 시간 |
|---|---|---|
| 1 | 12시간 | 12시간 |
| 2 | 24시간 | 36시간 |
| 3 | 48시간 | ~3.5일 |
| 4 | 72시간 | ~6.5일 |
| 5 | 96시간 | ~10.5일 |
| 6 | 120시간 | ~15.5일 |
| 7 | 7일 | ~22.5일 |
| 8 | 7일 | ~29.5일 |
구독 상태 전환
| 이벤트 | 구독 상태 |
|---|---|
| 갱신 결제 실패 | active → on_hold |
| 재시도 시도 실패 | on_hold 유지 (창이 허용하면 다음 재시도 예약) |
| 재시도 시도 성공 | on_hold → active, 다음 청구 날짜 조정 |
| 복구 창 만료 | on_hold 유지 |
| 이벤트 | 트리거 |
|---|---|
subscription.on_hold | 갱신이 실패하고 구독이 보류 상태로 전환될 때 |
subscription.active | 재시도가 성공하고 구독이 재활성화될 때 |
Subscription Webhook Payloads
구독 라이프사이클 이벤트에 대한 전체 웹훅 페이로드 스키마를 확인하세요.
재시도 가능한 실패 대 비재시도 가능한 실패
| 실패 유형 | 예시 | 재시도 여부 |
|---|---|---|
| 소프트 거절 | 불충분한 자금, 일반 거절, 카드 제한 초과, 처리 오류, 네트워크 오류/시간 초과, 나중에 다시 시도하기 | 예 |
| 하드 거절 | 도난/분실 카드, 유효하지 않은 카드, 승인 거부, 계좌 폐쇄 및 기타 치명적 거절 | 아니요 — 체인이 즉시 종료됩니다 |
하드 거절을 재시도해도 결과는 변하지 않으므로 하드 거절을 관찰하면 재시도 체인이 종료됩니다. 이러한 경우 고객에게 결제 수단을 업데이트하도록 요청하기 위해 구독 징수와 결제 재시도를 함께 사용하세요.
결제 재시도와 징수
결제 재시도와 구독 징수는 상호 보완적인 복구 도구입니다:| 결제 재시도 | 구독 징수 | |
|---|---|---|
| 메커니즘 | 기존 결제 수단을 조용히 재청구합니다 | 고객에게 결제 수단 업데이트를 요청하는 이메일을 보냅니다 |
| 고객 행동 | 필요 없음 | 고객이 포털에서 결제 수단을 업데이트합니다 |
| 최적 사용 사례 | 자체 해결되는 임시/소프트 거절 | 교체가 필요한 만료되거나 잘못된 카드 |
관련 항목
Subscription Dunning
고객에게 결제 수단 업데이트를 요청하는 이메일 시퀀스.
Abandoned Cart Recovery
타겟 이메일을 통해 완료되지 않거나 실패한 일회성 체크아웃을 복구하세요.
Subscriptions
복구 플로우에 관련된 구독 상태를 이해하세요.
Subscription Webhooks
subscription.on_hold 및 subscription.active 이벤트에 반응하세요.