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 — 삭제 일시