Polar.sh PG는 미국의 컨텐츠 상품 전용 MoR인 Polar을 연동하여, Visa, Mastercard, American Express 등의 해외 카드 결제를 받을 수 있도록 합니다.

Polar 서비스 정책 상 전자적으로 제공되는 컨텐츠 상품의 결제에만 사용할 수 있습니다. 실물 상품, 용역 등의 결제를 위해 사용하지 않아야 합니다. 또, Visa, Mastercard 등 해외 카드사가 허용하지 않는 성인 컨텐츠, 술, 담배, 마약, 도박과 연관된 컨텐츠 등은 예고없이 차단될 수 있으므로 주의해야 합니다. 관련된 상세 정보는 Polar의 Acceptable Use Policy에서 확인할 수 있습니다.

설정 화면

Polar.sh PG는 "Polar Access Token", "Polar Product ID"와 "Polar 샌드박스 모드" 총 3개의 설정을 받습니다. 아래에 안내된 절차를 따라 각 값을 획득할 수 있습니다.

Polar Access Token

Polar Access Token을 발행하기 전, 먼저 Settings > Billing 페이지에서 Default payment currency를 South Korean Won(KRW)로 변경해야 합니다. 해당 화면의 그 이외 항목들은 원하는 값으로 적절히 수정해도 됩니다.

이후 Settings > General 메뉴 하단의 Developers 섹션 내 Create token 버튼을 눌러 Polar Access Token을 발행해야 합니다.

Create token 버튼을 누르면 위와 같은 화면이 출력됩니다. Name에는 적절한 이름을 자유롭게 입력하세요. Expiration은 원하는 유효기간을 선택하세요. 어떠한 값도 상관 없으나, 해당 값에 따라 API 키를 주기적으로 갱신해 주어야 할 수 있습니다.

Scopes는 총 6개 항목 checkouts:read, checkouts:write, orders:read, orders:write, refunds:read, refunds:write를 선택해야 합니다. 알파벳 순서로 정렬되어 있습니다. 위 이미지는 사용하지 않을 scopes들에 대해 숨김 처리해 둔 상태이므로, 실제 설정 화면은 이와 같은 배치가 아닐 가능성이 높습니다.

모든 입력을 완료한 뒤, Create Token 버튼을 누르면 생성한 Polar Access Token이 출력됩니다. 해당 값을 복사해 단일상품 스토어의 PG 설정 화면에 입력하세요. 해당 값은 새로고침 시 더 이상 확인할 수 없으므로, 생성 후 바로 사용하시기 바랍니다. 해당 값은 유출되지 않아야 하는 값입니다. 만약 해당 값이 외부에 유출되었다면 상단의 Revoke 버튼을 눌러 즉시 파기하고 새로 발급받아야 합니다.

Polar Product ID

Polar의 결제는 항상 특정 상품(들)을 기준으로 진행됩니다. 이를 위해 결제 처리를 담당할 상품 하나를 생성해야 합니다. 먼저 Products > Catalogue 메뉴의 Create Product 버튼을 눌러 상품 생성 화면으로 진입합니다.

단일상품 스토어 모듈은 설정의 편의성을 위해 Polar에 단 하나의 상품만 등록해 둔 뒤, 해당 상품의 가격을 결제 시점에 변조하여(ad-hoc) 적절한 가격을 결제할 수 있도록 구현되어 있습니다.

이러한 구현 방식을 감안하여, Name에는 단일상품 스토어 모듈을 설치한 웹사이트의 이름을 포함한 일반적인 이름을 기입하는 것을 권장합니다. 단, 이러한 형태로 설정할 경우 사용자가 결제를 진행할 때 Polar UI에 상품 이름이 출력되는 것이 아닌, 여기서 설정한 일반적인 이름이 출력됩니다. 이러한 동작을 원치 않을 경우 각 상품마다 새로운 Polar 상품을 생성하고, 단일상품 스토어 모듈의 각 상품 PG 설정 섹션에서 Polar Product ID를 따로 입력하는 형태로 설정할 수도 있습니다.

위에서 언급한 것과 같이 단일상품 스토어 모듈에서 직접 가격 정보를 입력하므로, Price Type은 Free로 설정하는 것으로도 충분합니다. 필요에 따라 원하는 가격 설정을 입력할 수 있으나, 권장하지 않습니다.

Visibility는 Private로 설정하는 것을 적극 권장합니다. 이미 Polar을 사용해 여러 기능을 직접 활용하고 있는 상태가 아니라면 Private로 설정하세요. 특히 가격 설정을 Free 타입으로 설정한 경우 예기치 않은 충돌 방지를 위해 Private로 설정하는 것이 안전합니다.

그 이외 요소, Automated Benefits나 Metadata와 같은 값은 필요에 따라 설정할 수 있습니다. 단일상품 스토어 모듈에서는 해당 값을 활용하지 않으므로 해당 기능을 활용할 예정이 없다면 비워둔 채로 Create Product 버튼을 눌러 상품 생성을 마무리 할 수 있습니다.

상품 생성을 완료했다면, Products > Catalogue 메뉴에 출력된 직전에 생성한 상품의 Product ID를 복사해 모듈 설정에 사용할 수 있습니다.

Polar 샌드박스 모드

Polar은 프로덕션 모드와 샌드박스 모드로 나뉘어져 있습니다. polar.sh 도메인을 사용하고 있다면 프로덕션 모드입니다. 프로덕션 모드에서 하단 프로필 메뉴를 누르면 Go to Sandbox 메뉴가 출력됩니다. 해당 메뉴를 클릭하면 sandbox.polar.sh 도메인으로 이동됩니다.

샌드박스 모드는 테스트를 위해 제공되는 격리된 환경입니다. 해당 모드에서는 실제 카드를 사용할 수 없습니다. Stripe에서 제공하는 Test card numbers를 사용해 결제 테스트를 진행해야 합니다. 샌드박스 모드의 결제는 테스트를 위한 결제이므로 실제 정산되지 않으니, 샌드박스 모드 설정이 실제 사용자에게 도달하지 않도록 주의하여 사용 바랍니다.

가격 설정 및 매출

Polar은 MoR(Merchant of Record) 서비스로 일정 수수료를 받고 결제 및 세금 신고, 정산을 한번에 제공합니다. 특히 Polar의 세금 신고 대행에는 부가세의 신고가 포함되어 있습니다. 이 때문에 Polar에서의 가격은 설정에 따라 결제 시점에 10%의 부가세가 자동으로 추가 부과되거나, 기입한 가격에서 10%를 제한 금액을 매출으로 인정합니다.

단일상품 스토어 모듈은 국내 결제 환경의 관례에 따라 설정한 가격의 10%를 제하는 설정으로 고정하도록 했습니다. 특히 Polar 결제 시점에 I'm purchasing as a business 옵션을 선택할 경우 부가세가 면세 처리되는데, 만약 결제 시점에 추가 부과되는 설정을 사용할 경우 최종 사용자가 사업자등록번호를 제공하는 경우 가격을 할인받는 모습으로 비춰질 수 있어 제외하도록 했습니다.

이러한 이유로 사용자가 50,000원을 결제하더라도, Polar의 주문 요약 화면에서는 45,455원이 결제된 것으로 출력될 수 있으므로 참고하시어 가격 설정 바랍니다.