Shopify 체크아웃 UI 확장의 구독 가격 표시

Shopify 체크아웃 UI 익스텐션(checkout UI extension)은 구독자가 체크아웃에서 보는 정기 결제 가격을 다시 쓸 수 없습니다. 이 금액은 판매 플랜(selling plan)의 가격 정책(pricing policy)에서 나오므로, 상품 교체 후 가격이 잘못되어 보인다면 수정할 곳은 익스텐션이 아니라 플랜입니다.

양초 구독을 운영하는 한 판매자는 고객이 더 저렴한 리필 옵션으로 바꾼 뒤에도 Recurring Subtotal이 계속 초기 가격을 표시했다고 Shopify 커뮤니티 스레드에서 설명했습니다. 저희 자체 지원 문의에서도 같은 혼란을 확인했습니다. 90일 동안 구독 체크아웃 관련 질문이 13건 있었고, 체크아웃이 약속하는 금액과 실제로 청구되는 금액을 헷갈려 하는 판매자도 포함되어 있었습니다.

정기 결제 가격은 실제로 어디서 오는가

Shopify는 구독 상품을 판매 플랜 그룹(selling plan groups)으로 구성합니다. 각 플랜에는 가격 정책이 있으며, 이 정책에는 두 가지 형태가 있습니다. fixed는 구독 전체에 대해 한 번만 조정하는 방식이고, recurring은 초기 기간이 끝난 뒤 다른 조정을 적용하는 방식입니다. 체크아웃은 해당 항목에 연결된 정책을 그대로 읽어옵니다.

체크아웃 UI 익스텐션은 그 금액 안이 아니라 옆에 위치합니다. Shopify 문서는 이를 체크아웃 섹션 앞이나 뒤에 배치되는 블록 또는 정적 콘텐츠로 설명하고 있습니다. 가격 계산은 UI 익스텐션이 아니라 Shopify Functions가 별도로 처리합니다.

마지막 기한 이후로 체크아웃과 계정 익스텐션을 아직 점검하지 않았다면, 새 익스텐션을 추가하기 전에 그 부분부터 점검하는 것이 좋습니다.

사람들이 "상품 교체"라고 부르는 두 가지

문제를 진단하기 전에 이 두 가지를 구분해야 합니다. 하나는 플랜에 내장된 주기 변경으로, 고객의 별도 조치 없이 양초의 초기 가격이 리필 가격으로 바뀌는 경우입니다. 다른 하나는 구매자가 구독 도중 직접 상품을 교체하는 경우입니다. 위에서 언급한 포럼 사례는 첫 번째 유형입니다. 수동 교체는 다른 동작이지만, 그 아래에서는 동일한 가격 정책 객체를 업데이트합니다.

점검: 무엇이 잘못되었는지 확인하기

1. 구독 앱 대시보드나 Admin GraphQL의 sellingPlanGroups 쿼리를 통해 상품 뒤에 있는 판매 플랜을 가져와 가격 정책을 확인합니다.
2. 정책이 하나인지 두 개인지 확인합니다. 정책이 하나뿐이라면 두 주기 모두 동일한 금액을 표시하고 청구하는 것이 설계상 정상입니다.
3. 두 가지 가격을 기대한다면, 구독 앱을 통해 누락된 recurring 정책을 추가해서 첫 번째 주기는 초기 가격을, 이후 주기는 교체 후 가격을 청구하도록 합니다.
4. 변경 사항을 저장하고 실제 테스트 구독 주문을 넣은 뒤, 문제가 해결되었다고 누군가에게 말하기 전에 구독 앱 안에서 다음 청구 예정 금액을 확인합니다.
5. 두 정책이 이미 모두 올바른데도 체크아웃이 여전히 불명확하다면, 이는 가격 문제가 아니라 문구 문제입니다. 플랜을 다시 수정하는 대신 다음 섹션으로 넘어가세요.

다음 마이그레이션 전에 고쳐야 하는 이유

체크아웃에서는 한 가격을 보고 명세서에서는 다른 가격을 보는 구독자는 종종 구독을 취소하거나 지급 거절(차지백)을 신청합니다. 이는 매장이 구독 앱을 마이그레이션할 때 바로 그 시점에 드러나는 경우가 많습니다.

가격과 무관하게 결제 수단만 고장 나는 지원 티켓도 봤습니다. 예를 들어 결제 제공업체를 변경한 뒤 "iDEAL/Mollie payments not working"이라는 질문이 올라온 경우입니다. 이는 별개의 장애이므로 따로 확인할 가치가 있습니다.

마이그레이션이 그만한 가치가 있는지 고민 중이라면, 저희의 구독 비용 분석에서 대부분의 매장이 놓치는 수수료를 확인할 수 있습니다.

금액은 맞는데 문구가 틀린 경우

Shopify의 네이티브 가격 모델 위에 구축된 앱은 Shopify와 동일한 방식으로 교체 내용을 저장합니다. 예를 들어 Progus Subscriptions는 각 플랜의 가격 정책을 조정 유형과 조정 값의 쌍으로 유지하는데, 이는 체크아웃이 읽어오는 것과 같은 객체이므로 어떤 앱이 구독을 관리하든 위의 점검 방법이 동일하게 작동합니다.

청구 금액 자체는 이미 정확하고 교체 전에 추가 설명만 원한다면, 개발자가 주문 요약 근처에 체크아웃 UI 익스텐션을 추가할 수 있습니다. 이 익스텐션은 metafield에 저장된 향후 가격을 읽어 안내문으로 표시할 수 있습니다. 이 안내문은 Recurring Subtotal 항목 자체를 바꾸지 않고, 그 옆의 질문에만 답할 뿐입니다.

Shopify는 정보, 배송, 결제 단계의 체크아웃 UI 익스텐션을 Shopify Plus 플랜 매장으로 제한합니다. 주문 요약 근처의 익스텐션은 다른 타겟 타입(target type)을 따르므로, 누군가에게 약속하기 전에 정확한 배치 위치를 먼저 확인하세요.

마무리

체크아웃 UI 익스텐션은 표시 계층일 뿐, 가격 계산 엔진이 아닙니다. 금액이 잘못되어 보인다면 먼저 판매 플랜의 가격 정책을 확인하고, 실제 청구 금액 자체가 올바르다는 것을 확인한 뒤에야 커스텀 익스텐션을 만드세요.

구독 앱은 인수, 마이그레이션, 그리고 제공업체의 기능 단종으로 인해 대부분의 상인이 예상하는 것보다 자주 바뀝니다. 이런 이벤트가 있을 때마다 가격 정책과 결제 수단 설정을 각각 따로 다시 테스트하세요. 하나가 고장 나도 다른 하나는 영향을 받지 않을 수 있기 때문입니다.