결제대행사를
안전하게 연동.
국내 토스페이먼츠·NHN KCP·KG이니시스와 해외 Stripe·PayPal 등 5개 결제대행사 선택과 주문·승인 서버 연동 범위를 안내합니다.
PG사 선택 및 개발 문서
토스페이먼츠
국내 온라인 결제와 결제위젯·승인 API 연동을 위한 토스페이먼츠 안내입니다.
연동 안내 보기 → 국내 PGNHN KCP
국내 가맹점 결제창과 승인·취소 API 구축에 필요한 NHN KCP 개발자 안내입니다.
연동 안내 보기 → 국내 PGKG이니시스
국내 결제수단별 가맹점 등록, 테스트와 KG이니시스 연동 매뉴얼 안내입니다.
연동 안내 보기 → 해외 PGStripe
국제 카드 결제, 다중 통화와 Stripe Checkout·웹훅을 이용한 해외 결제 안내입니다.
연동 안내 보기 → 해외 PGPayPal
PayPal Checkout을 통해 해외 구매자가 지원되는 통화로 결제하는 연동 안내입니다.
연동 안내 보기 →각 PG사는 가맹점 계약·심사와 별도 테스트/운영 키를 요구합니다. 이 화면은 결제창이나 결제·승인·취소 API를 실행하지 않습니다.
PG사 결제 연동 구현 순서
PG 결제 연동에는 가맹점 계약·심사, 브라우저 결제 요청, 서버 측 승인, 주문 상태 관리, 취소·환불과 정산 처리가 필요합니다. 제공자 SDK 예제만 붙이는 것으로 안전한 결제 흐름이 완성되지는 않습니다.
시작 전 준비사항
- 사업자·상품 정보와 PG사 가맹점 심사 및 운영 계약
- HTTPS 도메인, 서버에서 관리할 비밀키와 주문 DB
- 결제·취소·환불·부분 취소·웹훅 및 고객지원 정책
구현 및 검증 순서
- PG사와 결제수단 결정
국내 토스페이먼츠·NHN KCP·KG이니시스와 해외 Stripe·PayPal 공식 문서를 비교하고 국가·업종별 지원 범위, 필요한 결제수단, 수수료·통화·정산·심사 조건을 확인합니다.
- 테스트 상점과 키 구성
PG 개발자 콘솔에서 테스트 상점과 허용 도메인·callback을 등록합니다. 공개 가능한 클라이언트 키와 비밀 서버 키를 구분하고 비밀키는 환경변수 또는 보호된 비밀 저장소에만 둡니다.
- 주문 금액을 서버에서 확정
상품·수량·할인·배송을 서버 DB에서 계산하고 고유 주문 ID에 연결합니다. 브라우저가 전달한 금액을 그대로 신뢰하지 말고 주문 소유자와 금액·통화·상태를 서버에서 대조합니다.
- 결제 승인·상태 전이 구현
결제창 성공 후 서버에서 PG 승인 API를 호출하고 응답을 검증한 다음 주문을 원자적으로 확정합니다. 타임아웃·중복 요청·콜백 재시도는 멱등하게 처리하고 실패·취소 상태도 명확히 저장합니다.
- 취소·웹훅과 운영 전환 시험
전체·부분 취소, 승인 지연, 중복 웹훅, 환불·정산 내역을 테스트 키로 검증합니다. 로깅에서 카드정보·인증값·비밀키를 제외하고, 실키 전환 후 모니터링과 장애 대응 절차를 확인합니다.
운영 전 확인 목록
- 서버가 주문 금액·통화·회원 소유권을 다시 확인하는가
- 승인·취소·웹훅 중복 처리에 멱등성과 서명 검증이 있는가
- 테스트와 운영 키가 분리되고 비밀키가 공개되지 않는가
카드번호·CVC 등 카드 인증정보를 자체 서버에 저장하지 마세요. 결제 완료 화면이나 브라우저 redirect만으로 주문을 확정하지 말고, PG 서버 승인 결과와 통지 검증을 완료한 뒤 처리하세요.