Billing cleanup for notifications

Author: shaloo

docs/concepts/billing.md

@@ -5,7 +5,11 @@ arcana:
 
 # Usage & Billing
 
-{{config.extra.arcana.product_name}} tracks app usage in terms of 'Monthly Active Users (MAU) across all the apps registered with {{config.extra.arcana.company_name}} for a developer account. Web3 app developers can monitor registered app usage for both the {{config.extra.arcana.company_name}} Testnet as well as Mainnet by using the {{config.extra.arcana.dashboard_name}}. Only {{config.extra.arcana.company_name}} Mainnet usage is billed. 
+{{config.extra.arcana.product_name}} tracks app usage in terms of 'Monthly Active Users (MAU) across all the apps registered with {{config.extra.arcana.company_name}} for a developer account. 
+
+![Application Usage Stats Mainnet](/img/an_db_billing_allapps_MAU.png){.an-screenshots}
+
+Developers can monitor registered app usage for both the {{config.extra.arcana.company_name}} Testnet as well as Mainnet by using the {{config.extra.arcana.dashboard_name}}. Only {{config.extra.arcana.company_name}} Mainnet usage is billed. 
 
 There is a promotional free usage tier available for each developer account. Once this free tier is used up, usage is chargeable for all the apps registered with {{config.extra.arcana.company_name}} for a developer account and billed via a single invoice. See [{{config.extra.arcana.company_name}} Pricing](https://www.arcana.network/pricing) for the latest billing charges and available free tier limits.
 
@@ -17,16 +21,20 @@ A single invoice is raised for every developer account on the last day of every
 
 ### Outstanding Dues
 
-The invoice for a developer account is generated taking into consideration all the promotional, and free-tier usage in terms of MAU across all the registered apps for that account. The amount is due once the monthly invoice is raised. A notification is sent to the registered email and the amount is automatically deducted based on the payment method configured by the developer. If the selected payment method fails, a grace period is allowed during which automatic payment is retried. During the grace period, the registered apps become suspended and no users are allowed to log in and use the apps.
+All pending dues must be paid in one shot and there is no part-payment allowed. 
+
+The invoice for a developer account is generated taking into consideration all the promotional, and free-tier usage in terms of MAU across all the registered apps for that account. 
 
-All pending dues must be paid in one shot and there is no part-payment allowed. After 3 months of inactivity / non-payment of pending dues, and failure to pay via the configured payment method, all the apps registered for the defaulter account are deleted and the developer account is suspended.
+The amount is due once the monthly invoice is raised. A notification is sent to the developer. The invoice amount is automatically deducted based on the payment method configured by the developer. If the selected payment method fails, there is a grace period of 21 days during which automatic payment is retried once in 7 days. During the grace period, the registered apps continue to work as normal and users are allowed to log into the apps. Once the grace period ends and the payment is not successful, then the developer account is suspended and no users are allowed to log into the registered apps.
+
+After 3 months of inactivity and non-payment of pending dues, all the apps registered for the defaulter account are deleted and the developer account will no longer be accessible.
 
 ## Billing Setup
 
-Developers can use the {{config.extra.arcana.dashboard_name}} to set up their {{config.extra.arcana.company_name}} account with the following details. The address and payment method details are required for billing.
+Developers can use the {{config.extra.arcana.dashboard_name}} to set up their {{config.extra.arcana.company_name}} account and provide the following details. The address and payment method details are required for billing.
 
-* Organization details
-* Address
+* Organization
+* Billing Address Details
 * Payment Method
 
 !!! caution "Adding Payment Method"
@@ -37,13 +45,27 @@ Developers can view the billing history and the current outstanding invoice once
 
 !!! tip "Payment method not required for free tier usage"
 
-     It is not mandatory to enter the billing details in the developer's account profile to use the {{config.extra.arcana.sdk_name}}. Once the free tier usage is consumed, the developer is required to add the billing details to the profile and ensure uninterrupted user onboarding for the registered, active Web3 apps that are using the {{config.extra.arcana.company_name}} Mainnet.
+     It is not mandatory to enter the details in the developer's account profile to use the {{config.extra.arcana.sdk_name}}. Once the free tier usage is consumed, the developer is required to add these details in the profile section and ensure uninterrupted user onboarding for the registered, active Web3 apps that are using the {{config.extra.arcana.company_name}} Mainnet.
 
-## Billing Notifications
+## Notifications
 
-TBD
+The {{config.extra.arcana.dashboard_name}} displays a bell icon on the top right of the screen. 
 
+<img class="an-screenshots-noeffects" src="/img/an_db_notifications_list.png" alt="Dashboard bell icon notifications list" width="40%"/>
+
+The following billing notifications are displayed:
+
+| Event  | Notification | Notes |
+| :---  | :--- | :--- |
+| Billing | Add card details for processing the payment. | The first time a developer logins, this message is displayed in the notifications section. |
+| Billing | Invoice for the current month has been generated. | Once the free-tier is over, at the end of every billing cycle, the dues are computed and an invoice is created. Developer is notified of the same.|
+| Billing | Payment successfully processed for this month. | Once the free-tier is over, monthly invoices are raised and payment automatically deducted from the specified payment method. |
+| Billing | Payment has been declined.| This notification will be displayed if he specified payment method fails when the invoice dues are processed, or if there are any payment errors due to insufficient funds. |
+
+<!-- 
 ## Billing Errors and Troubleshooting
 
 TBD
 Link the billing errors list here and also link the Troubleshooting guide section on Billing errors.
+
+-->

docs/db/config_dApp_with_db.md

@@ -187,25 +187,33 @@ To begin using the {{config.extra.arcana.sdk_name}}, the app developers don't ne
 
 Click on the user icon on the top right of the {{config.extra.arcana.dashboard_name}} screen. Select **Profile** in the dropdown. 
 
-![Application Usage Stats Mainnet](/img/an_db_billing_nav.png)
+![Application Usage Stats Mainnet](/img/an_db_billing_nav.png){.an-screenshots}
 
-You will see the developer's {{config.extra.arcana.company_name}} account profile details. 
+You will see the developer's {{config.extra.arcana.company_name}} account profile details. The developer account **name** and **public identifier** (email) are automatically retrieved based on the account used to log into the {{config.extra.arcana.dashboard_name}}.
 
-Update the organization and address details. Click **Save**. Next, refer to the **Payment Method** section and provide the card details. Click **Save**.
+Developers are required to update the following profile details and then click **Save**. 
 
-![Application Usage Stats Mainnet Billing Profile](/img/an_db_billing_profile.png)
+* Organization
+* Billing Address Details
+* Payment Method
 
-The amount payable will be auto-deducted using the specified payment method once the invoice is generated at the end of every month. If the payment fails, the payment provider will automatically retry the payment until the grace period expires (30 days). After the grace period ends and the payment is not successful, the developer account will be suspended and no users will be able to log into the registered apps.
+![Application Usage Stats Mainnet Billing Profile](/img/an_db_billing_profile.png){.an-screenshots}
 
 #### View Invoices
 
-Click on the user icon on the top right of the {{config.extra.arcana.dashboard_name}} screen. Select **Invoices** in the dropdown. 
+Click on the user icon on the top right of the {{config.extra.arcana.dashboard_name}} screen. Select **Invoices** in the dropdown.
 
-![Application Usage Stats Mainnet](/img/an_db_invoices_nav.png)
+![Application Usage Stats Mainnet](/img/an_db_invoices_nav.png){.an-screenshots}
 
 On the **Invoices** page, you will see the details of the current pending dues followed by the billing history of previous invoices that can be downloaded for reference.
 
-![Application Usage Stats Mainnet](/img/an_db_invoices_details.png)
+![Application Usage Stats Mainnet](/img/an_db_invoices_details.png){.an-screenshots}
+
+#### View Billing Notifications
+
+Click the bell icon to view all notifications for the developer account. Check the [billing notifications]({{page.meta.arcana.root_rel_path}}/concepts/billing.md#notifications) list for details.
+
+![Dev account notifications](/img/an_db_notifications_nav.png){.an-screenshots}
 
 <!---