PG 연동은 어떤 순서로 하나요?
가입하고 프로젝트를 만든 뒤 연동키를 받고, 쓸 PG를 테스트 모드로 켜서 결제창·서버 검증·취소까지 한 바퀴 돌려봅니다. 이 흐름이 끝나면 PG 가맹을 신청하고, 가맹 정보가 나오면 관리자에서 PG 설정만 실제 값으로 바꿉니다. 연동 코드는 다시 짜지 않습니다.
가맹 전에 연동부터 끝냅니다
아직 개발 중이라면 테스트 모드에서 연동을 먼저 끝내고, 서비스가 준비되면 PG 가맹을 신청합니다. 결제창을 띄우고, 결제가 끝나면 서버에서 금액과 상태를 다시 조회하는 검증까지 붙이면 기본은 끝입니다.
AI 코딩 도구를 쓴다면 "bootpay-mcp 참조해서 결제 연동해줘"라고 요청하면 SDK 설치부터 서버 검증 코드까지 만들어 줍니다.
테스트는 소액으로, 취소까지 해봅니다
대부분의 PG는 테스트 모드에서도 실제 카드 승인을 태웁니다. 100원이나 1,000원처럼 잃어도 부담 없는 금액으로 하고, 테스트가 끝나면 관리자에서 직접 취소해 두세요.
확인할 것은 승인 한 번이 아니라 한 바퀴입니다. 인증이 되는지, 결과가 돌아오는지, 서버 검증이 통과하는지, 웹훅이 오는지, 취소가 되는지까지 봐야 운영에 올릴 수 있습니다.
시크릿 키는 서버 환경변수에만 둡니다
Secret Key 는 서버에서만 쓰는 값입니다. 코드에 직접 적거나 프론트엔드·저장소에 올리면 유출됩니다. .env 같은 환경변수 파일에 넣고 코드는 그 값을 읽게 하며, 환경변수 파일은 저장소에 올리지 않습니다.
AI 에게 연동을 맡길 때도 키 값을 대화창에 붙여넣지 마세요. 대화 기록이 파일로 남습니다. 환경변수 이름만 알려주면 됩니다.
무통장입금만으로는 오래 못 버팁니다
처음 몇 건은 계좌로 받아도 됩니다. 다만 입금자명과 금액을 사람이 맞춰야 하고, 현금영수증과 환불도 따로 챙겨야 합니다. 카드 결제창이 없으면 구매자도 망설입니다. 카드·휴대폰·간편결제를 받으려면 PG가 필요합니다.