Products

상품 관련 작업입니다.

GET /v1/products로 카탈로그를 조회합니다. 주문 전 확인할 핵심 필드: availability(ON_SALE 상품만 주문 가능), available_delivery_method(선물 전달 방식 — 전달 방식 참고), net_price(계정별 적용 가격), recipient_info_provided_by(수신자가 직접 전달 정보를 입력하는지 여부).

시점이 중요한 주문이라면 GET /v1/products/{id}/availability로 실시간 가용성을 먼저 확인하세요.

가격과 통화

net_price가 실제로 결제되는 금액입니다. 계정별 할인 정책이 반영돼 있고, 상품에 transaction_fee_rate가 붙는 경우 그 수수료까지 이미 포함돼 있습니다. net_price 위에 수수료를 더하지 마세요. 한 상품은 공급사 수수료를 지거나 마진을 나누거나 둘 중 하나이며, 둘 다인 경우는 없습니다.

가격은 상품 자체의 currency로 표시됩니다. 계정 잔액이 다른 통화라면 주문을 생성하는 시점의 환율로 환전합니다. 주문 전에 환율을 미리 조회하는 엔드포인트는 없습니다. 실제로 적용된 환율은 주문 응답의 아이템별 price_charged.applied_exchange_rate로 돌려드립니다.

바우처 유효기간

validity는 사용 가능한 기간이며 단위는 **일(day)**입니다. 공급사가 유효기간을 제공하지 않는 상품은 null입니다. 드물지 않으니 null 처리를 항상 넣으세요.

이 필드 하나에 성격이 다른 두 가지가 담깁니다.

기간형 상품은 고정값을 돌려줍니다(예: 365). 바우처가 발급된 시점부터 셉니다. 1년은 365일, 1개월은 30일로 계산합니다.
만료일형 상품은 오늘 기준 남은 일수를 돌려줍니다. 값이 매일 줄어들고 만료일에 0이 됩니다.

이 필드만 보고는 둘을 구분할 수 없습니다. 주문 시점의 값을 절대 만료일로 저장하지 마세요.