--- title: "Stripe 결제 플로우 (Checkout Session Redirect)" --- sequenceDiagram actor Customer participant Client as Client
(standard-checkout) participant ShopAPI as Shop API
(makitt-shop-api) participant PayAPI as Payment API
(makitt-payment-api) participant Stripe as Stripe Note over Customer, Stripe: Phase 1: 결제 준비 (Prepare) Customer->>Client: 결제 버튼 클릭 Client->>ShopAPI: POST /checkout/{id}/payments/prepare ShopAPI->>ShopAPI: checkoutApp.resolveOrderForPayment()
→ Order 생성/조회 Note right of ShopAPI: Order: PAYMENT_PENDING ShopAPI->>PayAPI: POST /payments/prepare-for-order/{orderId} PayAPI->>PayAPI: Payment 생성 PayAPI->>Stripe: Create Checkout Session
(amount, currency, successUrl, cancelUrl) Stripe-->>PayAPI: { sessionId, url } PayAPI->>PayAPI: Payment.attachProcessorReference()
Order.attachPaymentReferences() Note right of PayAPI: Payment: ACTION_REQUIRED
Order: sessionId 부착 PayAPI-->>ShopAPI: { redirectUrl, paymentId } ShopAPI->>ShopAPI: checkout.startPayment() Note right of ShopAPI: Checkout: DONE ShopAPI-->>Client: PaymentSessionResponse Note over Customer, Stripe: Phase 2: 결제 진행 (Redirect) Client->>Client: orchestrator: session.redirectUrl 감지 Client->>Stripe: window.location.href = redirectUrl Stripe->>Customer: Stripe Hosted Payment Page 표시 Customer->>Stripe: 카드 정보 입력 & 결제 Stripe->>Client: redirect → successUrl Note over Customer, Stripe: Phase 3a: Reconcile (Client-initiated) Client->>ShopAPI: POST /payments/{paymentId}/reconcile ShopAPI->>PayAPI: POST /payments/{paymentId}/reconcile PayAPI->>Stripe: Retrieve Checkout Session Stripe-->>PayAPI: { status: "paid" } PayAPI->>PayAPI: Payment.markSucceeded()
Order.markOrderPaid()
Checkout.complete() Note right of PayAPI: Payment: SUCCEEDED
Order: PAID
Checkout: COMPLETED PayAPI-->>ShopAPI: PaymentSessionResponse ShopAPI-->>Client: 결제 완료 Note over Customer, Stripe: Phase 3b: Webhook (Stripe-initiated, 비동기) Stripe--)PayAPI: POST /v1/webhooks/stripe/{shopId}
event: payment_intent.succeeded PayAPI->>PayAPI: Payment.markSucceeded()
Order.markOrderPaid()
Checkout.complete() Note right of PayAPI: (Reconcile과 경합 가능 → OS 409)