커머스 문서에 자주 나오는 용어를 처음 보는 사람 기준으로 풀어 둡니다. 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 을 만들어 보내는 결제 방식입니다. 상품 등록 없이도 씁니다 |
링크페이 |