[플러그인] PayPal 결제 플러그인 g7plus-paypal v2.0.1 (해외 고객 외화 결제)

안녕하세요, 화련입니다 😊 그누보드7 쇼핑몰에서 해외 고객이 PayPal로 외화 결제를 할 수 있게 만든 플러그인이에요. 필요하신 분들께 도움이 되면 좋겠어요.

📌 기본 정보

• 식별자: g7plus-paypal
• 버전: 2.0.1
• 라이선스: MIT (무료로 마음껏 쓰세요)
• 저장소: https://github.com/hwaryeon1234/g7_paypal_plugin

🧩 필요한 것

• 그누보드7 코어 7.1.1 이상
• PHP 8.2 이상
• sirsoft-ecommerce 모듈 1.3.0 이상

✨ 이런 걸 해줘요

• PayPal 계정, 카드(게스트), Pay Later로 결제할 수 있어요 (Orders v2)
• PayPal이 지원하는 24개 통화 중 운영자님이 고른 통화만 보여 줘요
• 금액·통화·주문번호를 서버에서 꼼꼼히 대조해요 (다르면 자동 환불!)
• 웹훅 서명 검증과 중복 결제 방지도 챙겨요
• 주문 취소·반품하면 PayPal로 자동 환불, 부분환불도 돼요 (180일 이내)
• 해외 배송지도 PayPal에 함께 전달해요
• 주문 상세에서 PayPal 거래 정보를 한눈에 볼 수 있어요
• 환불이 실패하면 이유와 해결 방법을 알려 줘요

📦 설치는 이렇게

관리자 > 플러그인 > GitHub에서 설치에 아래 주소를 넣고 활성화하면 끝이에요.

https://github.com/hwaryeon1234/g7_paypal_plugin

sirsoft-ecommerce 모듈을 먼저 설치해 주세요!

🔌 처음 연결할 때

1. developer.paypal.com에서 앱을 만들고, Sandbox Client ID·Secret을 관리자 > 플러그인 > PayPal 설정에 넣어요.
2. 같은 앱의 Webhooks에 설정 화면의 웹훅 URL을 등록하고, Webhook ID를 입력해요.
3. 이커머스 설정에서 USD 같은 외화를 추가하고, 결제수단에서 PayPal을 켜요.
4. 샌드박스로 테스트 결제를 해 보고, 괜찮으면 라이브 키를 넣은 뒤 샌드박스 모드를 꺼요.

⚠️ 쓰기 전에 꼭 알아두세요

• 원화(KRW) 주문에는 PayPal이 안 보여요. PayPal이 원화를 지원하지 않아서예요.
• 교환·반품 같은 클레임 추가결제는 아직 지원하지 않아요.
• 처음엔 샌드박스 모드예요. 샌드박스를 끄는 순간부터 진짜 결제가 되니 조심해 주세요!
• Webhook ID를 비워 두면 웹훅이 전부 거절돼요. 꼭 등록해 주세요.

💬 문의와 제보

궁금한 점이나 버그는 댓글이나 GitHub 이슈로 편하게 남겨 주세요. 따뜻하게 반겨 드릴게요 😊