# Bootpay 결제 매뉴얼

> AI로 쉽게 결제·예약·구독을 붙이는 한국 PG 통합 SDK 가이드. 결제창·결제위젯·브랜드페이·자동결제·예약결제·서버 연동·마켓플레이스를 다룬다.

Bootpay는 카드·간편결제·계좌이체·가상계좌·해외결제까지 한국 주요 PG 사를 단일 인터페이스로 통합한다. 결제 SDK (Web/iOS/Android/Flutter/React Native) 와 서버 REST API 를 같은 매뉴얼에서 다루며, 코드 예제는 Node.js/Python/Java/PHP/Ruby/Go/.NET 까지 포함한다.

## 시작하기

- [결제 연동 시작하기](https://developers.bootpay.ai/guide/intro): 첫 결제 흐름·역할 분리·읽는 순서
- [환경 설정](https://developers.bootpay.ai/guide/setup): 프로젝트·PG·Sandbox·SDK 설치
- [연동키 발급](https://developers.bootpay.ai/guide/keys): Client Key / Secret Key 발급·관리
- [AI 연동](https://developers.bootpay.ai/guide/ai): Claude Code / Cursor / Codex 로 결제 코드 자동 생성

## 결제 상품 둘러보기

- [상품 비교](https://developers.bootpay.ai/tour/overview): 결제창·위젯·브랜드페이·자동결제·예약결제 어떤 걸 골라야 할지

## 빠른 매뉴얼

- [결제창 빠른 매뉴얼](https://developers.bootpay.ai/recipes/payment-window): 단건 결제 최소 구현
- [결제위젯 빠른 매뉴얼](https://developers.bootpay.ai/recipes/payment-widget)
- [브랜드페이 빠른 매뉴얼](https://developers.bootpay.ai/recipes/brandpay)
- [자동결제 빠른 매뉴얼](https://developers.bootpay.ai/recipes/billing)

## 결제창 (단건 결제)

- [통합 가이드](https://developers.bootpay.ai/payment-window/integration): 결제창 호출·이벤트 처리·서버 검증
- [결제수단별 옵션](https://developers.bootpay.ai/payment-window/payment-methods): 카드·간편결제·가상계좌·계좌이체
- [에러 처리](https://developers.bootpay.ai/payment-window/error-handling)

## 결제위젯 (인-페이지 결제)

- [설정·렌더링](https://developers.bootpay.ai/payment-widget/setup)
- [커스터마이징](https://developers.bootpay.ai/payment-widget/customization)

## 브랜드페이 (회원 결제수단 저장)

- [통합 가이드](https://developers.bootpay.ai/brandpay/integration)
- [user_token 발급](https://developers.bootpay.ai/brandpay/user-token)

## 자동결제 (빌링키 기반 반복 청구)

- [개요](https://developers.bootpay.ai/billing/overview): 빌링키 모델·청구 흐름
- [청구 요청](https://developers.bootpay.ai/billing/charge-request)

## 예약결제

- [개요](https://developers.bootpay.ai/reserve/overview): 미래 시점 1회 청구

## 본인인증

- [개요](https://developers.bootpay.ai/identity/overview): 휴대폰/PASS 본인확인·CI/DI·두 가지 연동 방식
- [SDK 본인인증](https://developers.bootpay.ai/identity/integration): 인증창 호출·receipt_id로 결과 조회
- [REST API 본인인증](https://developers.bootpay.ai/identity/rest-api): 요청·SMS 재전송·OTP 승인

## 현금영수증

- [개요](https://developers.bootpay.ai/cash-receipt/overview): 소득공제·지출증빙·발행 방식 비교
- [발행](https://developers.bootpay.ai/cash-receipt/publish): 결제 건 발행·별건 발행
- [취소](https://developers.bootpay.ai/cash-receipt/cancel): 발행 방식별 취소

## 에스크로

- [개요](https://developers.bootpay.ai/escrow/overview): 결제대금예치 흐름·상태값
- [연동](https://developers.bootpay.ai/escrow/integration): 에스크로 결제·배송정보 전송·구매확정 통지

## 서버 연동

- [API 인증](https://developers.bootpay.ai/server/authentication): Client Key/Secret Key Basic Auth
- [결제 검증](https://developers.bootpay.ai/server/verify): receipt_id 기반 금액·상태 확인
- [취소·환불](https://developers.bootpay.ai/server/cancel)
- [user_token 발급](https://developers.bootpay.ai/server/user-token)
- [카드 수기결제](https://developers.bootpay.ai/server/keyin): 카드정보 직접 입력 키인 결제
- [웹훅 수신](https://developers.bootpay.ai/server/webhook): 결제·취소·입금 상태 콜백

## 마켓플레이스

- [개요](https://developers.bootpay.ai/marketplace/overview): 셀러·정산·수수료 모델
- [셀러 생성](https://developers.bootpay.ai/marketplace/seller-create)
- [정산 조회](https://developers.bootpay.ai/marketplace/seller-lookup)

## 운영

- [배포 체크리스트](https://developers.bootpay.ai/more/deploy-checklist): 운영 전 누락 점검

## 참고

- [결제 흐름 아키텍처](https://developers.bootpay.ai/reference/architecture/payment-flow)
- [Enum: PG 코드](https://developers.bootpay.ai/reference/enum-pg)

## Related

- [Bootpay 커머스 매뉴얼](https://commerce.bootpay.ai/): 주문·체크아웃·구독·링크페이까지 묶은 커머스 백엔드 SDK
- [Bootpay 블로그](https://blog.bootpay.ai/): 결제·정산·운영 인사이트
- [GitHub](https://github.com/bootpay): SDK·MCP·샘플 코드 저장소
- [Bootpay 회사 사이트](https://www.bootpay.ai/)