AI 구독 구매를 상태 머신(State Machine)으로 모델링하기: 개발자를 위한 실무 체크리스트

AI 구독을 구매하는 과정은 무언가 지연되기 전까지는 단순한 결제 흐름처럼 보입니다. 하지만 지연이 발생하면 구매자, 결제 제공업체(Payment Provider), 스토어프론트(Storefront), 그리고 구독 제공업체(Subscription Provider)가 각각 서로 다른 상태를 보여줄 수 있습니다.

개발자들은 이미 이 문제에 대해 유용한 멘탈 모델(Mental Model)을 가지고 있습니다. 구매를 단 한 번의 되돌릴 수 없는 버튼 클릭이 아니라, 이벤트 로그(Event Log)를 가진 상태 머신(State Machine)으로 취급하는 것입니다.

이 글은 해당 모델을 설명하고 이를 구매자 체크리스트로 변환합니다. 이는 구매 경로에 제3자 스토어프론트, 수동 결제 검토, 리뎀션(Redemption) 단계 또는 비동기적 이행(Asynchronous Fulfillment)이 포함될 때 특히 유용합니다.

예외를 디버깅하기 전에 상태를 정의하세요

최소한의 구매 라이프사이클(Lifecycle)은 다음과 같을 수 있습니다:

DRAFT
  -> AWAITING_PAYMENT
  -> PAYMENT_REPORTED
...

중요한 세부 사항은 PAYMENT_REPORTED와 PAYMENT_CONFIRMED가 서로 다른 상태라는 점입니다.

스토어프론트가 콜백(Callback)이나 수동 검토를 기다리는 동안에도 구매자는 은행, 지갑 또는 암호화폐 이체를 완료할 수 있습니다. 마찬가지로, 결제가 확인되었다고 해서 최종 구독 권한(Entitlement)이 목적지 계정에 이미 나타났다는 것을 의미하지는 않습니다.

이러한 상태들이 단일한 "결제 완료(Paid)" 라벨로 통합되면, 사람들은 종종 최악의 재시도(Retry)를 하게 됩니다. 즉, 기존 주문을 확인하기도 전에 다시 결제하는 것입니다.

규모가 작더라도 이벤트 로그를 유지하세요

고객 지원(Support)에 용이한 구매 기록 버전은 복잡하지 않습니다:

