Skip to main content

사전 요구 사항

  • Python 3.10 이상과 Django 5.2를 사용하는 호환 Ruoom Core 1.x.
  • 라이선스가 적용된 payment_plugin-1.5.5-py3-none-any.whl 아티팩트.
  • Stripe, PayPal 또는 PortOne 중 하나 이상의 제공업체 자격 증명.

설치

Core 가상 환경을 활성화한 상태에서 wheel을 설치합니다. 소스를 Core 안에 압축 해제하지 마십시오.
.env의 쉼표 구분 목록에 payment를 추가하여 활성화합니다.
다른 플러그인을 사용 중이라면 기존 값을 유지하십시오. 예: RUOOM_PLUGINS=payment,digitalproducts,email_otp. 마이그레이션을 적용하고, 배포용 정적 파일을 수집하고, Django를 검사합니다.
애플리케이션을 다시 시작합니다. Core가 플러그인을 /payment/에 마운트하고 결제 처리 설정 탭을 자동으로 추가하므로 INSTALLED_APPS나 최상위 URL을 수정하지 않습니다.

제공업체 구성

직원 계정으로 로그인하여 플랫폼 설정 → 결제 처리를 엽니다. 게이트웨이 계정을 구성하고 활성화한 후 자격 증명을 검증하고, 결제를 받을 각 비즈니스/통화 조합에 경로를 할당합니다. 결제 처리
  • PayPal 경로는 USD만 지원합니다.
  • PortOne은 기본적으로 KRW를 지원하며 USD에는 명시적인 계정 기능이 필요합니다.
  • Stripe는 USD를 지원합니다. KRW는 적격 계정/기능이 필요하며 브라우저 로캘만으로 활성화되지 않습니다.
테스트 결제를 수행하고 /payment/purchases/에 구매가 표시되는지 확인하십시오. 필요에 따라 제공업체 웹훅을 /payment/webhooks/stripe/, /payment/webhooks/paypal/ 또는 /payment/webhooks/portone/으로 설정합니다.

업그레이드