상품 개요

v1 API 상세: 상품, 카테고리, 카탈로그

상품은 파는 것을 부트페이에 미리 등록해 두는 거예요. 등록하면 product_id 가 나오고, 체크아웃과 구독은 이 ID와 수량으로 주문을 만들어요.

핵심 요약

• 상품을 등록하면 product_id 가 나와요. 체크아웃·구독은 이 ID로 주문을 만들어요.
• 첫 등록은 name·0보다 큰 display_price 에 tax_type: 1·save_by: 3 을 함께 보내요.
• 주문에는 그 시점의 가격이 스냅샷으로 고정돼요. 나중에 가격을 바꿔도 지난 주문은 그대로예요.
• 재고를 켜 두면 남은 수량보다 많이 주문할 때 품절로 막고, 주문이 들어오면 차감해요.
• 링크페이는 상품 등록 없이 이름·금액만으로 결제받아요.

등록하면 무엇이 달라지나

상품을 등록해 두면 주문을 만들 때 상품명·금액을 매번 넘기는 대신 product_id 와 수량을 넘겨요.

curl -X POST "https://api.bootapi.com/v1/products" \
  -H "Authorization: Basic {base64(client_key:secret_key)}" \
  -H "Content-Type: application/json" \
  -d '{ "name": "드립백 커피 10개입", "display_price": 29900, "tax_type": 1, "save_by": 3, "ex_uid": "shop-coffee-10", "status_visible": true, "status_display": true, "status_sale": true }'
# → 500 응답이어도 저장됐을 수 있어요. ex_uid 로 조회해 확인해요.bash

await BootpayCommerce.requestCheckout({
  client_key: CLIENT_KEY,
  price: 29900,
  products: [{ product_id: 'your-product-id', quantity: 1 }],
  // ...
})javascript

네 가지 개념

체크아웃만 붙인다면 상품과 상태로 시작해요. 카테고리와 진열은 쇼핑몰 화면에 상품 목록을 직접 그릴 때 더해요.

경로마다 상품 쓰임이 달라요

상담 결제·후불 청구처럼 주문서 화면 없이 링크로 받는 흐름은 링크페이부터 붙여요.

상품에 담기는 값

처음엔 name 과 display_price 로 시작하고, 필요할 때 아래 값을 더해요.

ex_uid 에 내 상품 DB의 ID를 넣어 두면 상품 목록에서 그 값으로 찾아올 수 있어요 (쇼핑몰에 노출 중인 상품만). 전체 필드는 상품 등록에서 봐요.

상태 — 보이나, 살 수 있나

품절·숨김·판매중지는 서로 다른 필드로 나뉘어요. 운영 화면과 코드가 같은 말을 쓰도록 이 대응을 먼저 맞춰요.

상태만 바꿀 때는 상태 변경을 써요. 상품 수정은 스냅샷을 새로 만들어 무겁고, 전시·판매 기간이나 타임세일도 상태 변경에서 켜요.