---
title: "결제 수단 및 동의"
description: "구독은 카드 결제 수단만 지원합니다. 정기 청구 동의와 기존 구독의 카드 업데이트 방식을 설명합니다."
source: "https://docs.tokenz.one/ko-KR/v2/subscriptions/payment-methods"
api_version: "v2"
locale: "ko-KR"
version_status: "current"
docs_stage: "prod"
---

# 결제 수단 및 동의

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

## 동의가 필요한 이유

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

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

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

## 결제 수단 업데이트

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

절차는 다음과 같습니다.

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

```mermaid
sequenceDiagram;
autonumber;
participant C as 고객;
participant TC as Tokenz 호스팅 결제 화면;
participant T as Tokenz API;
participant I as 카드사;
participant W as 판매자 웹훅 핸들러;
C->>TC: 새 카드 정보 입력;
TC->>I: MIT 동의 요청 (3D Secure가 필요할 수 있음);
alt 동의 완료
I-->>TC: 동의 완료;
TC->>T: 구독 결제 수단 업데이트;
T->>W: webhook: subscription.payment_method_updated;
else 동의 거부
I-->>TC: 동의 거부;
TC->>TC: 기존 결제 수단 유지;
end
```

## 저장된 결제 수단 사용

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

## 갱신 결제 실패 복구

갱신 청구가 실패하면 `unpaid`로 전환되고 고객에게 복구 결제 링크를 이메일로 보냅니다([수명 주기 및 청구](https://docs.tokenz.one/ko-KR/v2/subscriptions/lifecycle#dunning-(failed-payment-recovery)) 참고). 기존 카드의 자동 재시도를 기다리거나 복구 Checkout Session에서 새 카드를 제공할 수 있습니다. 새 카드를 등록하면 구독 결제 수단이 업데이트되고 미납 주문 결제를 즉시 다시 시도합니다.