용어 사전

커머스 문서에 자주 나오는 용어를 처음 보는 사람 기준으로 풀어 둡니다. PG·샌드박스·receipt_id·웹훅 같은 결제 공통 용어는 결제 매뉴얼 용어 사전, 구독 상태 용어는 구독 용어 사전에 있습니다.

키·인증

용어 뜻 더 보기
커머스 연동키 커머스 API 를 부르는 client_key·secret_key 한 쌍입니다. 결제 SDK 연동키와 따로 발급합니다 환경 설정
Basic 인증 Authorization: Basic base64(client_key:secret_key) 헤더로 프로젝트를 인증합니다. 서버에서만 씁니다 서버 인증
회원 JWT 장바구니·마이페이지처럼 구매자 본인 데이터를 다루는 API 에 Basic 인증과 함께 보내는 토큰입니다 (Bootpay-User-JWT 헤더) 회원 JWT
로그인 토큰 서버가 고객을 대신 로그인시켜 회원 JWT 를 받는 API 입니다. 가맹점 회원이 커머스 화면에 따로 로그인하지 않아도 됩니다 로그인 토큰

상품·고객

용어 뜻 더 보기
product_id 커머스에 등록한 상품의 ID 입니다. 주문서에 이 값과 수량을 넘기면 금액을 커머스가 계산합니다 상품 등록
상품 스냅샷 주문 시점의 상품 정보·가격을 복사해 둔 것입니다. 나중에 상품 가격을 바꿔도 이미 들어온 주문 금액은 그대로입니다 데이터 모델
판매 상태 품절·숨김·판매중지 같은 상품 상태입니다. 상태 변경 API 로 따로 바꾸고, 목록 조회에 바로 반영됩니다 상태 변경
배송비 정책 실물 상품 배송비를 정하는 규칙입니다. 상품이 아니라 정책을 만들어 상품에 연결합니다 배송비 정책
고객 커머스에 연결한 가맹점 회원입니다. 비회원 주문만 받으면 연결하지 않아도 됩니다 고객 개요

주문

용어 뜻 더 보기
임시 주문 (OrderPre) 결제 전 주문서 단계의 주문입니다. 31분이 지나면 만료됩니다 주문 준비
주문 준비 서버가 배송비를 포함한 금액을 먼저 확정하고 order_number 를 받는 선택 단계입니다. 금액 위변조를 서버에서 막습니다 주문 준비
order_number 주문 조회·취소·웹훅에 쓰는 주문번호입니다. API 호출에는 항상 이 값을 씁니다 주문 개요
order_id 커머스 내부 문서 ID(24자리)입니다. 조회에 넣으면 ORDER_NOT_FOUND 가 납니다 주문 개요
payment_completed 주문 상세의 결제 완료 상태입니다. 이 값과 금액을 확인한 뒤 주문을 확정합니다 주문서 요청
발주 (order_purchases) 판매자별 이행·배송 단위입니다. 한 주문을 두 번에 나눠 보내면 발주와 운송장이 두 개입니다 발송처리
구매 확정 구매자가 상품을 받았다고 확정한 상태입니다. 확정하는 서버 API 는 없고 주문 목록에서 여부를 봅니다 주문 목록
취소 철회 고객이 넣은 취소 요청을 거두는 것입니다 취소 철회

구독·링크페이

용어 뜻 더 보기
구독 (계약) 고객과 맺은 반복 결제 약정입니다. 상태는 구독 중·일시정지·해지·만료입니다 구독 개요
회차 (Bill) 구독에서 한 번 청구할 결제 건입니다. 구독 상태와 별도의 상태를 가집니다 구독 개요
링크페이 결제 URL 을 만들어 보내는 결제 방식입니다. 상품 등록 없이도 씁니다 링크페이

함께 보기