Skip to main content

​
통합 경계

결제 플러그인 아키텍처 다이어그램 Core는 plugins.payment URL 구성을 /payment/에 마운트합니다. 플러그인 메타데이터는 결제 처리 설정 탭을 추가하고 구매 및 설정 페이지를 직원 전용으로 지정합니다.

​
주요 모델

  • PaymentSettings, TaxSettings: 이전 버전과 호환되는 비즈니스 결제 및 세금 설정.
  • GatewayAccount: 암호화된 제공업체 자격 증명, 제공업체/국가 정보, 기능 및 검증 상태.
  • PaymentRoute: 비즈니스와 통화를 활성화되고 검증된 게이트웨이 계정에 연결하는 우선순위 경로.
  • Cart, Order: 결제 전 항목 및 변경되지 않는 완료 주문 기록.
  • Payment, Refund: 거래 및 환불 기록.
  • CheckoutAttempt: 서버 측 금액, 통화, 고객/비회원, 제공업체 ID, 정책 버전 및 체크아웃 상태.
  • ProviderEvent: 웹훅 페이로드 감사 및 제공업체 이벤트 중복 방지.
  • RefundAttempt: 멱등 제공업체 환불 처리 상태.
  • MerchantLegalProfile: 판매자 고지와 버전이 지정된 약관, 개인정보, 환불 및 청약 철회 링크.
  • ProfilePaymentData, Card: 호환 흐름을 위해 유지되는 선택적 저장 결제 메타데이터.

​
제공업체 라우팅

라우팅 계층은 제공업체와 통화 이름을 정규화하고 계정 기능을 검증하며 지원되지 않는 조합을 거부합니다. 새로운 연동에서는 게이트웨이 계정과 결제 경로를 사용하십시오. 비즈니스당 제공업체 하나를 사용하던 기존 설정은 보수적인 USD/KRW 규칙과 함께 호환 경로로 유지됩니다.

​
주요 경로

  • /payment/checkout/: 요청 상황에 따라 직원, 고객 또는 비회원 체크아웃.
  • /payment/purchases/: 직원용 구매 기록.
  • /payment/settings/: 직원용 제공업체 및 결제 설정.
  • /payment/payment-refund/: 환불 요청.
  • /payment/stripe-intent/: Stripe Intent 생성/확인 흐름.
  • /payment/webhooks/stripe/, /payment/webhooks/paypal/, /payment/webhooks/portone/: 서명되거나 재시도되는 제공업체 이벤트.
  • /payment/ajax/...: 장바구니 생성, 개수, 삭제 및 수량 변경.
제공업체 콜백은 체크아웃 시도를 결제 완료로 표시하고 제공 작업을 실행하기 전에 저장된 서버 금액과 통화를 검증합니다. ProviderEvent는 동일한 제공업체 이벤트가 두 번 적용되지 않도록 합니다.