Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы, возможно, еще выполняется. Актуальные сведения см. в документации на английском языке.

Клиенты для выставления счетов

Приложения в GitHub Marketplace должны соответствовать рекомендациям по выставлению счетов GitHub и поддерживать рекомендованные службы. Следуя нашим рекомендациям, клиенты могут осуществлять навигацию по процессу выставления счетов без каких-либо непредвиденных результатов.

Общие сведения о периоде выставления счетов

Клиенты могут выбрать ежемесячный или годовой период выставления счетов при покупке приложения. Все изменения, внесенные клиентами в период выставления счетов и выбор плана, активируют событие marketplace_purchase. Вы можете обратиться к полезным данным веб-перехватчика marketplace_purchase, чтобы узнать, какой период выставления счетов выбирает клиент и когда начинается следующая дата выставления счетов (effective_date). Дополнительные сведения о полезных данных веб-перехватчика см. в статье События веб-перехватчика для API GitHub Marketplace.

Предоставление услуг по выставлению счетов в пользовательском интерфейсе приложения

Клиенты должны иметь возможность выполнять следующие действия на веб-сайте приложения:

  • Клиенты должны иметь возможность изменять или отменять свои планы GitHub Marketplace для личных и организационных учетных записей отдельно.
  • Для клиентов, которые отменяют платный план, приобретенный из GitHub Marketplace, уровень должен быть автоматически понижен до бесплатного плана приложения (если он существует). Когда клиент отменяет подписку GitHub Marketplace, GitHub не удаляет приложение автоматически, поэтому клиент может ожидать, что бесплатные функции будут функционировать по-прежнему. Настоятельно рекомендуется разрешить клиентам повторно включить предыдущий план.
  • Клиенты должны иметь возможность обновить пользовательский интерфейс приложения, если вы указали URL-адрес обновления в следующем формате: https://www.github.com/marketplace/<LISTING_NAME>/upgrade/<LISTING_PLAN_NUMBER>/<CUSTOMER_ACCOUNT_ID>
  • Клиенты должны иметь возможность изменять пользователей, которые имеют доступ к вашему приложению с веб-сайта вашего приложения, если они приобрели рабочие места (тарифный план с оплатой за единицу) или план предлагает неограниченное число участников совместной работы.
  • Клиенты должны сразу увидеть следующие изменения учетной записи в разделе параметров выставления счетов, профиля или учетной записи веб-сайта приложения:
    • Текущий план и цена.
    • Приобретены новые планы.
    • Повышение уровня, понижение уровня, отмена и количество оставшихся дней бесплатной пробной версии.
    • Изменения циклов выставления счетов (ежемесячно или ежегодно).
    • Использование и оставшиеся ресурсы для планов с фиксированной ставкой и планов с оплатой за единицу. Например, если тарифный план предусматривает оплату за единицу, на сайте вашего приложения должен отображать используемые и доступные единицы.

Службы выставления счетов для обновлений, перехода на использование более ранних версий и отмен

Следуйте этим рекомендациям по обновлению, переходу на использование более ранних версий и отменам, чтобы обеспечить четкий и согласованный процесс выставления счетов. Более подробные инструкции о событиях покупки GitHub Marketplace см. в статье Использование API GitHub Marketplace в приложении.

Вы можете использовать ключ effective_date веб-перехватчика marketplace_purchase, чтобы определить, когда произойдет изменение плана, и периодически синхронизировать Список учетных записей для плана.

Обновления

Когда клиент обновляет свой тарифный план или меняет период выставления счетов с ежемесячного на годовой, вы должны немедленно применить это изменение. Необходимо применить пропорциональную скидку к новому плану и изменить период выставления счетов.

В случае, когда клиент обновляет свой план и платеж завершается сбоем, GitHub возвращает свою подписку GitHub Marketplace до предыдущего состояния. GitHub также отправляет клиенту сообщение электронной почты, чтобы сообщить ему о сбое и позволить ему повторно попытаться совершить покупку. Вы получите веб-перехватчик с действием changed, которое запрашивает возврат к предыдущему плану.

Сведения о создании рабочих процессов обновления и перехода на использование более ранних версий в приложении см. в статье Обработка изменений плана.

Переход на использование более ранних версий и отмены

Переход на использование более ранних версий происходит, когда клиент переходит на бесплатный план из платного, выбирает план с более низкой стоимостью, нежели текущий, или изменяет свой период выставления счетов с ежегодного на ежемесячный. Если происходит переход на использование более ранней версии или отмены, вам не возмещать средства. Вместо этого текущий план будет оставаться активным до последнего дня текущего периода выставления счетов. Событие marketplace_purchase будет отправлено, когда новый план вступит в силу в начале следующего периода выставления счетов клиента.

Когда клиент отменяет план, необходимо:

  • Автоматически перевести клиента на использованием бесплатного плана, если он существует.

    Когда клиент отменяет подписку GitHub Marketplace, GitHub не удаляет приложение автоматически, поэтому клиент может ожидать, что бесплатные функции будут функционировать по-прежнему.

  • Разрешить клиенту обновить план через GitHub, если он захочет позже продлить его.

Сведения о создании рабочих процессов отмены в приложении см. в статье Обработка отмен плана.