DOCS

표시 통화 사용자 지정

Hello가 외화 금액을 표시하는 방식을 재정의합니다.

JavaScript 통합에서 통화 표시 형식을 사용자 지정하여 외화 표시 방식을 필요와 선호에 맞게 조정할 수 있습니다.

통화 표시 형식 

Hello는 다음 통화 표시 형식을 지원합니다.

  • symbol(기본값) — 현지화된 통화 기호를 표시합니다. 예: €123.
  • code — ISO 통화 코드를 사용합니다. 예: 123 USD.
  • name — 현지화된 통화 이름을 표시합니다. 예: 123 dollars.

Zonos.init 메서드의 overrideCurrencyFormat 속성을 사용하여 통화 표시 형식을 재정의할 수 있습니다. 이 속성은 위에 나열된 통화 표시 형식 중 하나를 허용합니다. 통화 표시 형식 재정의는 Hello와 Zonos Checkout 모두에 적용됩니다.

1Zonos.init({
2 overrideCurrencyFormat: 'code',
3});

맞춤 통화 변환기 사용 

통화 표시 형식을 재정의하는 것만으로 사이트 요구 사항을 충족하기 어려운 경우, 맞춤 통화 변환기를 사용하여 외화 금액의 변환 및 형식 지정을 처리할 수 있습니다. 이 방식으로 사이트에 통화 금액이 표시되는 방식을 완전히 제어할 수 있습니다.

맞춤 통화 변환기를 사용하려면 Zonos.init 메서드에서 currencyConverter 함수를 구현해야 합니다. 이 함수는 다음 매개변수를 허용해야 합니다.

  • convertAndFormat — 통화 금액을 변환하고 형식을 지정하는 함수입니다.
  • originalAmount — 원래 통화 금액입니다.
  • selector — 통화 금액을 포함하는 요소의 선택자입니다.

currencyConverter 함수가 있으면 사이트의 모든 일치하는 가격 선택자를 순회하며 각각에 맞춤 통화 변환 로직을 적용합니다.

맞춤 통화 변환기 함수의 일반적인 사용 사례는 드롭다운 메뉴 등 복잡한 HTML 요소에 가격이 표시되는 경우입니다. 예를 들어 각 옵션 옆에 가격이 표시되는 드롭다운 메뉴가 있는 경우:

1

이처럼 가격 옆에 추가 텍스트가 있으면 가격을 직접 선택할 수 없습니다. 맞춤 통화 변환기를 사용하면 요소에서 가격을 추출하고 통화 변환 로직을 적용할 수 있습니다.

1window.Zonos.init({
2 currencyConverter: ({ convertAndFormat, originalAmount, selector }) => {
3 const optionValue = selector.getAttribute('data-select-option');
4 if (optionValue) {
5 return `${optionValue} - ${convertAndFormat(originalAmount)}`;
6 }
7 return convertAndFormat(originalAmount);
8 },
9});

이 페이지가 도움이 되었나요?


이 페이지에서: