브랜드페이 결제 관리 SDK

고객이 직접 결제수단(카드/계좌)을 등록하고 관리할 수 있는 위젯입니다.
등록된 결제수단은 간편 결제 및 자동결제(빌링)에 사용할 수 있습니다.

카드 등록

신용/체크카드를 등록하여 간편 결제에 사용

계좌 등록

은행 계좌를 등록하여 자동이체 결제에 사용

결제수단 삭제

등록된 결제수단을 삭제

결제수단 조회

등록된 결제수단 목록 확인

사용 시나리오

1
서버에서 로그인 토큰을 발급받습니다. (토큰 발급 가이드)
2
프론트엔드에서 launchBrandpayManager를 호출합니다.
3
고객이 카드/계좌를 등록하거나 관리합니다.

SDK 호출

Client

BootpayCommerce.launchBrandpayManager()를 호출하여 브랜드페이 결제 관리 위젯을 실행합니다.

파라미터

client_keystring필수프로젝트 Client Key
login_tokenstring필수서버에서 발급받은 로그인 토큰
hooksobject이벤트 콜백 훅 (선택)

로그인 토큰 전달

Server → Client

서버에서 발급받은 login_token을 SDK에 전달합니다.

로그인 토큰 발급 방법은 토큰 발급(로그인) 가이드를 참고하세요.

이벤트 훅

선택

hooks 옵션으로 위젯 상태 변화를 콜백으로 처리할 수 있습니다.

콜백 함수

brandpayWalletUpdated(data: WidgetBrandpayWalletModel[]) => void결제수단(지갑) 정보 업데이트 시 호출
brandpayManagerWindowReady(data: WidgetBrandpayWalletModel[]) => void브랜드페이 관리 창 준비 완료 시 호출
brandpayManagerWindowClosed() => void브랜드페이 관리 창 닫힘 시 호출

1. SDK 호출

// 브랜드페이 결제 관리 SDK 호출window.BootpayCommerce.launchBrandpayManager('#bootpay-store', {    client_key: '[Client KEY]',    login_token: '[서버에서 발급받은 로그인 토큰]',    hooks: {        brandpayWalletUpdated: (wallets) => {            // 결제수단(지갑) 정보 업데이트            console.log('wallets updated', wallets)        },        brandpayManagerWindowReady: (data) => {            // 브랜드페이 관리 창 준비 완료            console.log('manager window ready', data)        },        brandpayManagerWindowClosed: () => {            // 브랜드페이 관리 창 닫힘            console.log('manager window closed')        }    }})

현재 단계

SDK 호출

브랜드페이 결제 관리 위젯을 실행합니다