Skip to main content
설명서에 자주 업데이트를 게시하며 이 페이지의 번역이 계속 진행 중일 수 있습니다. 최신 정보는 영어 설명서를 참조하세요.

고객에게 청구

GitHub Marketplace의 앱은 GitHub의 청구 지침을 준수하고 권장 서비스를 지원해야 합니다. 지침을 따르면 고객이 큰 문제 없이 청구 프로세스를 탐색할 수 있습니다.

청구 기간 이해

고객은 앱을 구매할 때 월별 또는 연간 청구 기간을 선택할 수 있습니다. 고객이 청구 기간 및 플랜 선택을 변경할 때마다 marketplace_purchase 이벤트가 트리거 됩니다. marketplace_purchase 웹후크 페이로드를 참조하여 고객이 선택한 청구 기간과 다음 청구 날짜가 시작되는 시점(effective_date)을 확인할 수 있습니다. 웹후크 페이로드에 대한 자세한 내용은 “GitHub Marketplace API에 대한 웹후크 이벤트”를 참조하세요.

앱의 UI에서 청구 서비스 제공

고객은 앱의 웹 사이트에서 다음 작업을 수행할 수 있어야 합니다.

  • 고객은 개인 및 조직 계정에 대한 GitHub Marketplace 플랜을 별도로 수정하거나 취소할 수 있어야 합니다.
  • GitHub Marketplace에서 구매한 유료 플랜을 취소하는 고객은 앱의 무료 요금제(있는 경우)로 자동으로 다운그레이드되어야 합니다. 고객이 GitHub Marketplace 구독을 취소하면 GitHub가 자동으로 앱을 제거하지 않으므로 고객은 무료 기능이 계속 작동할 것으로 예상할 수 있습니다. 고객이 이전 플랜을 다시 활성화하는 것이 좋습니다.
  • 다음 형식으로 업그레이드 URL을 제공하는 경우 고객은 앱의 사용자 인터페이스에서 업그레이드 할 수 있어야 합니다. https://www.github.com/marketplace/<LISTING_NAME>/upgrade/<LISTING_PLAN_NUMBER>/<CUSTOMER_ACCOUNT_ID>
  • 고객은 사용자(단위별 가격 책정 플랜)를 구매했거나 요금제에서 무제한 협력자를 제공하는 경우 앱의 웹 사이트에서 앱에 액세스할 수 있는 사용자를 수정할 수 있어야 합니다.
  • 고객은 앱의 웹 사이트의 청구, 프로필 또는 계정 설정 섹션에서 계정에 대한 다음과 같은 변경 내용을 즉시 볼 수 있어야 합니다.
    • 현재 계획 및 가격
    • 구입한 새 플랜
    • 평가판의 업그레이드, 다운그레이드, 취소 및 남은 일 수
    • 청구 주기에 대한 변경 내용(매월 또는 매년)
    • 고정 요금제 및 단위당 요금제에 대한 사용량 및 나머지 리소스 예를 들어 가격 책정 플랜이 단위당인 경우 앱의 사이트에 사용된 단위와 사용 가능한 단위가 표시되어야 합니다.

업그레이드, 다운그레이드 및 취소에 대한 청구 서비스

명확하고 일관된 청구 프로세스를 유지하려면 업그레이드, 다운그레이드 및 취소에 대한 다음 지침을 따르세요. GitHub Marketplace 구매 이벤트에 대한 자세한 지침은 “앱에서 GitHub Marketplace API 사용”을 참조하세요.

marketplace_purchase 웹후크의 effective_date 키를 사용하여 플랜이 변경될 시점을 결정하고 플랜이 적용되는 계정 목록을 주기적으로 동기화할 수 있습니다.

업그레이드

고객이 가격 책정 플랜을 업그레이드하거나 청구 기간을 매월에서 매년으로 변경하면 변경 내용을 즉시 적용해야 합니다. 새 플랜에 비례 배분 할인을 적용하고 청구 기간을 변경해야 합니다.

고객이 플랜을 업그레이드하고 결제에 실패하는 경우 GitHub는 GitHub Marketplace 구독을 이전 상태로 되돌려 줍니다. GitHub은(는) 고객에게 오류를 알리고 구매를 다시 시도할 수 있도록 전자 메일을 보냅니다. 이전 플랜으로 되돌리도록 요청하는 changed 작업이 포함된 웹후크가 수신됩니다.

업그레이드 및 다운그레이드 워크플로를 앱에 빌드에 대한 자세한 내용은 “플랜 변경 처리”를 참조하세요.

다운그레이드 및 취소

다운그레이드는 고객이 유료 플랜에서 무료 플랜으로 이전하거나, 현재 플랜보다 요금이 더 낮은 플랜을 선택하거나, 청구 기간을 매년에서 매월로 변경하면 발생합니다. 다운그레이드 또는 취소가 발생하는 경우 환불을 제공할 필요가 없습니다. 대신 현재 플랜은 현재 청구 기간의 마지막 날까지 활성 상태로 유지됩니다. 이 marketplace_purchase 이벤트는 고객의 다음 청구 기간이 시작되는 시점에서 새 플랜이 적용될 때 전송됩니다.

고객이 플랜을 취소하는 경우 다음 작업을 수행해야 합니다.

  • 무료 플랜(있는 경우)으로 자동으로 다운그레이드합니다.

    고객이 GitHub Marketplace 구독을 취소하면 GitHub가 자동으로 앱을 제거하지 않으므로 고객은 무료 기능이 계속 작동할 것으로 예상할 수 있습니다.

  • 나중에 플랜을 계속 유지하고 싶어하는 경우 GitHub 통해 플랜을 업그레이드할 수 있도록 합니다.

앱에 취소 워크플로를 빌드하는 방법에 대한 자세한 내용은 “플랜 취소 처리”를 참조하세요.