Tenants can manage (see, extend or upgrade) their edition/plan subscriptions using this page:
All payment records for purchasing/extending/upgrading the subscription are kept in the system. These records can be seen on "Payment History" tab on subscription page.
Tenants can also create & print invoices for these payments by clicking the "Show Invoice" button. System will automatically generate an invoice number and show the generated invoice. In order to use this function, both Host and Tenant must set invoice information on host setting/tenant setting page.
After all, invoices for payments related to subscription can be generated. You can see a sample invoice below:
ASP.NET Zero's subscription system allows using two payment gateways, one is PayPal and the other one is Stripe. You can configure both payment gateways in the
appsettings.json file in the *.Web.Host project.
When subscription of a Tenant is about to expire, an email is sent to email address of the tenant to remind this expiration. This job is handled in SubscriptionExpireEmailNotifierWorker.cs background worker. This worker runs once in every day and sends email to tenants whose license will expire after N days later. The day count of N is stored in a setting named "App.TenantManagement.SubscriptionExpireNotifyDayCount" and its default value is 7 days. You can change it in AppSettings.cs class in *.Core project.
When the subscription of a Tenant is expired, SubscriptionExpirationCheckWorker.cs (it is localed next to SubscriptionExpireEmailNotifierWorker.cs) comes into play and executes the logic below:
- If WaitingDayAfterExpire is set for the Edition of the tenant, ASP.NET Zero waits for WaitingDayAfterExpire days to end Tenant's subscription.
- If "assign to another edition" option is selected for the Edition of the Tenant, tenant will be moved to the fallback edition.
- If "deactive tenant" option is selected for the Edition of the Tenant, tenant will be disabled and will not be able to use the system.
- If the subscription expires for a tenant who subscribed for trial usage, the tenant will be disabled and will not be able to use the system.
Minimum Update Amount
Since payment systems have accepted the minimum payment amount, you may need to set the minimum payment amount according to your payment system. Settings are located in
// Minimum accepted payment amount. If a payment amount is less then that minimum value payment progress will continue without charging payment
// Even though we can use multiple payment methods, users always can go and use the highest accepted payment amount.
//For example, you use Stripe and PayPal. Let say that Stripe accepts min 5$ and PayPal accepts min 3$. If your payment amount is 4$.
// User will prefer to use a payment method with the highest accept value which is a Stripe in this case.
public const decimal MinimumUpgradePaymentAmount = 1M;
static readonly MinimumUpgradePaymentAmount = 1;
Default value is 1.
Payment progress will be continued without charging any amount if the payment amount is less than given value.