--- title: "청구 오류: Subscriptions 문서 | Chargezen" description: "Chargezen에서 구독 청구가 실패할 수 있는 모든 사유와, 재시도 여부, 확인하는 곳, 갱신 결제를 받으려면 할 일을 정리했어요." url: "https://chargezen.com/ko/docs/subscriptions/charge-errors" lang: "ko" updated: "2026-10-18" --- Canonical URL: https://chargezen.com/ko/docs/subscriptions/charge-errors # 청구 오류 Chargezen에서 구독 청구가 실패할 수 있는 모든 사유와, 재시도 여부, 확인하는 곳, 갱신 결제를 받으려면 할 일을 정리했어요. 마지막 업데이트: 2026-10-18 갱신 청구가 실패하면 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에서 결제 대행사를 다시 켜세요. 문제가 해결되면 재시도가 다시 시작돼요. ### 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로 청구하세요. ### 품절 * **코드:** `insufficient_inventory, inventory_allocations_not_found` * **의미:** 주문에 든 제품을 구할 수 없어요. * **재시도:** 네. Dunning 일정에 따라 재시도해요. 고객에게 결제 실패를 알리지 않고, 고객의 재시도 횟수도 쓰지 않아요. * **할 일:** 제품을 다시 입고하거나 교체하세요. 재고가 돌아올 때까지 청구를 보류하려면 Inventory guard를 켜세요. ### 일시적인 Shopify 오류 * **코드:** `rate_limit, throttled, timeout, network_error, service_unavailable, transient_error, unexpected_error` * **의미:** Shopify가 바빴거나 잠시 응답하지 않았어요. * **재시도:** 네, 조용히 재시도해요. 고객의 재시도 횟수를 쓰지 않아요. 계속 반복되면 청구에 System error가 표시돼요. * **할 일:** 보통은 할 일이 없어요. 청구가 System error로 끝나면 Retry charge now로 재시도하세요. ### 그 밖의 코드 * **코드:** `Any other code Shopify sends` * **의미:** 고객 결제 문제로 처리해요. * **재시도:** 네, 고객 결제 문제와 똑같이 재시도해요. * **할 일:** 청구의 Last failure 메시지를 읽고, 위에서 맞는 해결 방법을 따르세요. 은행 결제 확인 은행이 고객에게 결제 확인을 요청할 때가 있어요. Chargezen이 Bank confirmation 이메일과 문자를 보내고, 구독의 **Payments** 섹션에서 확인 링크를 복사할 수도 있어요. ## 문제 해결 ### 청구에 System error가 표시돼요 일시적인 오류로 Chargezen이 청구를 끝내지 못했고, 주문도 만들어지지 않았어요. 청구를 열고 **Retry charge now**를 선택하세요. ### 같은 날 같은 코드로 청구가 많이 실패했어요 고객보다는 스토어나 Shopify 쪽 문제일 가능성이 커요. Shopify에서 결제 대행사를 확인한 다음 청구를 재시도하세요. ### 청구에 Retries ran out이 표시돼요 모든 재시도가 실패해서 최종 조치가 실행됐어요. 그래도 결제 정보 업데이트 링크를 보내고, 고객이 카드를 업데이트하면 주문을 청구할 수 있어요. ## 관련 문서 * [결제 실패 복구](https://chargezen.com/ko/subscriptions/failed-payment-recovery): Chargezen이 갱신 결제를 받는 방법이에요. * 용어집: [결제 거절 코드](https://chargezen.com/ko/glossary/decline-code), [비자발적 해지](https://chargezen.com/glossary/involuntary-churn), [결제 실패 관리](https://chargezen.com/glossary/dunning-management). ### 관련 문서 [ #### 결제 실패 재시도 일정과 최종 조치 ](https://chargezen.com/ko/docs/subscriptions/dunning)[ #### 구독 주문과 청구 In dunning 보기와 Failed 보기 ](https://chargezen.com/ko/docs/subscriptions/orders)[ #### 결제 수단과 통화 결제 정보 업데이트 링크 보내기 ](https://chargezen.com/ko/docs/subscriptions/payment-methods) 이 페이지가 도움이 되었나요? 도움이 더 필요하신가요? [고객 지원 문의](https://chargezen.com/docs/checkoutos/troubleshooting/support)