결제 수단 및 동의

구독은 카드 결제 수단만 지원합니다. 정기 청구 동의와 기존 구독의 카드 업데이트 방식을 설명합니다.

동의가 필요한 이유

갱신은 고객이 카드를 입력하거나 인증하지 않아도 자동 청구됩니다. 이를 위해 Tokenz는 판매자 주도 거래(MIT) 동의를 사용합니다. 고객이 처음 구독 카드를 제공할 때 이후 청구 권한을 기록합니다. 모든 후속 갱신과 미납 재시도는 저장된 동의를 이용한 MIT로 처리되어 매번 카드 입력이나 3D Secure(3DS) 인증을 요구하지 않습니다.

구독에 카드를 처음 연결할 때 Tokenz 호스팅 흐름에서 자동으로 동의를 받습니다.

체험 없음: 초기 결제 과정에서 받습니다.
체험 있음: 초기 청구가 없으므로 체험 시작 시 받습니다.
이후 카드 업데이트: 아래 흐름으로 새 카드에 대해 다시 받습니다.

결제 수단 업데이트

체험, 활성, 미납 상태에서 언제든 카드를 업데이트할 수 있습니다. 예를 들어 유효기간 만료 전이나 갱신 결제 실패 복구 시 사용할 수 있습니다. 구독 생성 시 결제 페이지로 이동하듯 해당 구독의 Tokenz 호스팅 결제 수단 업데이트 화면으로 고객을 이동시킵니다.

절차는 다음과 같습니다.

해당 구독의 호스팅 화면으로 이동합니다.
새 카드를 입력하고 카드사가 요구하면 3D Secure 인증을 완료합니다.
Tokenz가 새 카드의 동의 기록을 생성합니다.
새 카드의 정기 청구 동의가 완료되면 즉시 새 카드로 교체합니다. 동의를 받지 못하면 기존 카드를 유지합니다.
업데이트가 확인되면 subscription.payment_method_updated 웹훅으로 알립니다.

다이어그램

저장된 결제 수단 사용

이전 구독이나 구매에서 이미 동의한 결제 수단이 있으면 호스팅 화면에서 재사용할 수 있습니다. 카드 재입력과 새 동의 단계를 모두 건너뜁니다.

갱신 결제 실패 복구

갱신 청구가 실패하면 unpaid로 전환되고 고객에게 복구 결제 링크를 이메일로 보냅니다(수명 주기 및 청구 참고). 기존 카드의 자동 재시도를 기다리거나 복구 Checkout Session에서 새 카드를 제공할 수 있습니다. 새 카드를 등록하면 구독 결제 수단이 업데이트되고 미납 주문 결제를 즉시 다시 시도합니다.