ADR-DS-040_Verification Method 전이 규칙

ADR-DS-040_Verification Method 전이 규칙

ADR-DS-040 Verification Method 전이 규칙

1. Metadata

  • ADR ID: ADR-DS-040
  • Title: Verification Method 전이 규칙
  • Status: draft
  • Date: 2026-03-08
  • Owner: YSY
  • Related ADRs: ADR-DS-010, ADR-DS-030, ADR-DS-070, ADR-DS-140
  • Supersedes:
  • Superseded By:

2. Context

검증 방식과 결제 방식을 분리하지 않으면 redeemed 전이 시점이 일관되지 않다.

3. Decision

  1. verification_methodnone, location, qr로 고정한다.
  2. payment_method=prepaid는 결제 성공 시 즉시 redeemed로 전이한다.
  3. payment_method=on_site에서만 verification 전이를 적용한다.
  4. on_site + none은 예약 확정 시 즉시 redeemed로 전이한다.
  5. on_site + location은 위치 검증 성공 시 redeemed로 전이한다.
  6. 위치 검증 실패 시 QR 폴백을 기본 경로로 적용한다.
  7. on_site + qr은 QR 스캔 성공 시 redeemed로 전이한다.
  8. 파트너 보조 검증은 상태 전이를 추가하지 않고 redeemed 이후 증적 기록으로만 처리한다.
  9. 보조 검증 필드는 partner_verified, partner_verified_at, partner_verified_by_store_id로 고정한다.
  10. 보조 검증 요청은 같은 예약에 대해 멱등 처리한다.

4. Consequences / Impact

  1. 결제 방식과 검증 방식의 책임 경계가 명확해진다.
  2. 위치 실패 시 폴백 경로가 고정되어 운영 혼선을 줄일 수 있다.
  3. 상태 모델 단순성을 유지하면서 사후 분쟁 대응 증적을 확보할 수 있다.

5. Validation

  • prepaid 결제 성공 시 즉시 redeemed 전이가 동작한다.
  • on_site에서 verification_method별 전이 경로가 정의되어 있다.
  • 위치 실패 시 QR 폴백 경로가 정상 동작한다.
  • redeemed 이전 보조 검증 요청은 차단된다.
  • 보조 검증 중복 요청 시 데이터가 중복 생성되지 않는다.