적절한 스토어 기본값 제공하기
방문자의 연결로부터 국가와 통화를 제안해 결제 전 마찰을 줄이되, IP 기반 위치를 정확해야 하는 세금, 배송, 결제 관련 결정의 증거로 취급하지 마세요.
표시 통화와 결제 통화의 차이
geo.currency는 첫 로딩 시 스토어의 표시 통화와 가격 형식을 미리 채우는 데 사용하세요. 이는 엄격히 표시용 기본값으로만 취급하세요: 실제로 청구되는 금액은 IP 주소가 아니라 결제 수단 자체에서 통화와 환율을 확인하는 결제 대행사를 통해서만 결정되어야 합니다.
위치 고정이 아닌 지역 선택기
제안된 국가를 표시하고 쇼핑객이 변경할 수 있게 하세요. 카탈로그 노출, 가격 등급, 결제 접근을 IP 기반 국가만으로 제한하지 마세요 — VPN, 기업 프록시, 여행 중인 쇼핑객은 실제로 원하지 않는 곳으로 확인될 수 있습니다.
잠정적인 배송 안내 문구
도시 및 지역 필드는 "보통 해당 지역까지 3~5일 소요됩니다"와 같은 대략적인 문구를 지원하며, 확정된 배송일이나 배송비를 보장하지 않습니다. 실제 주소와 배송 견적은 쇼핑객이 직접 입력하는 결제 단계에서 확인하세요.
예시: 통화 제안 후 결제 시점에 재계산
페이지 로드 시 스토어 자체 JavaScript에서 GET /v1/geo를 호출해 country와 currency를 읽고, 통화 선택기와 표시 가격을 미리 채우세요. 결제 시점에는 IP 기반 통화를 버리고, 쇼핑객의 결제 수단과 청구 주소로부터 결제 대행사가 확인하는 값을 사용하세요.
보장하지 않는 것
현재 필드는 환율, 판매세, 부가가치세를 계산하지 않으며, 구매자의 청구 거주지를 확정하지 않습니다 — tax 필드 자체가 미국 주소에 대해 null 세율을 반환하는 이유는, 도착지 기준 미국 판매세를 국가/지역 정보만으로는 확인할 수 없기 때문입니다. 결제 시점에 정확해야 하는 항목에는 전용 세금 엔진과 결제 대행사를 사용하세요.