자주 묻는 질문
시작하기
부트페이가 무엇을 제공하고, 어떻게 시작하는지.
부트페이는 무엇을 제공하나요?
PG 연동, 휴대폰 본인인증, 카카오 알림톡, 쇼핑몰 구축(커머스 API · 판매 링크)을 제공합니다. 하나만 써도 되고, 여러 개를 함께 써도 같은 관리자에서 관리합니다.
테스트는 무료인가요?
네. 가입하면 테스트 환경을 무료로 쓸 수 있고, 계약은 테스트해 본 뒤에 결정합니다.
사업자등록증이 꼭 있어야 하나요?
PG 가맹에는 사업자등록증이 필요합니다. 간이과세자 · 개인사업자 · 법인사업자 모두 같은 절차로 가입하고 연동합니다.
오픈까지 얼마나 걸리나요?
전자계약으로 진행하며 연동코드는 하루 안에 발급됩니다.
알림톡만 따로 쓸 수 있나요?
네. 알림톡은 쇼핑몰이 아닌 서비스에서도 API로 연동해 씁니다. 공용 템플릿 93종은 승인 없이 바로 발송합니다.
요금은 어떻게 되나요?
PG 카드 수수료는 영세 기준 1.2%부터, 본인인증은 건당 약 50원, 알림톡은 건당 6.5원, 쇼핑몰은 월 고정비 0원입니다. 모두 부가세 별도입니다.
PG · 결제
수수료, 계약과 심사, 연동, 정산 · 취소, 서비스 확장.
PG Plan과 API Plan의 차이는 무엇인가요?
PG Plan은 부트페이를 통해 PG 가맹을 진행하며, PG 수수료에 부트페이 이용료가 포함되어 별도 비용이 없습니다. API Plan은 가맹점이 PG사와 직접 수수료를 협상하고, 부트페이에는 결제 완료당 API 이용료 0.2%만 내는 방식입니다. 이미 유리한 PG 수수료를 확보했다면 API Plan이 맞습니다.
영중소 수수료는 무엇인가요?
영세 · 중소가맹점 우대 수수료입니다. 영세(연 매출 3억 이하)는 1.2%~2.1%, 중소(3억~30억)는 1.45%~2.7%가 적용되며 PG사에 따라 다릅니다.
신규 창업자도 영세 수수료가 적용되나요?
신규 창업 가맹점은 사업 개시 후 6개월간 카드 매출 정보가 없어 처음에는 일반 수수료가 적용됩니다. 이후 국세청 자료로 영세 가맹점이 확인되면 이미 낸 수수료와의 차액을 환급받습니다.
PG를 바꾸려면 코드를 고쳐야 하나요?
아닙니다. 하나의 API로 국내외 PG 10여 개를 연결하므로, PG 교체는 관리자에서 전환하면 됩니다.
정산 주기는 어떻게 되나요?
PG사별로 다르며 보통 D+3~D+5 영업일입니다. 정확한 주기는 계약 시 확인할 수 있습니다.
결제위젯 · 브랜드페이 같은 기능은 추가 비용이 있나요?
멀티 PG, 결제위젯, 브랜드페이, 실시간 대시보드는 추가 비용 없이 제공됩니다.
결제 승인은 어디서 하나요?
고객이 결제를 마치면 가맹점 서버가 승인하는 방식을 기본으로 권장합니다. 승인 응답의 금액과 상태를 주문과 대조하면 별도 사전 조회 없이 검증할 수 있습니다.
자동결제와 예약결제는 무엇이 다른가요?
둘 다 빌링키를 씁니다. 자동결제는 정해진 주기에 청구하고, 예약결제는 지정한 시각에 한 번 결제를 실행합니다.
테스트 환경은 무료인가요?
네, 무료입니다. 테스트 결제는 실제로 진행된 뒤 당일 늦은 밤에 자동으로 취소됩니다. 자동 취소가 되지 않으면 고객센터로 문의해 주세요.
수수료와 비용5
- PG 수수료는 보통 몇 %인가요?
- 영세·중소 우대 수수료는 언제 적용되나요?
- PG 가맹비 33만 원은 꼭 내야 하나요?
- 보증보험은 꼭 가입해야 하나요?
- 인앱결제 30% 수수료, 우회할 수 있나요?
계약과 심사5
연동11
- AI한테 결제 연동을 시킬 수 있나요?
- 결제창에 성공이 떴는데 왜 서버 검증이 필요한가요?
- 웹훅은 왜 필요한가요?
- 가상계좌는 왜 발급과 입금이 따로인가요?
- 결제도 예약이 되나요?
- 휴대폰 본인인증과 문자 인증은 뭐가 다른가요?
- 앱에 결제를 붙이려면 어떻게 하나요?
- 테스트 결제인데 카드에서 진짜 돈이 빠져나가나요?
- 고객이 카드를 바꾸면 정기결제는 어떻게 되나요?
- PG 연동은 어떤 순서로 하나요?
- 온라인 결제 방식에는 어떤 것들이 있나요?
운영5
- 결제는 됐는데 돈은 언제 들어오나요?
- 결제 취소는 언제까지 되나요?
- 결제는 됐는데 주문이 안 생겼어요
- 서비스 출시 전에 결제에서 뭘 확인해야 하나요?
- 결제 오픈 후 CS 문의는 어떻게 대응하나요?
기획과 확장8
본인인증
KCP · 다날 휴대폰 본인인증, 단가와 연동 방식.
어떤 본인인증을 제공하나요?
KCP와 다날의 휴대폰 본인인증을 제공합니다. 통신사가 가진 명의 정보로 이름 · 생년월일 · 휴대폰 번호를 확인합니다.
본인인증 비용은 얼마인가요?
건당 약 50원입니다. KCP 최소형은 월 25,000원에 500건이 포함되고, 넘으면 건당 50원입니다.
결제와 별도로 계약해야 하나요?
본인인증은 결제와 별도 계약이 필요한 상품입니다. 부트페이 관리자에서 본인인증 상품을 켜서 쓰며, KCP · 다날과 따로 연동할 필요는 없습니다.
어디에 쓰나요?
회원가입 실명 확인, 성인 인증, 중복 가입 방지처럼 사용자가 실제 본인인지 확인해야 하는 곳에 씁니다.
이미 결제를 연동했는데 새로 배워야 하나요?
거의 없습니다. 결제와 같은 SDK와 서버 API를 쓰고, 결제 요청 함수 대신 본인인증 요청 함수를 호출하면 됩니다.
인증 화면을 직접 만들 수 있나요?
네. 기본은 부트페이 인증창 방식이고, 화면을 직접 통제해야 하면 인증창 없이 REST API로 인증번호를 보내고 승인하는 방식도 있습니다.
인증된 이름 · 생년월일은 어떻게 받나요?
인증이 끝나면 화면에는 영수증 번호만 내려옵니다. 이름 · 생년월일은 가맹점 서버가 그 번호로 조회해 받습니다.
알림톡
공용 템플릿, 단가, 실패 처리, 연동 언어.
알림톡 발송 가격은 얼마인가요?
건당 6.5원이며 부가세는 별도입니다. 발송량 약정이나 월 기본료 없이 보낸 만큼만 차감합니다.
공용 템플릿은 바로 쓸 수 있나요?
네. 미리 등록된 공용 템플릿 93종은 승인 없이 바로 발송할 수 있습니다. 채널과 발신프로필만 연결하면 됩니다.
우리 서비스에 맞는 템플릿이 없으면요?
직접 등록할 수 있습니다. 카카오 심사를 거쳐 승인되면 발송하며, 승인 · 반려 결과는 웹훅으로 알려 드립니다.
템플릿이 우리 업종에 맞을까요?
예약 · 방문, 수강 · 교육, 청구 · 수납, 접수 · 처리결과, 회원 · 계정, 주문 · 배송, 구독, 이용권 등 14개 장르를 다룹니다. 템플릿 페이지에서 예시값을 바꿔 우리 서비스 문장으로 미리 볼 수 있습니다.
알림톡이 안 닿으면 어떻게 되나요?
실패로 처리하고, 등록해 둔 웹훅 주소로 실패 알림을 보냅니다. 문자로 대신 보내지 않으며, 실패한 발송은 청구하지 않습니다.
같은 알림이 두 번 나갈 수 있나요?
같은 ref_id로 다시 요청하면 새로 보내지 않고 처음 접수한 결과를 돌려드립니다. 앞 건이 실패했을 때만 다시 보냅니다.
어떤 언어로 연동할 수 있나요?
REST API와 서버 SDK 7종(Ruby · Node.js · Python · PHP · Java · Go · .NET)을 제공합니다. 단건 · 대량 · 예약 발송을 모두 지원합니다.
AI 도구로 알림톡을 보낼 수 있나요?
네. Claude · Cursor 같은 AI 도구에 부트페이 MCP를 연결하면 대화로 템플릿을 찾고, 자체 템플릿을 등록하고, 발송 · 예약 취소 · 발송 내역 조회까지 할 수 있습니다.
AI가 실수로 아무한테나 보내면 어떡하나요?
MCP 발송은 기본으로 꺼져 있고, 켠 뒤에도 변수가 채워진 실제 문구와 수신거부 여부를 먼저 보여 준 다음 확인한 같은 내용만 보냅니다. 확인은 10분 뒤 만료되며, 한 번에 보낼 수 있는 인원과 발신 채널은 설정값으로 고정돼 AI가 바꿀 수 없습니다.
쇼핑몰이 아니어도 쓸 수 있나요?
네. 예약 · 교육 · 청구 · 사내 업무처럼 쇼핑몰이 아닌 서비스에서도 API로 연동해 씁니다.
쇼핑몰
무료 쇼핑몰, AI 상품 등록, 커머스 API.
개발 없이도 팔 수 있나요?
네. 상품을 등록하면 내이름.bootpay.shop 주소의 쇼핑몰과 결제되는 판매 링크가 생깁니다. 인스타그램 · 틱톡 프로필 링크나 카카오톡 · 블로그 어디든 붙여 넣으면 됩니다.
상품 등록을 AI로 할 수 있나요?
네. 상품 사진을 올리고 어떻게 팔고 싶은지 한 줄로 쓰면 상품명 · 한 줄 설명 · 판매가 · 재고 · 카테고리 · 과세 유형을 AI가 채워 줍니다. 채운 값은 등록 전에 고칠 수 있고, 하루 사용 한도가 있습니다.
내 도메인을 연결할 수 있나요?
네. bootpay.shop 주소 대신 가진 도메인을 쇼핑몰 주소로 연결할 수 있습니다. SSL 인증서는 무료로 발급되고 자동으로 갱신되므로 따로 구매하지 않아도 됩니다.
비용은 얼마인가요?
월 고정비 · 셋업비 · 링크 생성비는 0원입니다. 결제가 일어날 때만 PG 수수료가 발생합니다.
구독 상품도 되나요?
네. 정기결제 계약, 회차별 과금, 해지 · 재시도까지 API로 처리합니다.
해외 고객에게도 팔 수 있나요?
네. PayPal을 연동해 해외 결제를 받을 수 있습니다.
쇼핑몰 화면은 어떤 기술로 만들어야 하나요?
정해진 기술이 없습니다. 부트페이는 쇼핑몰 백엔드를 API로 제공하고, 화면은 가맹점이 쓰는 웹 · 앱 스택으로 직접 만듭니다. API 키와 고객 세션은 가맹점 서버에서만 다루며, 참고용으로 Next.js 쇼핑몰 예제를 제공합니다.
주문서(체크아웃)도 직접 만들어야 하나요?
아닙니다. 배송지 · 약관 · 결제수단 입력은 부트페이 호스팅 주문서가 처리합니다. 가맹점 서버는 결과를 다시 확인하고 웹훅으로 상태를 맞추면 됩니다.
결제만 붙이면 되는데 커머스 API가 필요한가요?
주문 · 상품 · 고객 시스템이 이미 있다면 PG 연동만으로 충분합니다. 쇼핑몰 백엔드를 새로 만들거나 줄이고 싶을 때, 또는 구독 · 링크페이 · B2B처럼 결제 이후 운영이 길 때 커머스 API가 맞습니다.
커머스 API는 무엇을 대신하나요?
상품 · 옵션 · 재고, 고객, 장바구니, 주문서, 주문 · 배송 · 취소 · 반품, 구독 회차 과금, 쿠폰 · 적립금, 웹훅까지 쇼핑몰 백엔드를 직접 만들 때 필요한 엔티티 15개와 상태머신 2개의 자리를 대신합니다.
요금
기본료, 부가세, 청구 기준.
월 기본료가 있나요?
PG Plan과 API Plan 모두 월 기본료는 0원입니다. 쇼핑몰도 월 고정비 없이 결제가 일어날 때만 PG 수수료가 발생합니다.
알림톡은 실패한 발송도 청구되나요?
아닙니다. 실패한 발송과 수신거부로 막힌 발송은 청구하지 않습니다.
표시된 금액에 부가세가 포함되어 있나요?
표시된 요금은 부가세 별도입니다.
PG 수수료는 어떻게 정해지나요?
매출 구간(영세 · 중소 · 일반)과 PG사에 따라 다릅니다. 정확한 수수료는 상담으로 확인할 수 있습니다.
여러 상품을 함께 쓰면 따로 가입해야 하나요?
아닙니다. 한 번 가입하면 PG · 인증 · 알림톡 · 쇼핑몰을 같은 관리자에서 켜서 씁니다.
에러 코드
결제 응답 코드로 원인과 조치를 찾습니다.
- RC_CONFIRM_FAILED 로 결제 승인이 실패합니다. 어디부터 봐야 하나요?
- RC_RESOURCE_NOT_CONFIG 에러가 납니다. 무엇이 설정되지 않은 건가요?
- 다날 결제를 취소하면 "취소 불가 상태입니다"(1116)가 나옵니다. 왜 그런가요?
- "요청하신 Application ID를 찾을 수 없습니다"(-2410)는 왜 나오나요?
- "허용된 IP 접근이 아닙니다"(-2417, 401)는 어떻게 푸나요?
- RC_CANCEL_SERVER_ERROR 로 취소가 실패합니다. 재시도하면 되나요?
- KCP 테스트 결제에서 -11002 "카드번호 오류"가 납니다. 코드 문제인가요?
- "해당 결제 내역을 찾지 못했습니다"(-2100)는 무엇을 잘못 보낸 건가요?
- "PG에서 발급한 결제 정보를 부트페이 관리자에서 입력해야 합니다"(-308)는 왜 나오나요?
- -2003 "선택하신 결제 수단이 활성화되어 있지 않습니다"는 어떻게 고치나요?
- 빌링키 발급에서 -15005 "비밀번호 회수초과"가 납니다. 어떻게 하나요?
- RC_PROCESS_CANCELLED 는 사용자가 취소한 건가요, 오류인가요?
- APP_KEY_NOT_FOUND (Application ID를 찾지 못했습니다)는 왜 나오나요?
- KCP 취소에서 "취소불가 - 상점관리자 문의"(-11003)가 납니다. 무엇을 해야 하나요?
- 다날 정기결제에서 -10018 이 납니다. 무엇이 빠진 건가요?
- 페이앱 결제에서 "recvphone 값을 확인하세요"(-14000)가 납니다.
- "빌링키 승인이 실패하였습니다"(-100100)가 나옵니다. 실패 사유는 어디서 보나요?
- "카드사 전화요망"(-2156) 이나 "빌키 발급 불가 가맹점" 이 나옵니다.
- "취소금액이 미정산 금액보다 큽니다"는 어떻게 푸나요?
- "취소 기한 초과"(-15004)가 나옵니다. 언제까지 취소할 수 있나요?
- -15006 (카드사 통신장애 · 도난/분실 카드 등)은 무엇을 봐야 하나요?
- KG이니시스에서 "미등록가맹점" 이나 "PG Sub 사업자 번호 없음"(-13001)이 납니다.
- PG 에러코드 70020 으로 빌링 결제가 실패합니다. 무슨 뜻인가요?
- 다날 본인인증에서 9014 · -10014 (업체정보 이상)이 납니다.
- AUTH_NOT_CONFIRMED 가 납니다. 인증은 끝났는데 왜 그런가요?
- "요청한 application id 와 device type 이 일치하지 않습니다"(-2420)는 어떻게 고치나요?
- "회원사 서비스 개시 안됨"(-15003)은 무슨 상태인가요?
- AUTH_REQUEST_FAILED 로 본인인증 요청이 실패합니다.
- "정기결제 REST API를 이용할 수 없는 PG입니다"(-2138)가 나옵니다.
- 빌링키를 발급받았는데 조회하면 SUBSCRIBE_NOT_SUCCESS 가 납니다.
- RC_PM_NOT_FOUND (결제수단 정보를 찾지 못했다)는 무엇이 문제인가요?
- 나이스페이에서 "하위사업자번호 오류"(F113)가 납니다.
- "빌링 미사용 가맹점입니다"(F117)는 어떻게 푸나요?
- 다날 결제에서 "전문 파싱 중 오류가 발생했습니다"(-10008)가 납니다.
- "빌링키로는 결제할 권한이 없습니다"(-3000)는 무슨 뜻인가요?
- "이미 취소되었거나 취소가 가능한 결제가 아닙니다"(-2105)가 납니다.
- -15500 (server error · 정상 계약되지 않은 결제수단입니다)는 무엇인가요?
- "프로젝트에서 설정된 결제가 아닙니다"(-651)는 왜 나오나요?
- 이니시스 취소에서 -13002 가 나는데 실제로는 환불이 됐습니다.
- "취소된 빌링키이거나 이미 만료된 빌링키입니다"(-3003)는 왜 나오나요?
- SUBSCRIBE_BK_EXPIRED 가 납니다. 방금 발급한 빌링키인데요.
- RC_PRICE_LEAST_LT — 최소 결제 금액은 얼마인가요?
- 다날 정기결제에서 "접근 권한이 없습니다"(1112)가 납니다.
- 나이스페이에서 "미등록PG업체(가맹점)"(8901)가 나옵니다.
- -10002 "취소 불가 상태입니다" 의 상세 사유는 어디서 보나요?
- KCP 정기결제에서 "판매자명을 입력해주세요"(-11017)가 납니다.
- JS SDK 5 로 올렸더니 RC_REDIRECT_URL_INVALID 가 납니다.
- RC_O_ID_BLANK 가 납니다. order_id 를 보냈는데요.
- 나이스페이에서 "해당거래 취소실패(기취소성공)"(2015)가 납니다.
- APP_FIREWALL_BLOCKED (접근이 허가된 IP 가 아니다)는 어떻게 푸나요?
- APP_AT_AUTHORIZE_HEADER_BLANK (400 Bad Request)는 무엇이 빠진 건가요?