청구 오류: Subscriptions 문서

갱신 청구가 실패하면 Shopify가 오류 코드를 돌려줘요. Chargezen은 코드마다 그룹으로 분류하고, 그룹에 따라 재시도할지, 고객에게 알릴지, 내가 나서야 하는지가 정해져요. 이 페이지에서 코드와 해결 방법을 찾아보세요.

사유를 확인하는 곳

Subscriptions → Manage → Orders의 In dunning, Failed 보기에 있는 Last failure. Shopify의 메시지나 코드가 그대로 표시돼요.
청구 페이지. Last failure와 함께 “This charge failed. Chargezen retries it automatically on” 뒤에 날짜가 붙은 안내, 또는 고칠 내용과 함께 “Needs your action”이 표시돼요.
구독의 Logs. 알기 쉬운 문장으로 표시돼요(예: “Payment failed: Insufficient funds”).
Analytics → Dashboards → Order Errors. Errors by type에 묶여 표시돼요.

코드: card_declined, declined, expired_card, expired_payment_method, insufficient_funds, invalid_card, invalid_payment_method, payment_method_declined, payment_method_not_found, authentication_error, buyer_canceled_payment_method, fraud_suspected, invalid_customer_billing_agreement, paypal_error_general
의미: 은행이나 전자 지갑이 결제를 거절했거나, 저장된 결제 수단을 더는 쓸 수 없어요.
재시도: 네. Dunning 일정에 따라 고객 메시지와 함께 재시도해요. 모든 재시도가 실패하면 최종 조치가 실행돼요.
할 일: 고객이 쓸 수 있는 카드를 추가하도록 결제 정보 업데이트 링크를 보내세요. 잔액 부족이라면 나중의 재시도가 알아서 성공하는 경우가 많아요.

코드: payment_provider_is_not_enabled, payment_provider_not_enabled, payment_provider_disabled
의미: 스토어의 Shopify 결제 대행사가 꺼져 있어요.
재시도: 아니요. 청구에 Needs your action이 표시되고 내 조치를 기다려요.
할 일: Shopify에서 결제 대행사를 다시 켜세요. 문제가 해결되면 재시도가 다시 시작돼요.

코드: initiation_failed, invalid, contract_not_found, contract_paused, contract_terminated, contract_under_review, cycle_index_out_of_range, cycle_start_date_out_of_range, origin_time_before_contract_creation, origin_time_out_of_range, upcoming_cycle_limit_exceeded, billing_cycle_charge_before_expected_date
의미: Shopify가 청구 요청을 거부해서 결제를 시도하지 않았어요.
재시도: 아니요. 청구에 Needs your action이 표시돼요.
할 일: Shopify에서 구독을 확인한 다음(예: 거기서 일시 중지되거나 끝났는지), Chargezen에서 Process order now로 청구하세요.

코드: rate_limit, throttled, timeout, network_error, service_unavailable, transient_error, unexpected_error
의미: Shopify가 바빴거나 잠시 응답하지 않았어요.
재시도: 네, 조용히 재시도해요. 고객의 재시도 횟수를 쓰지 않아요. 계속 반복되면 청구에 System error가 표시돼요.
할 일: 보통은 할 일이 없어요. 청구가 System error로 끝나면 Retry charge now로 재시도하세요.

은행 결제 확인

은행이 고객에게 결제 확인을 요청할 때가 있어요. Chargezen이 Bank confirmation 이메일과 문자를 보내고, 구독의 Payments 섹션에서 확인 링크를 복사할 수도 있어요.

일시적인 오류로 Chargezen이 청구를 끝내지 못했고, 주문도 만들어지지 않았어요. 청구를 열고 Retry charge now를 선택하세요.

고객보다는 스토어나 Shopify 쪽 문제일 가능성이 커요. Shopify에서 결제 대행사를 확인한 다음 청구를 재시도하세요.

모든 재시도가 실패해서 최종 조치가 실행됐어요. 그래도 결제 정보 업데이트 링크를 보내고, 고객이 카드를 업데이트하면 주문을 청구할 수 있어요.