P · PAYMENT GATEWAY
PayPal
PG 연동 안내.
PayPal Checkout을 통해 해외 구매자가 지원되는 통화로 결제하는 연동 안내입니다.
P · PAYMENT GATEWAY
ROUTE PREVIEW
사용자 기기
Client
HTTPS · 결제 API
연결 중계
PG 결제
주문 서버 · 승인/취소
테스트 키, 서버 승인·취소, 웹훅과 주문 상태 검증을 구성합니다.
PACKET FLOW
현재 결제 미연동
PayPal 결제 설정 안내
PayPal Checkout을 통해 해외 구매자가 지원되는 통화로 결제하는 연동 안내입니다.
실제 결제에는 가맹점 계약, 비밀 키의 안전한 보관, 서버 승인·취소 API와 테스트가 필요합니다.
IMPLEMENTATION GUIDE
04 IMPLEMENTATION STEPS
PayPal 구현 순서
PayPal Checkout을 통해 해외 구매자가 지원되는 통화로 결제하는 연동 안내입니다. 결제 결과는 서버에서 주문 정보와 대조해 확정해야 합니다. 가맹점 심사와 실제 결제 API 연동은 별도 작업입니다.
시작 전 준비사항
- 국가·사업자 조건을 충족하는 PayPal Business 계정
- Sandbox 앱과 Client ID·Secret 및 운영 전환 설정
- 서버 주문 생성·캡처·환불과 웹훅 검증
구현 및 검증 순서
- 가맹 조건과 결제 범위 확인
사업자 국가·업종에서 제공자 계정을 사용할 수 있는지, 수수료·정산·결제 통화와 필요한 수단을 공식 안내에서 확인합니다.
- 테스트 계정·키 구성
테스트 환경에 도메인과 callback·웹훅 주소를 등록하고, 공개 키와 서버 비밀 키를 구분해 개발·운영 설정을 분리합니다.
- 서버 주문·승인 흐름 구현
서버가 주문 금액·통화·사용자 소유권을 계산하고 결제 승인·캡처 결과를 검증한 다음 주문 상태를 확정하도록 구현합니다.
- 취소·웹훅·운영 점검
중복 알림, 실패·지연 승인, 전체·부분 환불과 분쟁 흐름을 테스트합니다. 카드 인증정보나 비밀 키가 로그·클라이언트에 노출되지 않는지 확인합니다.
운영 전 확인 목록
- 가맹점 국가·업종·통화와 제공자 지원 범위를 확인했는가
- 주문 금액·통화와 승인·캡처를 서버에서 검증하는가
- 웹훅·취소·중복 요청을 안전하고 멱등하게 처리하는가
Client Secret은 서버에만 보관하고 주문 승인 후 서버에서 캡처 결과를 확인하세요. 계정 국가·통화·수수료·분쟁 대응 조건과 웹훅 서명을 확인해야 합니다. 카드번호·CVC 등 인증정보를 자체 서버에 저장하지 마세요.