type PurchaseEvent = {
  orderId: string;
  event: ...

구매자가 이 객체를 문자 그대로 구축할 필요는 없습니다. 동일한 필드를 포함하는 메모만으로도 충분합니다:

주문 번호(Order number).
주문 조회 비밀번호 또는 보안 조회 방법.
제품 및 플랜 이름.
결제 금액 및 시간.
결제 참조(Payment reference), 영수증 또는 트랜잭션 해시(Transaction hash).
현재 스토어프론트 상태.
현재 목적지 계정 상태.
개인 자격 증명이 아닌 상태를 보여주는 스크린샷.

이는 관찰된 사실 (observed facts)과 가정 (assumptions)을 분리합니다. “결제 앱에 성공이라고 표시됨”은 관찰된 사실입니다. “판매자가 결제를 수령하고 매칭함”은 여전히 확인이 필요한 별도의 상태입니다.

재시도(Retries)를 멱등(Idempotent)하게 만들기

분산 시스템 (distributed systems)에서 안전한 재시도는 두 번째 부작용 (side effect)을 생성해서는 안 됩니다. 결제 흐름 (checkout flows)이 구매자에게 항상 그러한 보장을 제공하는 것은 아닙니다.

다시 결제하기 전에:

기존 주문을 엽니다.
결제가 이미 보고되었는지 확인합니다.
결제 확인 또는 이행 대기 (fulfillment-pending) 상태를 찾습니다.
명시된 처리 시간 (processing window)이 있다면 기다립니다.
원래 주문 ID와 결제 증거를 가지고 고객 지원팀에 문의합니다.

첫 번째 주문이 명시적으로 취소되었거나, 결제 없이 만료되었거나, 또는 고객 지원팀에서 새로운 시도가 필요하다고 확인한 경우에만 새 주문을 생성하십시오.

이 규칙은 “즉시 배송”에 대한 그 어떤 약속보다 유용합니다. 실제 시스템에는 지연된 웹훅 (webhooks), 재고 잠금 (inventory locks), 이메일 지연, 사기 검토 (fraud review), 네트워크 확인 (network confirmations), 또는 제공자 측의 상태 전파 (state propagation)가 발생할 수 있기 때문입니다.

채팅 스크린샷을 데이터베이스로 사용하지 마세요

채팅 메시지는 사례를 설명하는 데 도움이 될 수 있지만, 거래의 유일한 기록이 되어서는 안 됩니다.

더 나은 구매 경로 (buying path)는 다음을 노출합니다:

지속적인 주문 식별자 (order identifier).
오래된 채팅 스레드를 검색하지 않고도 주문을 조회할 수 있는 방법.
현재 주문 상태.
배송 또는 이행 (fulfillment) 기록.
서면으로 된 고객 지원 및 환불 경계.

예를 들어, PayForGPT는 공개된 ChatGPT Plus 구매 및 증거 체크리스트와 별도의 주문 조회 페이지를 제공합니다. 이 페이지들은 플랜 선택과 이후의 주문 조회 과정을 분리하기 때문에 운영상의 예시로서 유용합니다.

이것이 PayForGPT를 OpenAI의 공식 서비스로 만드는 것은 아니며, 결제 전 현재의 제품 페이지, 배송 안내(delivery notes), 약관을 읽어야 할 필요성을 없애주는 것도 아닙니다.

증거를 수집하는 동안 자격 증명(credentials) 보호하기

좋은 증거가 반드시 최대치의 증거를 의미하는 것은 아닙니다.

지원 메시지에 계정 비밀번호, 일회용 코드(one-time codes), API 키, 복구 코드(recovery codes), 브라우저 쿠키 또는 장기 세션 자격 증명(long-lived session credentials)을 붙여넣지 마세요. 스크린샷을 자를 때는 관련 상태와 타임스탬프(timestamp)가 보이도록 하되, 관련 없는 개인 데이터가 노출되지 않도록 하세요.

결제 검토(payment review)를 위해 지원팀은 보통 거래 증거와 주문 식별자(order identifier)를 필요로 합니다. 배송 검토(delivery review)를 위해 지원팀은 보통 주문 상태(order state)와 대상 계정의 가시적인 권한 상태(entitlement state)를 필요로 합니다. 워크플로우(workflow)에서 그 이상의 정보를 요구한다면, 전송하기 전에 잠시 멈추고 그 이유를 파악하세요.

실무적인 예외 체크리스트

결제는 성공했으나 배송이 지연되는 것으로 보일 때:

결제를 반복하지 마세요.
원래의 주문 ID(order ID)와 조회 방법을 저장하세요.
결제 시간, 금액 및 참조(reference)를 저장하세요.
주문 페이지에서 최신 서버 측 상태(server-side state)를 확인하세요.
이메일 배송이 흐름의 일부인 경우에만 스팸함이나 필터링된 이메일을 확인하세요.
대상 계정의 현재 상태를 캡처하세요.
증거 번들(evidence bundle)이 포함된 지원 요청을 한 번만 보내세요.
서면으로 된 해결책(resolution)을 원래의 주문 기록과 함께 보관하세요.

교환(redemption) 단계에서 오류가 보고되면, 정확한 오류 텍스트와 교환 타임스탬프를 추가하세요. 여러 계정에 걸쳐 유효하지 않거나 이미 사용된 코드를 계속해서 재시도하지 마세요.

구매 경로를 선택하기 전에 평가해야 할 사항

가장 저렴한 경로가 자동으로 가장 비용이 낮은 경로인 것은 아닙니다. 다음을 비교하세요:

본인의 계정을 사용할 수 있는지 여부.
결제 수단이 추적 가능한 영수증을 남기는지 여부.
주문을 계속 조회(retrievable)할 수 있는지 여부.
배송 메커니즘(delivery mechanism)이 설명되어 있는지 여부.
예외 처리(exception handling)가 문서화되어 있는지 여부.
지원 범위(support boundary)가 명확한지 여부.
환불 또는 교체 조건이 명시되어 있는지 여부.

만약 해당 필드들이 누락되어 있다면, 비정상적으로 낮은 가격을 기술적 이점(technical advantage)으로 간주해서는 안 됩니다.

최종 모델 (Final model)

가장 신뢰할 수 있는 질문은 "내가 결제 버튼을 눌렀는가?"가 아닙니다.

그것은 바로 다음과 같습니다:

이 주문은 어떤 상태(state)에 있으며, 어떤 이벤트(event)가 주문을 해당 상태로 이동시켰고, 그 이벤트를 증명할 수 있는 근거는 무엇인가?

이 질문은 스트레스가 심한 구매 문제를 일반적인 디버깅 워크플로우(debugging workflow)로 전환해 줍니다. 또한 지원 팀(support teams)이 구매자에게 전체 거래 내역을 기억해 내라고 요청하지 않고도, 예외 사항(exception)을 해결할 수 있도록 충분한 구조화된 정보를 제공합니다.

공개 사항 (Disclosure)

저자는 PayForGPT의 콘텐츠 및 제품 운영에 기여하고 있습니다. PayForGPT는 독립적인 제3자 스토어이며, OpenAI와 제휴하거나 OpenAI의 승인을 받지 않았습니다. 제품 가용성, 배송 조건 및 가격은 구매 전 현재 페이지에서 확인해야 합니다.

Insights