v3_pay
테이블 (15)
Checkout Mandate-like (checkout_mandates)
- Checkout Mandate-like (id) — char(36) — 기본 키 — NOT NULL — Checkout Mandate-like 식별자
- 승인 세션 참조 (authorization_session_id) — char(36) — 외래 키 → 결제 승인 세션.결제 승인 세션 — NOT NULL — 승인 세션 식별자 [UQ uq_checkout_mandates_session]
- Mandate 고유 식별자 (jti) — varchar(100) — NOT NULL — Mandate 고유 토큰 ID [UQ uq_checkout_mandates_jti]
- 발급자 (issuer) — varchar(200) — NOT NULL — 발급자
- 수신 Merchant (audience) — varchar(200) — NOT NULL — 대상자
- Checkout Hash (checkout_digest) — char(64) — NOT NULL — 승인된 Checkout Digest [IDX]
- 암호화된 서명 Artifact (signed_artifact_encrypted) — text — NOT NULL — 암호화된 서명 Artifact
- Artifact Hash (artifact_hash) — char(64) — NOT NULL — Artifact 해시
- Mandate 상태 (status) — varchar(20) — NOT NULL — Mandate 상태
- 발급 시각 (issued_at) — datetime(6) — NOT NULL — 발급 시각
- 만료 시각 (expires_at) — datetime(6) — NOT NULL — 만료 시각
Merchant 계정 (merchant_accounts)
- Merchant 계정 (id) — char(36) — 기본 키 — NOT NULL — 내부 Merchant 계정 ID
- 외부 Merchant 식별자 (merchant_id) — varchar(100) — NOT NULL — 외부 Merchant ID [UQ uq_merchant_accounts_merchant_id]
- Merchant 표시명 (display_name) — varchar(200) — NOT NULL — Merchant 표시 이름
- Merchant 인증 방식 (auth_type) — varchar(30) — NOT NULL — Merchant 인증 방식
- Merchant 인증정보 참조 (credential_ref) — varchar(255) — 비밀 저장소의 Credential 참조
- Merchant 계정 상태 (status) — varchar(20) — NOT NULL — Merchant 계정 상태
- 생성 시각 (created_at) — datetime(6) — NOT NULL — 생성 시각
- 수정 시각 (updated_at) — datetime(6) — NOT NULL — 수정 시각
PG 거래 (pg_transactions)
- PG 거래 (id) — char(36) — 기본 키 — NOT NULL — PG 거래 기록 식별자
- 결제 시도 참조 (payment_attempt_id) — char(36) — 외래 키 → 결제 시도.결제 시도 — NOT NULL — 결제 시도 식별자 [UQ uq_pg_transactions_attempt_id]
- PG 거래 식별자 (pg_transaction_id) — varchar(150) — PG가 발급한 거래 ID(UNKNOWN이면 NULL일 수 있음) [UQ uq_pg_transactions_external_id]
- PG 처리 상태 (status) — varchar(20) — NOT NULL — PG 거래 상태 [IDX]
- PG 응답 코드 (response_code) — varchar(100) — PG 응답 코드
- 요청 시각 (requested_at) — datetime(6) — NOT NULL — PG 요청 시각
- 완료 시각 (completed_at) — datetime(6) — PG 처리 완료 시각
- 마지막 조회 시각 (last_checked_at) — datetime(6) — PG 상태 마지막 확인 시각
Payment Mandate-like (payment_mandates)
- Payment Mandate-like (id) — char(36) — 기본 키 — NOT NULL — Payment Mandate-like 식별자
- 승인 세션 참조 (authorization_session_id) — char(36) — 외래 키 → 결제 승인 세션.결제 승인 세션 — NOT NULL — 승인 세션 식별자 [UQ uq_payment_mandates_session]
- Mandate 고유 식별자 (jti) — varchar(100) — NOT NULL — Mandate 고유 토큰 ID [UQ uq_payment_mandates_jti]
- 결제 거래 참조 (transaction_id) — varchar(100) — NOT NULL — 결제 트랜잭션 참조 [UQ uq_payment_mandates_transaction_id]
- Merchant 식별자 (merchant_id) — varchar(100) — NOT NULL — 외부 Merchant ID [IDX]
- Checkout 식별자 (external_checkout_id) — varchar(150) — NOT NULL — Merchant Checkout ID [IDX]
- 결제 금액 (amount_minor) — bigint unsigned — NOT NULL — 허용 금액(minor unit)
- 통화 (currency) — char(3) — NOT NULL — 허용 통화 코드
- 결제수단 토큰 스냅샷 (payment_method_ref) — varchar(255) — NOT NULL — payment_methods.provider_token_ref 스냅샷
- 암호화된 서명 Artifact (signed_artifact_encrypted) — text — NOT NULL — Credential에 포함될 서명 Artifact
- Artifact Hash (artifact_hash) — char(64) — NOT NULL — Artifact 해시
- Mandate 상태 (status) — varchar(20) — NOT NULL — Mandate 상태
- 발급 시각 (issued_at) — datetime(6) — NOT NULL — 발급 시각
- 만료 시각 (expires_at) — datetime(6) — NOT NULL — 만료 시각
검증된 Checkout 증거 (pay_verified_checkout_evidence)
- 검증된 Checkout 증거 (id) — char(36) — 기본 키 — NOT NULL — 검증된 Checkout 증거 식별자
- 승인 세션 참조 (authorization_session_id) — char(36) — 외래 키 → 결제 승인 세션.결제 승인 세션 — NOT NULL — 승인 세션 식별자 [UQ uq_checkout_evidence_session]
- Merchant 식별자 (merchant_id) — varchar(100) — NOT NULL — 외부 Merchant ID [UQ uq_checkout_evidence_identity] [IDX]
- Checkout 식별자 (external_checkout_id) — varchar(150) — NOT NULL — Merchant Checkout ID [UQ uq_checkout_evidence_identity] [IDX]
- Checkout Hash (checkout_digest) — char(64) — NOT NULL — 검증된 Checkout Digest [UQ uq_checkout_evidence_identity]
- 검증된 Checkout 원문 요약 (canonical_checkout_json) — json — NOT NULL — 검증 당시 Checkout 원문
- Merchant 서명 참조 (merchant_authorization) — text — NOT NULL — Merchant 서명 또는 인증 정보
- 서명 알고리즘 (signature_algorithm) — varchar(30) — NOT NULL — 서명 알고리즘
- 서명 검증 결과 (signature_verified) — boolean — NOT NULL — 서명 검증 성공 여부
- Merchant가 확정한 금액 (amount_minor) — bigint unsigned — NOT NULL — 검증된 금액(minor unit)
- 통화 (currency) — char(3) — NOT NULL — 검증된 통화 코드
- 검증 시각 (verified_at) — datetime(6) — NOT NULL — 검증 시각
- 증거 만료 시각 (expires_at) — datetime(6) — NOT NULL — 증거 만료 시각
결제 (payments)
- Payment (id) — char(36) — 기본 키 — NOT NULL — 논리적 결제 식별자
- Merchant 계정 참조 (merchant_account_id) — char(36) — 외래 키 → Merchant 계정.Merchant 계정 — NOT NULL — Merchant 계정 식별자 [UQ uq_payments_merchant_idempotency,uq_payments_live_purchase_request]
- Checkout 식별자 (external_checkout_id) — varchar(150) — NOT NULL — Merchant Checkout ID
- 구매 요청 식별자 (purchase_request_id) — char(36) — NOT NULL — Core 구매 요청 ID [IDX]
- Payment Credential 참조 (credential_token_id) — char(36) — 외래 키 → 일회성 Payment Credential.일회성 Payment Credential — NOT NULL — 사용한 Credential 식별자 [UQ uq_payments_credential_token]
- 결제 금액 (amount_minor) — bigint unsigned — NOT NULL — 결제 금액(minor unit)
- 통화 (currency) — char(3) — NOT NULL — 결제 통화 코드
- Payment 상태 (status) — varchar(20) — NOT NULL — READY, PROCESSING, SUCCESS, FAILED, UNKNOWN [IDX]
- 결제 멱등성 키 (idempotency_key) — varchar(100) — NOT NULL — Merchant 멱등성 키 [UQ uq_payments_merchant_idempotency]
- 결제 요청 해시 (request_hash) — char(64) — NOT NULL — 결제 요청 본문 해시
- 생성 시각 (created_at) — datetime(6) — NOT NULL — 생성 시각
- 수정 시각 (updated_at) — datetime(6) — NOT NULL — 수정 시각
- 동시성 버전 (version) — int unsigned — NOT NULL — 낙관적 잠금 버전
- live_purchase_request_key — char(36) — [UQ uq_payments_live_purchase_request] [GENERATED]
결제 PIN 자격증명 (payment_pin_credentials)
- 결제 PIN 자격증명 (id) — char(36) — 기본 키 — NOT NULL — 결제 PIN 자격증명 식별자
- 사용자 식별자(Core 외부 참조) (user_id) — char(36) — NOT NULL — Core 사용자 ID(외부 참조) [UQ uq_payment_pin_credentials_user] [IDX]
- PIN 해시 (pin_hash) — varchar(255) — NOT NULL — PIN 해시만 저장
- PIN 연속 실패 횟수 (failed_attempts) — int unsigned — NOT NULL — 연속 실패 횟수
- PIN 잠금 해제 시각 (locked_until) — datetime(6) — 잠금 해제 시각
- PIN 자격증명 상태 (status) — varchar(20) — NOT NULL — PIN 자격증명 상태
- 수정 시각 (updated_at) — datetime(6) — NOT NULL — 수정 시각
결제 결과 대사 작업 (payment_reconciliation_jobs)
- 결제 결과 대사 작업 (id) — char(36) — 기본 키 — NOT NULL — 결제 대사 작업 식별자
- 결제 시도 참조 (payment_attempt_id) — char(36) — 외래 키 → 결제 시도.결제 시도 — NOT NULL — 대상 결제 시도 식별자 [UQ uq_reconciliation_jobs_attempt_reason] [IDX]
- 대사 사유 (reason) — varchar(100) — NOT NULL — 대사 사유 [UQ uq_reconciliation_jobs_attempt_reason]
- 대사 작업 상태 (status) — varchar(20) — NOT NULL — 대사 작업 상태 [IDX]
- 다음 실행 시각 (next_run_at) — datetime(6) — NOT NULL — 다음 실행 시각 [IDX]
- 대사 재조회 횟수 (attempt_count) — int unsigned — NOT NULL — 대사 시도 횟수
- Worker Lease 만료 시각 (lease_expires_at) — datetime(6) — 워커 lease 만료 시각 [IDX]
- 마지막 실행 시각 (last_run_at) — datetime(6) — 마지막 실행 시각
- 마지막 오류 (last_error) — text — 마지막 오류
결제 승인 세션 (authorization_sessions)
- 결제 승인 세션 (id) — char(36) — 기본 키 — NOT NULL — 결제 승인 세션 식별자
- 구매 요청 식별자 (purchase_request_id) — char(36) — NOT NULL — Core 구매 요청 ID(외부 참조) [IDX]
- 사용자 식별자 (user_id) — char(36) — 외래 키 → 결제수단.사용자 식별자(Core 외부 참조) — NOT NULL — Core 사용자 ID(외부 참조)
- Merchant 계정 참조 (merchant_account_id) — char(36) — 외래 키 → Merchant 계정.Merchant 계정 — NOT NULL — Merchant 계정 식별자 [UQ uq_authorization_sessions_idempotency,uq_authorization_sessions_active_purchase_request] [IDX]
- Merchant Checkout 참조 (external_checkout_id) — varchar(150) — NOT NULL — Merchant Checkout ID(외부 참조)
- Checkout Hash 내부 표현 (checkout_digest) — char(64) — NOT NULL — Checkout Digest
- 사용자에게 표시한 주문 요약 (display_snapshot) — json — NOT NULL — 사용자 승인 화면에 표시한 상품·옵션·수량 스냅샷
- 승인 대상 금액 (amount_minor) — bigint unsigned — NOT NULL — 최종 금액(minor unit)
- 통화 (currency) — char(3) — NOT NULL — ISO 통화 코드
- 선택 결제수단 참조 (selected_payment_method_id) — char(36) — 외래 키 → 결제수단.결제수단 식별자 — 선택 결제수단 식별자(결제수단 등록 전 NULL) [IDX]
- 승인 세션 상태 (status) — varchar(30) — NOT NULL — 승인 세션 상태(결제수단 없음: PAYMENT_METHOD_REQUIRED)
- 승인 세션 멱등성 키 (idempotency_key) — varchar(100) — NOT NULL — 승인 세션 생성 멱등성 키 [UQ uq_authorization_sessions_idempotency]
- 승인 요청 해시 (request_hash) — char(64) — NOT NULL — 승인 세션 생성 요청 본문 해시
- 다음 인증 수단 (required_action) — varchar(20) — NOT NULL — BIOMETRIC 또는 PIN
- 승인 세션 만료 시각 (expires_at) — datetime(6) — NOT NULL — 승인 세션 만료 시각
- 승인 시각 (approved_at) — datetime(6) — 승인 완료 시각
- 최종 성공 인증 방식 (auth_method) — varchar(20) — 최종 성공 인증 방식
- 생성 시각 (created_at) — datetime(6) — NOT NULL — 세션 생성 시각
- 수정 시각 (updated_at) — datetime(6) — NOT NULL — 세션 수정 시각
- 동시성 버전 (version) — int unsigned — NOT NULL — 낙관적 잠금 버전
- active_purchase_request_key — char(36) — [UQ uq_authorization_sessions_active_purchase_request] [GENERATED]
결제 시도 (payment_attempts)
- 결제 시도 (id) — char(36) — 기본 키 — NOT NULL — 결제 시도 식별자
- Payment 참조 (payment_id) — char(36) — 외래 키 → 결제.Payment — NOT NULL — 결제 식별자 [UQ uq_payment_attempts_number,uq_payment_attempts_operation] [IDX]
- 시도 번호 (attempt_no) — int unsigned — NOT NULL — 결제 시도 번호 [UQ uq_payment_attempts_number]
- 수행 작업 (operation) — varchar(30) — NOT NULL — 결제 작업 종류 [UQ uq_payment_attempts_operation]
- PG 요청 해시 (request_hash) — char(64) — NOT NULL — PG 요청 해시
- PG 요청 식별자(결과 불명 시 없을 수 있음) (pg_request_id) — varchar(150) — PG 요청 ID [UQ uq_payment_attempts_pg_request_id]
- 결제 시도 상태 (status) — varchar(20) — NOT NULL — 시도 상태
- 오류 코드 (error_code) — varchar(100) — 오류 코드
- 시작 시각 (started_at) — datetime(6) — NOT NULL — 시작 시각
- 완료 시각 (completed_at) — datetime(6) — 완료 시각
결제 영수증 (payment_receipts)
- 결제 영수증 (id) — char(36) — 기본 키 — NOT NULL — 결제 영수증 식별자
- Payment 참조 (payment_id) — char(36) — 외래 키 → 결제.Payment — NOT NULL — 결제 식별자 [UQ uq_payment_receipts_payment_id]
- 영수증 Hash (receipt_hash) — char(64) — NOT NULL — 영수증 해시 [UQ uq_payment_receipts_hash]
- 영수증 상태 (status) — varchar(20) — NOT NULL — 영수증 상태
- 암호화된 영수증 Artifact (artifact_encrypted) — text — NOT NULL — 암호화된 영수증 Artifact
- 발급 시각 (issued_at) — datetime(6) — NOT NULL — 발급 시각
결제수단 (payment_methods)
- 결제수단 식별자 (id) — char(36) — 기본 키 — NOT NULL — 결제수단 식별자 [UQ uq_payment_methods_id_user]
- 사용자 식별자(Core 외부 참조) (user_id) — char(36) — NOT NULL — Core 사용자 ID(외부 참조) [UQ uq_payment_methods_id_user] [IDX]
- 결제수단 제공자 (provider) — varchar(50) — NOT NULL — 결제수단 제공자 [UQ uq_payment_methods_provider_token]
- PG 토큰 참조 (provider_token_ref) — varchar(255) — NOT NULL — PG Token 참조(카드 원문 아님) [UQ uq_payment_methods_provider_token]
- 카드 브랜드 (brand) — varchar(30) — 카드 브랜드
- 카드 끝 4자리 (last4) — char(4) — 카드 끝 4자리
- 유효기간 월 (expiry_month) — tinyint unsigned — 유효기간 월
- 유효기간 연도 (expiry_year) — smallint unsigned — 유효기간 연도
- 결제수단 상태 (status) — varchar(20) — NOT NULL — 결제수단 상태
- 기본 결제수단 여부 (is_default) — boolean — NOT NULL — 기본 결제수단 여부
- 소프트 삭제 시각 (deleted_at) — datetime(6) — 소프트 삭제 시각
- active_default_user_key — char(36) — [UQ uq_payment_methods_active_default_user] [GENERATED]
생체인증 Challenge (biometric_challenges)
- 생체인증 Challenge (id) — char(36) — 기본 키 — NOT NULL — 생체인증 Challenge 식별자
- 생체인증 자격증명 참조 (biometric_credential_id) — char(36) — 외래 키 → 생체인증 자격증명.생체인증 자격증명 — NOT NULL — 생체인증 자격증명 식별자 [IDX]
- 승인 세션 참조 (authorization_session_id) — char(36) — 외래 키 → 결제 승인 세션.결제 승인 세션 — NOT NULL — 승인 세션 식별자 [IDX]
- Challenge 해시 (challenge_hash) — char(64) — NOT NULL — Challenge 해시 [UQ uq_biometric_challenges_hash]
- Challenge 상태 (status) — varchar(20) — NOT NULL — PENDING, SUCCESS, FAILED, EXPIRED
- Challenge 만료 시각 (expires_at) — datetime(6) — NOT NULL — Challenge 만료 시각
- 사용 시각 (used_at) — datetime(6) — 사용 시각
- 생성 시각 (created_at) — datetime(6) — NOT NULL — Challenge 생성 시각
생체인증 자격증명 (biometric_credentials)
- 생체인증 자격증명 (id) — char(36) — 기본 키 — NOT NULL — 생체인증 자격증명 식별자
- 사용자 식별자(Core 외부 참조) (user_id) — char(36) — NOT NULL — Core 사용자 ID(외부 참조) [IDX]
- 등록 기기 식별자 (device_id) — varchar(150) — NOT NULL — 등록 기기 식별자
- 기기 공개키 (public_key) — text — NOT NULL — 기기 공개키
- 생체인증 상태 (status) — varchar(20) — NOT NULL — 생체인증 자격증명 상태
- 등록 시각 (registered_at) — datetime(6) — NOT NULL — 등록 시각
- 폐기 시각 (revoked_at) — datetime(6) — 폐기 시각
- active_user_device_key — varchar(190) — [UQ uq_biometric_credentials_active_user_device] [GENERATED]
일회성 Payment Credential (payment_credential_tokens)
- 일회성 Payment Credential (id) — char(36) — 기본 키 — NOT NULL — Payment Credential 토큰 식별자
- 승인 세션 참조 (authorization_session_id) — char(36) — 외래 키 → 결제 승인 세션.결제 승인 세션 — NOT NULL — 승인 세션 식별자 [UQ uq_payment_credentials_session]
- Checkout Mandate 참조 (checkout_mandate_id) — char(36) — 외래 키 → Checkout Mandate-like.Checkout Mandate-like — NOT NULL — Checkout Mandate-like 식별자 [UQ uq_payment_credentials_checkout_mandate]
- Payment Mandate 참조 (payment_mandate_id) — char(36) — 외래 키 → Payment Mandate-like.Payment Mandate-like — NOT NULL — Payment Mandate-like 식별자 [UQ uq_payment_credentials_payment_mandate]
- Credential Token Hash (token_hash) — char(64) — NOT NULL — Credential 토큰 해시 [UQ uq_payment_credentials_token_hash]
- 암호화된 Credential Artifact (token_ciphertext) — text — NOT NULL — KMS Envelope Encryption 토큰 본문
- Merchant 식별자 (merchant_id) — varchar(100) — NOT NULL — 외부 Merchant ID
- Checkout 식별자 (external_checkout_id) — varchar(150) — NOT NULL — Merchant Checkout ID
- Checkout Hash (checkout_digest) — char(64) — NOT NULL — Checkout Digest
- 결제 금액 (amount_minor) — bigint unsigned — NOT NULL — 허용 금액(minor unit)
- 통화 (currency) — char(3) — NOT NULL — 허용 통화 코드
- Credential 상태 (status) — varchar(20) — NOT NULL — ISSUED, CONSUMED, EXPIRED, REVOKED [IDX]
- 발급 시각 (issued_at) — datetime(6) — NOT NULL — 발급 시각
- 만료 시각 (expires_at) — datetime(6) — NOT NULL — 만료 시각 [IDX]
- 소비 시각 (consumed_at) — datetime(6) — 소비 시각