로그인 회원이 처음 결제할 때 카드·계좌를 저장해 두고, 다음 결제부터 저장된 수단으로 바로 결제하게 하는 기능입니다. 결제위젯 위에 얹어 쓰며 별도 SDK 는 없습니다.
핵심 흐름
서버가 로그인 회원의 user_token 발급 → 결제위젯 렌더링에 전달 → 저장된 수단 표시 → 결제 → 서버 승인·검증 (결제위젯과 같음).
언제 쓰나
맞는 경우
- 회원 로그인이 있는 서비스에서 재구매를 빠르게 합니다
- 결제 시점은 매번 구매자가 정합니다
결제 흐름
- 진입 — 로그인한 회원이 주문서를 엽니다
- 토큰 발급 — 백엔드가 회원 고유값(
user_id)으로user_token을 발급합니다. 1시간 유효해 주문서를 열 때마다 새로 받습니다 - 위젯 렌더링 — 프론트엔드가 결제위젯을 그릴 때
user_token을 넣습니다 - 수단 표시 — 저장된 수단이 있으면 우선 보이고, 없으면 일반 결제 뒤 저장 동의를 받습니다
- 결제 — 구매자가 저장 수단으로 결제합니다. 관리자에서 켜면 6자리 비밀번호를 받습니다
- 확정 — 이후는 결제위젯과 같습니다. 서버가
receipt_id로 승인·검증하고 주문을 확정합니다
`user_id` 는 바꾸지 않습니다
저장된 수단은 user_id 에 묶입니다. 같은 회원에게 다른 값을 넣으면 저장한 카드를 찾지 못합니다. 이메일처럼 바뀔 수 있는 값 대신 회원 PK·UUID 를 씁니다.
회원 상태별 화면
| 상황 | 구매자가 보는 화면 |
|---|---|
비로그인 (user_token 없음) |
일반 결제위젯 |
| 로그인 + 저장 수단 없음 | 일반 결제 후 저장 동의 |
| 로그인 + 저장 수단 있음 | 저장된 카드·계좌 우선 노출 |
user_token 만료 |
브랜드페이 없이 일반 결제위젯 |
누가 무엇을 하나
| 위치 | 할 일 |
|---|---|
| 관리자 | 사용할 위젯에서 결제수단별 브랜드페이를 켜고, 6자리 비밀번호 사용 여부를 정합니다 |
| 백엔드 | 로그인 세션 확인 → user_token 발급 → 결제 승인·검증 |
| 프론트엔드 | 결제위젯 렌더링 payload 에 user_token 전달 |
연동 전 확인
- 결제위젯 연동이 먼저 끝나 있어야 합니다.
- 정기결제 흐름에 쓰려면 위젯을 구독 결제 타입으로 만듭니다.
- 회원 토큰 API 는 Secret Key 가 필요해 서버에서만 호출합니다 → 회원 토큰



