브랜드페이 개요

로그인 회원이 처음 결제할 때 카드·계좌를 저장해 두고, 다음 결제부터 저장된 수단으로 바로 결제하게 하는 기능입니다. 결제위젯 위에 얹어 쓰며 별도 SDK 는 없습니다.

핵심 흐름

서버가 로그인 회원의 user_token 발급 → 결제위젯 렌더링에 전달 → 저장된 수단 표시 → 결제 → 서버 승인·검증 (결제위젯과 같음).

언제 쓰나

맞는 경우

  • 회원 로그인이 있는 서비스에서 재구매를 빠르게 합니다
  • 결제 시점은 매번 구매자가 정합니다

맞지 않는 경우

  • 비회원 주문만 받습니다 → 결제창
  • 서버가 정한 시점에 자동 청구 → 자동결제

결제 흐름

  1. 진입 — 로그인한 회원이 주문서를 엽니다
  2. 토큰 발급 — 백엔드가 회원 고유값(user_id)으로 user_token 을 발급합니다. 1시간 유효해 주문서를 열 때마다 새로 받습니다
  3. 위젯 렌더링 — 프론트엔드가 결제위젯을 그릴 때 user_token 을 넣습니다
  4. 수단 표시 — 저장된 수단이 있으면 우선 보이고, 없으면 일반 결제 뒤 저장 동의를 받습니다
  5. 결제 — 구매자가 저장 수단으로 결제합니다. 관리자에서 켜면 6자리 비밀번호를 받습니다
  6. 확정 — 이후는 결제위젯과 같습니다. 서버가 receipt_id 로 승인·검증하고 주문을 확정합니다
`user_id` 는 바꾸지 않습니다

저장된 수단은 user_id 에 묶입니다. 같은 회원에게 다른 값을 넣으면 저장한 카드를 찾지 못합니다. 이메일처럼 바뀔 수 있는 값 대신 회원 PK·UUID 를 씁니다.

회원 상태별 화면

상황 구매자가 보는 화면
비로그인 (user_token 없음) 일반 결제위젯
로그인 + 저장 수단 없음 일반 결제 후 저장 동의
로그인 + 저장 수단 있음 저장된 카드·계좌 우선 노출
user_token 만료 브랜드페이 없이 일반 결제위젯

누가 무엇을 하나

위치 할 일
관리자 사용할 위젯에서 결제수단별 브랜드페이를 켜고, 6자리 비밀번호 사용 여부를 정합니다
백엔드 로그인 세션 확인 → user_token 발급 → 결제 승인·검증
프론트엔드 결제위젯 렌더링 payload 에 user_token 전달

연동 전 확인

  • 결제위젯 연동이 먼저 끝나 있어야 합니다.
  • 정기결제 흐름에 쓰려면 위젯을 구독 결제 타입으로 만듭니다.
  • 회원 토큰 API 는 Secret Key 가 필요해 서버에서만 호출합니다 → 회원 토큰

다음 문서

함께 보기