결제 실패: Subscriptions 문서

예정된 구독 청구가 실패하면 Chargezen은 일정에 따라 다시 시도하고, 고객에게 알리고, 모든 재시도가 실패하면 내가 정한 최종 조치를 적용해요. Subscriptions → Billing & automation → Dunning의 Failed payment retries에서 설정하세요.

재시도 설정하기

Dunning 열기

Subscriptions → Billing & automation → Dunning으로 가세요.

재시도 정하기

Retry failed payments automatically를 켜 둔 채 Retries after a failed charge와 Days between retries를 고르거나 기본값을 그대로 두세요.

최종 조치 정하기

If every retry fails에서 구독을 어떻게 할지 고르세요.

요약 확인하고 저장하기

필드 아래 줄에 내가 고른 내용이 다시 표시돼요. 예를 들어 “A failed charge is retried 4 times, 1, 3, 5, 7 days apart.” 같은 문구예요. 변경 사항을 저장하세요.

설정과 기본값

설정	선택지	기본값	하는 일
Retry failed payments automatically	체크박스	켜짐	끄면 실패한 결제를 재시도하지 않고 최종 조치를 바로 적용해요.
Retries after a failed charge	기본값(4) 또는 1~10	4	예정된 청구가 실패한 뒤 Chargezen이 몇 번 더 시도할지 정해요.
Days between retries	기본값(1, 3, 5, 7일) 또는 1~14일	1일, 3일, 5일, 그다음 7일	재시도 전마다 기다리는 기간이에요. 네 번째 이후의 재시도는 7일씩 기다려요.
If every retry fails	Cancel subscription, Pause subscription, Skip the failed order, Keep active for manual handling	Keep active for manual handling	마지막 재시도가 실패했을 때 구독을 어떻게 할지 정해요.

예정된 청구가 실패하면 주기가 시작되고, 그다음 내가 정한 횟수만큼 재시도해요. 재시도가 3회라면 최종 조치가 적용되기 전까지 실패한 청구는 모두 4번이에요.

대기 기간은 가장 최근 실패부터 세요. 기본값이라면 재시도는 첫 실패 후 1일, 4일, 9일, 16일째에 이루어져요.

결제가 복구되면 다음 청구는 결제가 성공한 날부터 세거나, 원하면 원래 청구일부터 세요. Subscription settings → Billing의 Post-dunning billing date로 바꾸세요. 청구 일정을 참고하세요.

고객이 받는 메시지

결제 실패 메시지는 기본 워크플로이므로 Subscriptions → Billing & automation → Workflow automations에서 편집하거나, 단계를 추가하거나, Draft로 바꿀 수 있어요.

첫 실패 시 Card declined email과 Card declined text
재시도가 다시 실패할 때마다 Payment retry email
재시도가 바닥나면 최종 조치에 맞춰 Payment failed: cancelled, Payment failed: paused, Payment failed: final notice 중 하나
재시도가 성공하면 Payment recovered text
은행이 고객에게 결제 확인을 요청하면 Bank confirmation email과 text

직접 만들려면 트리거 Subscription payment failed (first attempt), Subscription payment failed (in dunning), Subscription payment failed (last attempt), Subscription payment recovered (after a failed payment)를 쓰세요. 조건 Payment retries ended by로 해지, 일시 중지, 건너뛰기, 유지를 구분해요. 수동 청구와 고객 포털에서 시작한 청구의 실패도 같은 경로를 따라요.

주기가 끝나는 방식

Recovered: 결제가 성공하면 주기가 끝나고 실패 상태가 지워져요.
Retries ran out: 모든 재시도가 실패해서 최종 조치가 실행됐어요. Orders → Failed에서 찾을 수 있어요.

재시도 횟수를 쓰지 않는 실패

Shopify 결제 대행사가 비활성화된 것 같은 스토어 설정 문제와, 시도하기도 전에 Shopify가 거부한 청구는 재시도를 멈추고, 고칠 때까지 Needs your action을 표시해요.
시간 초과 같은 일시적인 Shopify 오류는 조용히 재시도해요. 고객의 재시도 횟수에 들어가지 않고 고객에게 알리지도 않아요. 계속 반복되면 청구에 System error가 표시돼요.
품절 제품은 고객에게 결제 실패를 알리지 않고 재시도해요.

모든 사유와 해결 방법은 청구 오류를 참고하세요.

재시도 끄기

자동 재시도를 끄면 첫 청구가 실패할 때 카드 거절 안내를 보내고 최종 조치를 바로 적용해요.

복구한 매출 확인하기

Subscriptions → Analytics → Dashboards → Order Errors를 여세요. Payment error recovery에 결제 오류, 복구된 매출, 복구율이 표시되고, 이어서 유형별 오류와 재시도 성과가 나와요. 분석 대시보드를 참고하세요.

문제 해결

고객이 결제 실패 안내를 받은 적이 없다고 해요

Workflow automations에서 Card declined 워크플로가 Draft가 아니라 Active인지 확인하세요. 그런 다음 구독의 Logs에서 Notifications 필터로 무엇이 발송됐는지 확인하세요.

모든 재시도가 실패했는데도 구독이 활성 상태예요

기본 최종 조치가 Keep active for manual handling이에요. If every retry fails를 해지, 일시 중지, 건너뛰기 중 하나로 바꾸세요.

청구를 직접 재시도할 수 있나요?

네. Orders → In dunning에서 청구를 열고 Retry charge now를 선택하거나, 먼저 Send payment update link로 고객에게 링크를 보내세요.

결제 실패 복구: Chargezen이 갱신 결제를 받는 방법이에요.
용어집: 결제 실패 관리, 비자발적 해지, 결제 거절 코드.

결제 실패