PG 결제 연동 순서 7단계와 라이브 점검 10개
PG 결제 연동을 개발 쪽에서 붙이는 7단계 순서입니다. 가맹 심사 준비물, 결제창 · 승인 · 웹훅 역할 나누기, 라이브 전환 전 점검 10개를 정리했습니다.

PG 결제 연동은 가맹 심사 신청과 테스트 개발을 같은 주에 시작하고, 결제창 호출 → 결과 확인 · 금액 대조 → 서버 승인 → 취소 · 웹훅 → 라이브 키 전환 순서로 붙입니다. PG(Payment Gateway, 결제대행사)는 카드사 · 간편결제 · 은행과 하나하나 계약하지 않아도 여러 결제수단을 받을 수 있게 중간에서 이어 주는 회사입니다. 심사에는 따로 기다리는 날이 있어서, 개발을 마친 뒤 신청하면 그만큼 오픈이 늦어집니다.
한 쇼핑몰 플랫폼의 안내 기준으로 PG사 · 카드사 심사를 거쳐 결제를 쓰기까지 영업일 7~10일 정도가 걸리고, 반려되면 보완 뒤 다시 심사를 받느라 그만큼 더 늘어납니다. 개발 첫 주에 신청서부터 내세요.
PG 결제 연동은 어떤 순서로 진행하나요?
아래 7단계를 위에서부터 진행합니다. 2단계 심사와 3~6단계 개발은 나란히 돌아갑니다 — 한 PG사 개발자 문서 기준으로 전자결제 계약 전이어도 회원가입만 하면 테스트 상점 키를 받아 테스트 결제내역 · 웹훅 기능까지 써 볼 수 있기 때문입니다.
| 단계 | 하는 일 | 맡는 사람 | 끝났다는 기준 |
|---|---|---|---|
| 1. 결제 범위 정하기 | 결제수단(카드 · 간편결제 · 계좌이체 · 가상계좌), 일반결제와 정기결제, 부분 취소 허용 여부 | 기획 · 대표 | 범위표 1장 확정 |
| 2. 가맹 신청 · 심사 | 사업자 서류 제출, 사이트 하단 정보 · 환불 정책 게시 | 운영 담당 | 계약 완료, 상점아이디(MID) 발급 |
| 3. 테스트 결제창 | 테스트 키로 "결제하기" 단추에 결제창 연결 | 프론트 개발 | 테스트 결제창이 뜸 |
| 4. 결과 확인 · 금액 대조 | 성공 주소로 돌아온 값과 주문 금액 비교 · 저장 | 서버 개발 | 금액이 다르면 승인하지 않음 |
| 5. 서버 승인 | 시크릿 키로 승인 API 호출 | 서버 개발 | 정상 응답 뒤 주문 상태가 결제 완료로 바뀜 |
| 6. 취소 · 웹훅 | 전체 · 부분 취소, 가상계좌 입금 알림 받기 | 서버 개발 | 관리자 화면에서 취소 처리 가능 |
| 7. 라이브 전환 | 라이브 키로 교체, 실제 카드로 소액 결제 후 취소 | 개발 · 운영 | 아래 점검 10개 통과 |
상점아이디(MID)는 PG가 가맹점마다 붙이는 식별 번호입니다. 일반결제와 정기결제 계약은 MID가 따로 나올 수 있으니, 받은 MID와 계약 내용을 한 표에 적어 개발 담당에게 넘기세요.
PG 가맹 심사에는 무엇을 준비하나요?
심사는 PG사와 카드사가 이 사이트에서 실제 판매가 이뤄질 수 있는지 보는 절차입니다. 결제 단추만 비워 두고 나머지 화면은 먼저 열어 둔 상태에서 신청하세요. 앞의 플랫폼 안내에서 꼽는 항목을 정리하면 이렇습니다.
- 판매 업종 — 카드사 등록 제한 업종에 해당하는지 신청 전에 PG사 목록과 맞춰 봅니다.
- 사이트 완성도 — 상품 진열 · 상세 · 주문 · 문의 페이지가 실제로 작동해야 합니다.
- 하단 사업자 정보 — 상호 · 대표자 · 사업장 주소 · 연락처 · 개인정보관리책임자를 PG 신청서와 같은 글자로 적습니다.
- 통신판매업 신고번호 — 이 안내에서는 심사 단계에 "신고예정"으로 적고, 신고를 마친 뒤 번호로 바꿀 수 있다고 설명합니다.
- 배송 · 교환 · 환불 정책 — 상품 상세마다 보이게 둡니다.
요청 서류는 PG사마다 양식이 다릅니다. 신청 화면의 서류 목록을 그대로 체크리스트로 옮겨 한 폴더에 모아 두세요.
결제창 · 승인 · 웹훅은 코드에서 어떻게 나누나요?
용어부터 정리합니다. 인증은 구매자가 결제창에서 카드 · 간편결제로 본인 확인을 마치는 단계이고, 승인은 가맹점 서버가 PG에 이 결제를 확정해 달라고 요청하는 마지막 단계입니다. 웹훅은 결제 상태가 바뀌면 PG가 가맹점 서버의 정해 둔 주소로 알려 주는 호출입니다.
| 구분 | 실행 위치 | 쓰는 값 | 할 일 |
|---|---|---|---|
| 결제 요청 | 브라우저 | 클라이언트 키 · 주문번호 · 금액 · 성공/실패 주소 | "결제하기" 단추에 결제창 호출 연결 |
| 결과 확인 | 성공 페이지 | paymentKey · orderId · amount | 주문 DB 금액과 amount 대조, 세 값 저장 |
| 승인 | 서버 | 시크릿 키(Basic 인증 헤더) | 승인 API 호출, 응답을 받으면 주문 상태 변경 |
| 상태 알림 | 서버(웹훅 주소) | 웹훅 본문 | 가상계좌 입금 · 취소를 주문에 반영 |
| 취소 | 서버 | paymentKey · 취소 금액 | 전체 · 부분 취소 |
한 PG사 개발자 문서에서 강조하는 규칙 5가지는 다른 PG에도 그대로 옮겨 쓸 수 있습니다.
- 시크릿 키는 서버에만 둡니다. 문서는 클라이언트 코드나 GitHub 같은 바깥에 노출되면 안 된다고 적고 있습니다.
- 성공 주소로 돌아온 amount가 결제 요청 때 보낸 금액과 같은지 대조하고, 다르면 승인하지 않습니다. 쿠폰 · 적립금이 반영된 금액도 서버에서 다시 계산하세요.
- 성공 페이지로 이동한 뒤 10분 안에 승인 API를 호출합니다. 이 문서는 10분이 지나면 결제가 만료돼 승인할 수 없다고 안내합니다.
- 모바일에서는 iframe 안에서 결제창을 띄우지 않습니다. 일부 간편결제가 작동하지 않고, 모바일 결제창은 페이지 이동 방식이기 때문입니다.
- 주문번호는 주문마다 겹치지 않게 서버가 만듭니다. 이 문서 기준으로 영문 대소문자 · 숫자 · - · _ 조합 6~64자입니다.
여러 PG를 한 코드로 묶어 주는 연동 중개 서비스를 써도 금액 대조 · 서버 승인 확인 · 웹훅 처리라는 뼈대는 같습니다.
라이브로 바꾸기 전에 무엇을 점검하나요?
PG 결제 연동을 라이브 키로 바꾸는 날, 아래 10개를 한 사람이 처음부터 끝까지 직접 눌러 보며 확인하세요. 한 PG사의 배포 체크리스트 항목을 바탕으로 정리했습니다.
| 번호 | 점검 항목 | 확인 방법 |
|---|---|---|
| 1 | 라이브 키로 바뀌었나 | 서버 환경 변수에서 키 종류 확인 |
| 2 | 시크릿 키가 바깥에 없나 | 프론트 코드 · 저장소에서 키 문자열 검색 |
| 3 | 결제수단 심사를 통과했나 | 카드 · 휴대폰 · 상품권 등 쓸 수단별 심사 결과 확인 |
| 4 | 결제 흐름 전체가 이어지나 | 주문 → 결제 → 승인 → 주문 완료 화면까지 실결제 |
| 5 | 취소 · 부분 취소가 되나 | 4번 결제를 관리자 화면에서 부분 취소 후 전체 취소 |
| 6 | 실패 안내가 나오나 | 결제창을 중간에 닫아 실패 페이지 문구 확인 |
| 7 | 할부 · 무이자가 맞게 붙나 | 할부 개월을 골라 결제 내역과 대조 |
| 8 | 현금영수증이 발행되나 | 계좌이체 · 가상계좌 결제 후 발행 여부 확인 |
| 9 | 가상계좌 웹훅이 들어오나 | 입금 후 주문 상태가 자동으로 바뀌는지 확인 |
| 10 | 기기별로 되나 | 데스크톱 브라우저 · Android · iOS에서 각각 결제와 취소 |
이 표를 외부 개발 계약의 검수 항목으로 그대로 붙여 두면 완료 기준이 하나로 맞춰집니다. 조항 구성은 소프트웨어 개발 계약서 양식과 검수표에서 이어서 볼 수 있습니다.
PG 결제 연동 개발 견적은 무엇으로 정해지나요?
작업량은 결제수단 개수보다 결제 뒤에 붙는 화면과 처리에서 크게 갈립니다. 정기결제(빌링 — 카드를 한 번 등록해 두고 다음부터 추가 인증 없이 결제하는 방식)가 있는지, 취소 · 부분 취소를 관리자 화면에서 처리할지, 가상계좌 웹훅을 받을지, 앱 안 웹뷰에서도 결제할지가 범위를 정합니다. 기존 사이트에 주문 DB와 관리자 화면이 이미 있으면 그만큼 줄어듭니다.
결제 연동 개발 외주로 견적을 받을 때는 1단계 범위표와 결제 전후 화면 목록을 함께 보내세요. 화면마다 무엇을 입력하고 무엇이 보여야 하는지는 비개발자용 명세 양식처럼 칸을 나눠 적으면 견적 항목이 화면 단위로 나와 비교가 쉬워집니다.
자주 묻는 질문
PG 계약 전에도 결제 연동 개발을 시작할 수 있나요?
시작할 수 있습니다. 한 PG사 개발자센터는 전자결제 계약 전이라도 회원가입만 하면 테스트 상점 키로 결제창 · 테스트 결제내역 · 웹훅을 써 볼 수 있게 열어 두고 있습니다. 계약 뒤에는 발급된 상점아이디(MID)의 라이브 키로 바꾸기만 하면 되도록 키를 서버 환경 변수로 분리해 두세요.
결제 승인은 왜 프론트가 아니라 서버에서 하나요?
승인 API 호출에는 시크릿 키가 들어가는데, 이 키가 브라우저 코드에 있으면 누구나 열어 볼 수 있기 때문입니다. 서버에서 주문 DB 금액과 돌아온 결제 금액을 대조한 뒤 승인해야 금액이 바뀐 요청을 걸러 낼 수 있습니다.
PG 결제 연동을 외주로 맡기면 비용은 무엇으로 정해지나요?
결제수단 개수보다 정기결제 여부, 관리자 화면의 취소 · 부분 취소 처리, 가상계좌 웹훅, 앱 웹뷰 결제 포함 여부가 범위를 크게 바꿉니다. 기존 사이트에 주문 DB와 관리자 화면이 있는지도 작업량을 정합니다. 결제 범위표와 결제 전후 화면 목록을 함께 보내면 견적이 화면 단위로 나와 비교하기 쉽습니다.
쇼피파이 같은 쇼핑몰 솔루션도 결제 연동 개발이 필요한가요?
호스팅형 쇼핑몰 솔루션은 관리자 결제 설정 화면에서 지원하는 결제 서비스를 고르고 계약 정보를 넣는 방식이 많아, 코드를 짜는 일보다 가맹 심사 준비가 중심이 됩니다. 쓸 수 있는 결제 서비스는 판매 국가와 통화에 따라 달라지니 결제 설정 화면의 목록을 먼저 확인하세요. 솔루션 밖의 자체 사이트나 앱에서 결제를 받을 때 이 글의 7단계 개발이 필요합니다.
오늘 할 일
결제 범위표 한 장을 만들어 대표와 개발 담당에게 함께 보내세요. 받을 결제수단(카드 · 간편결제 · 계좌이체 · 가상계좌), 일반결제와 정기결제 가운데 필요한 것, 부분 취소 허용 여부, 가상계좌 입금 알림 사용 여부 4가지만 적으면 됩니다. 이 표 한 장으로 PG 신청서의 결제수단 칸과 개발 범위가 같은 내용으로 맞춰지고, 외주 견적을 받을 때도 그대로 첨부할 수 있습니다.
이어서 읽기 — 간편결제 연동, 페이사별 비교표와 연동 6단계 · 에스크로 결제, 배송 등록 연동과 점검 항목 6개



