billing_service(toss&stripe)
테이블 (9)
Copy Of toss_history (CopyOf토스 이력)
- toss_history_no (토스 이력 번호) — bigint — 기본 키 — NOT NULL
- version (결제 버전) — varchar(30)
- paymentKey (결제 키) — varchar(200) — 결제를 식별하는 역할로, 중복되지 않는 고유한 값. 결제 승인, 결제 조회, 결제 취소 시 사용
- type (결제 타입) — varchar(30) — NORMAL(일반결제), BILLING(자동결제), BRANDPAY(브랜드페이)
- order_id (주문 번호) — varchar(64) — 결제 상태가 변해도 orderId는 유지 됨
- order_name (구매 상품) — varchar(100)
- m_id (상점 ID) — varchar(20)
- currency (결제 통화) — varchar(50)
- method (결제 수단) — varchar(30) — 카드, 가상계좌, 간편결제, 휴대폰, 계좌이체, 문화상품권, 도서문화상품권, 게임문화상품권 중 하나
- total_amount (총 결제 금액) — int
- balance_amount (취소할 수 있는 금액) — int — 결제 취소나 부분 취소가 되고 나서 남은 값. 결제 상태 변화에 따라 vat, supplied_amount, taxFree_amount, tax_exemption_amount와 함께 값이 변함
- status (결제 처리 상태) — varchar(30)
- requested_at (결제 발생 일시) — datetime
- approved_at (결제 승인 일시) — datetime
- use_escrow (에스크로 사용 여부) — boolean
- last_transaction_key (마지막 거래의 키 값) — varchar(64) — 한 결제 건의 승인 거래와 취소 거래를 구분하는 데 사용
- supplied_amount (공급가액) — int — 결제 취소 및 부분 취소가 되면 공급가액도 일부 취소되어 값이 바뀜
- vat (부가세) — int — 결제 취소 및 부분 취소가 되면 부가세도 일부 취소되어 값이 바뀜
- culture_expense (문화비 지출 여부) — boolean — 계좌이체, 가상계좌 결제에만 적용.
- tax_free_amount (면세 금액) — int — 결제 금액 중 면세 금액입니다. 결제 취소 및 부분 취소가 되면 면세 금액도 일부 취소되어 값 변경
- tax_exemption_amount (과세 제외 금액) — int — 과세를 제외한 결제 금액
- cancels (결제 취소) — object
- is_partial_cancelable (부분 취소 가능 여부) — boolean — false이면 전액 취소만 가능
- card (카드 정보) — object — 카드로 결제하면 제공되는 카드 관련 정보
- virtualAccount (가상 계좌 정보) — object — 가상계좌로 결제하면 제공되는 가상계좌 관련 정보
- secret (웹 훅 검증 값) — varchar(50) — 결제 상태 웹훅 이벤트로 돌아오는 Payment 객체의 secret과 같으면 정상적인 웹훅
- mobile_phone (휴대폰 결제 정보) — object — 휴대폰으로 결제하면 제공되는 휴대폰 결제 관련 정보
- gift_certificate (상품권 결제 정보) — object — 상품권으로 결제하면 제공되는 상품권 결제 관련 정보
- transfer (계좌이체 결제 정보) — object — 계좌이체로 결제했을 때 이체 정보가 담기는 객체
- metadata (결제 정보) — object — 결제 요청 시 SDK에서 직접 추가할 수 있는 결제 관련 정보
- receipt (영수증) — object
- checkout (결제창 정보) — object
- easy_pay (간편결제 정보) — object — 구매자가 선택한 결제수단에 따라 amount, discount_amount가 달라짐
- country (결제 국가) — varchar(10)
- failure (결제 실패 정보) — object
- cash_receipt (현금영수증 정보) — object
- cashReceipts (현금 영수증 이력) — object — 현금영수증 발행 및 취소 이력
- discount (할인 정보) — object — 카드사 및 퀵계좌이체의 즉시 할인 프로모션 정보. 즉시 할인 프로모션이 적용됐을 때만 생성
Copy Of toss_purchased (CopyOf국내 결제)
- toss_purchased_no (국내 결제 번호) — bigint — 기본 키 — NOT NULL
- customer_key (구매자 ID) — varchar(300)
- method (결제 수단) — varchar(50)
- m_id (상점 ID) — varchar(20)
- billing_key (빌링 키) — varchar(200) — NOT NULL — 자동결제에서 카드 정보 대신 사용되는 값. customerKey와 연결됨
- card (카드 정보) — object
- transfers (계좌 정보) — object
- card_company (카드 발급사) — varchar(10)
- card_number (카드 번호) — varchar(20) — 카드 번호 (일부 마스킹)
- authenticated_at (결제 수단 인증 일시) — datetime
Copy Of toss_purchased2 (CopyOf토스 결제)
- toss_purchased_no (토스 결제 번호) — bigint — 기본 키 — NOT NULL
- group_user_no (그룹 유저 번호) — int
- mirror_id (미러 아이디) — varchar(20)
- customer_key (구매자 ID) — varchar(300)
- method (결제 수단) — varchar(50)
- m_id (상점 아이디) — varchar(20)
- subscription_status (구독 상태) — varchar(10) — - 구독 - 취소
- subscription_type (구독 타입) — varhchar(10) — - month - year
- auth_key (일회성 인증 키) — varchar(300)
- billing_key (빌링 키) — varchar(200) — NOT NULL — 자동결제에서 카드 정보 대신 사용되는 값. customerKey와 연결됨
- card (카드 정보) — object
- transfers (계좌 정보) — object
- card_company (카드 발급사) — varchar(10)
- email (이메일) — varchar(100)
- card_number (카드 번호) — varchar(20) — 카드 번호 (일부 마스킹)
- authenticated_at (결제 수단 인증 일시) — datetime
- reg_dt (생성 일시) — datetime
- is_deleted (삭제여부(T|F)) — char(1)
- deleted_dt (삭제 일시) — datetime
Copy Of 토스 결제(국내결제) (CopyOftb_toss_purchased)
- 토스 결제 번호 (toss_purchased_no) — BIGINT — 기본 키 — NOT NULL — 토스 결제 번호
- 그룹 유저 번호 (group_user_no) — BIGINT — 그룹 유저 번호
- 미러 ID (mirror_id) — VARCHAR(20) — NOT NULL — 미러 아이디
- 구매자 키 (customer_key) — VARCHAR(300) — NOT NULL — 구매자 키
- 빌링 키 (billing_key) — VARCHAR(200) — NOT NULL — 빌링 키 | 자동결제 시 카드 정보 대신 사용 (customerKey와 연결)
- 결제 수단 (method) — VARCHAR(50) — 결제 수단
- 상점 ID (m_id) — VARCHAR(20) — 상점 아이디
- 구독 상태 (subscription_status) — VARCHAR(10) — NOT NULL — 구독 상태 | 구독(ACTIVE) / 중지(STOPPED) / 취소(CANCELED)
- 구독 타입 (subscription_type) — VARCHAR(10) — NOT NULL — 구독 타입 | MONTH / YEAR
- 결제 상태 (purchased_status) — VARCHAR(10) — NOT NULL — 결제 상태 | 결제 대기(READY) / 결제 성공(SUCCESS) / 결제 실패(FAILED)
- 청구 금액 (amount) — BIGINT — 청구 금액
- 이메일 (email) — VARCHAR(254) — 이메일
- 결제 수단 인증 일시 (authenticated_at) — DATETIME — 결제 수단 인증 일시
- 다음 청구 예정 일시 (next_billing_at) — DATETIME — 다음 청구 예정 일시
- 마지막 시도 일시 (last_attempt_at) — DATETIME — 마지막 시도 일시(하루 1회 제한)
- 재시도 일시 (retry_until_at) — DATETIME — 실패 후 7일 마감
- 생성 일시 (reg_dt) — DATETIME — 생성 일시
- 수정 일시 (upt_dt) — DATETIME — 수정 일시
- 삭제여부(T|F) (is_deleted) — CHAR(1) — 삭제여부(T|F)
- 삭제 일시 (deleted_dt) — DATETIME — 삭제 일시
toss_history (토스 이력)
- toss_history_no (토스 이력 번호) — bigint — 기본 키 — NOT NULL
- toss_purchased_no (토스 결제 번호) — bigint — NOT NULL
- version (결제 버전) — varchar(30)
- paymentKey (결제 키) — varchar(200) — 결제를 식별하는 역할로, 중복되지 않는 고유한 값. 결제 승인, 결제 조회, 결제 취소 시 사용
- type (결제 타입) — varchar(30) — NORMAL(일반결제), BILLING(자동결제), BRANDPAY(브랜드페이)
- order_id (주문 번호) — varchar(64) — 결제 상태가 변해도 orderId는 유지 됨
- order_name (구매 상품) — varchar(100)
- m_id (상점 ID) — varchar(20)
- currency (결제 통화) — varchar(50)
- method (결제 수단) — varchar(30) — 카드, 가상계좌, 간편결제, 휴대폰, 계좌이체, 문화상품권, 도서문화상품권, 게임문화상품권 중 하나
- balance_amount (취소할 수 있는 금액) — int — 결제 취소나 부분 취소가 되고 나서 남은 값. 결제 상태 변화에 따라 vat, supplied_amount, taxFree_amount, tax_exemption_amount와 함께 값이 변함
- total_amount (총 결제 금액) — bigint
- status (결제 처리 상태) — varchar(30)
- requested_at (결제 발생 일시) — datetime
- approved_at (결제 승인 일시) — datetime
- use_escrow (에스크로 사용 여부) — boolean
- last_transaction_key (마지막 거래의 키 값) — varchar(64) — 한 결제 건의 승인 거래와 취소 거래를 구분하는 데 사용
- supplied_amount (공급가액) — int — 결제 취소 및 부분 취소가 되면 공급가액도 일부 취소되어 값이 바뀜
- vat (부가세) — int — 결제 취소 및 부분 취소가 되면 부가세도 일부 취소되어 값이 바뀜
- culture_expense (문화비 지출 여부) — boolean — 계좌이체, 가상계좌 결제에만 적용.
- tax_free_amount (면세 금액) — int — 결제 금액 중 면세 금액입니다. 결제 취소 및 부분 취소가 되면 면세 금액도 일부 취소되어 값 변경
- tax_exemption_amount (과세 제외 금액) — int — 과세를 제외한 결제 금액
- cancels (결제 취소) — object
- is_partial_cancelable (부분 취소 가능 여부) — boolean — false이면 전액 취소만 가능
- card (카드 정보) — object — 카드로 결제하면 제공되는 카드 관련 정보
- virtualAccount (가상 계좌 정보) — object — 가상계좌로 결제하면 제공되는 가상계좌 관련 정보
- secret (웹 훅 검증 값) — varchar(50) — 결제 상태 웹훅 이벤트로 돌아오는 Payment 객체의 secret과 같으면 정상적인 웹훅
- mobile_phone (휴대폰 결제 정보) — object — 휴대폰으로 결제하면 제공되는 휴대폰 결제 관련 정보
- gift_certificate (상품권 결제 정보) — object — 상품권으로 결제하면 제공되는 상품권 결제 관련 정보
- transfer (계좌이체 결제 정보) — object — 계좌이체로 결제했을 때 이체 정보가 담기는 객체
- metadata (결제 정보) — object — 결제 요청 시 SDK에서 직접 추가할 수 있는 결제 관련 정보
- receipt (영수증) — object
- checkout (결제창 정보) — object
- easy_pay (간편결제 정보) — object — 구매자가 선택한 결제수단에 따라 amount, discount_amount가 달라짐
- country (결제 국가) — varchar(10)
- failure (결제 실패 정보) — object
- cash_receipt (현금영수증 정보) — object
- cashReceipts (현금 영수증 이력) — object — 현금영수증 발행 및 취소 이력
- discount (할인 정보) — object — 카드사 및 퀵계좌이체의 즉시 할인 프로모션 정보. 즉시 할인 프로모션이 적용됐을 때만 생성
toss_purchased (토스 결제)
- toss_purchased_no (토스 결제 번호) — bigint — 기본 키 — NOT NULL
- group_user_no (그룹 유저 번호) — int
- mirror_id (미러 아이디) — varchar(20)
- customer_key (구매자 ID) — varchar(300)
- billing_key (빌링 키) — varchar(200) — NOT NULL — 자동결제에서 카드 정보 대신 사용되는 값. customerKey와 연결됨
- method (결제 수단) — varchar(50)
- m_id (상점 아이디) — varchar(20)
- subscription_status (구독 상태) — varchar(10) — - 구독 - 취소
- subscription_type (구독 타입) — varhchar(10) — - month - year
- purchased_status (결제 상태) — varchar(10) — 결제 성공 결제 실패
- email (이메일) — varchar(100)
- authenticated_at (결제 수단 인증 일시) — datetime
- reg_dt (생성 일시) — datetime
- upt_dt (수정 일시) — datetime
- is_deleted (삭제여부(T|F)) — char(1)
- deleted_dt (삭제 일시) — datetime
구독 결제 관리 (tb_billing)
- 결제 번호 (billing_no) — BIGINT — 기본 키 — NOT NULL — 결제 번호
- 미러 ID (mirror_id) — VARCHAR(20) — NOT NULL — 미러 아이디
- 결제 공급자 (provider_type) — VARCHAR(10) — 결제 공급자 | 수기(admin), 국내(toss), 해외(stripe)
- 결제 공급자 원본 PK (provider_pk) — BIGINT — 결제 공급자의 원본 PK
- 다음 구독 상태 (next_subscription_status) — VARCHAR(10) — 다음 구독 상태 | 구독(ACTIVE) / 취소(CANCELED)
- 구독 타입 (subscription_type) — VARCHAR(10) — 구독 타입 | MONTH / YEAR
- 결제 상태 (purchased_status) — VARCHAR(10) — 결제 상태 | 결제 성공(SUCCESS) / 결제 실패(FAILED)
- 결제 상태 이유 (purchased_status_reason) — JSON — 결제 실패 | { code: 'INVALID_REQUEST', message: '필수 파라미터가 누락되었습니다.' }
- 청구 금액 (amount) — BIGINT
- 통화 (currency) — CHAR(3) — 청구 금액에 대한 통화
- 시작 일시 (period_start) — DATETIME — 구독 시작 일시
- 종료 일시 (period_end) — DATETIME — 구독 종료 일시
- 생성 일시 (reg_dt) — DATETIME
- 삭제 여부(T|F) (is_deleted) — CHAR(1)
- 삭제 일시 (deleted_at) — DATETIME
토스 결제 이력(국내결제이력) (tb_toss_history)
- toss_history_no — BIGINT — 기본 키 — NOT NULL — 토스 이력 번호
- toss_purchased_no — BIGINT — NOT NULL — 토스 결제 번호
- version — VARCHAR(30) — 결제 버전
- payment_key — VARCHAR(200) — NOT NULL — 결제 키 | 결제를 식별하는 고유 값 (승인/조회/취소 시 사용)
- payment_type — VARCHAR(30) — 결제 타입 | NORMAL/BILLING/BRANDPAY
- order_id — VARCHAR(64) — NOT NULL — 주문 번호 | 결제 상태가 변경되어도 유지되는 값
- product_name — VARCHAR(100) — 구매 상품
- m_id — VARCHAR(20) — 상점 아이디
- currency — VARCHAR(50) — 결제 통화
- method — VARCHAR(30) — 결제 수단 | 카드/가상계좌/간편결제/휴대폰/계좌이체 등
- total_amount — BIGINT — 총 결제 금액
- balance_amount — BIGINT — 취소할 수 있는 금액
- status — VARCHAR(30) — 결제 처리 상태
- requested_at — DATETIME — 결제 발생 일시
- approved_at — DATETIME — 결제 승인 일시
- use_escrow — BOOLEAN — 에스크로 사용 여부
- last_transaction_key — VARCHAR(64) — 마지막 거래의 키 값
- supplied_amount — BIGINT — 공급가액
- vat — BIGINT — 부가세
- culture_expense — BOOLEAN — 문화비 지출 여부
- tax_free_amount — BIGINT — 면세 금액
- tax_exemption_amount — BIGINT — 과세 제외 금액
- cancels — JSON — 결제 취소 이력
- is_partial_cancelable — BOOLEAN — 부분 취소 가능 여부
- card — JSON — 카드 정보
- virtual_account — JSON — 가상 계좌 정보
- webhook_secret — VARCHAR(50) — 웹 훅 검증 값
- mobile_phone — JSON — 휴대폰 결제 정보
- gift_certificate — JSON — 상품권 결제 정보
- transfer — JSON — 계좌이체 결제 정보
- metadata — JSON — 결제 정보 (SDK custom)
- receipt — JSON — 영수증
- checkout — JSON — 결제창 정보
- easy_pay — JSON — 간편결제 정보
- country — VARCHAR(10) — 결제 국가
- failure — JSON — 결제 실패 정보
- cash_receipt — JSON — 현금영수증 정보
- cash_receipt_history — JSON — 현금 영수증 이력
- discount — JSON — 할인 정보
토스 결제(국내결제) (tb_toss_purchased)
- 토스 결제 번호 (toss_purchased_no) — BIGINT — 기본 키 — NOT NULL — 토스 결제 번호
- 그룹 유저 번호 (group_user_no) — BIGINT — 그룹 유저 번호
- 미러 ID (mirror_id) — VARCHAR(20) — NOT NULL — 미러 아이디
- 구매자 키 (customer_key) — VARCHAR(300) — NOT NULL — 구매자 키
- 빌링 키 (billing_key) — VARCHAR(200) — NOT NULL — 빌링 키 | 자동결제 시 카드 정보 대신 사용 (customerKey와 연결)
- 결제 수단 (method) — VARCHAR(50) — 결제 수단
- 상점 ID (m_id) — VARCHAR(20) — 상점 아이디
- 구독 상태 (subscription_status) — VARCHAR(10) — NOT NULL — 구독 상태 | 구독(ACTIVE) / 중지(STOPPED) / 취소(CANCELED)
- 구독 타입 (subscription_type) — VARCHAR(10) — NOT NULL — 구독 타입 | MONTH / YEAR
- 결제 상태 (purchased_status) — VARCHAR(10) — NOT NULL — 결제 상태 | 결제 대기(READY) / 결제 성공(SUCCESS) / 결제 실패(FAILED)
- 청구 금액 (amount) — BIGINT — 청구 금액
- 이메일 (email) — VARCHAR(254) — 이메일
- 결제 수단 인증 일시 (authenticated_at) — DATETIME — 결제 수단 인증 일시
- 구독 시작 일시 (current_period_start) — DATETIME — 구독 시작 일시
- 구독 종료 일시 (current_period_end) — DATETIME — 구독 종료 일시를 통해 다음 청구 일시 유추
- 마지막 시도 일시 (last_attempt_at) — DATETIME — 마지막 시도 일시(하루 1회 제한)
- 재시도 일시 (retry_until_at) — DATETIME — 실패 후 7일 마감
- 생성 일시 (reg_dt) — DATETIME — 생성 일시
- 수정 일시 (upt_dt) — DATETIME — 수정 일시
- 삭제여부(T|F) (is_deleted) — CHAR(1) — 삭제여부(T|F)
- 삭제 일시 (deleted_dt) — DATETIME — 삭제 일시