Creating, Editing, and Deleting Accounts

Your end customer Accounts will typically be created in m3ter as a result of an integration with one of your 3rd-party systems. However, you might need to create an Account manually during the set up phase of your Organization and for testing before you switch to a production environment. This topic explains how to create, edit, and delete Accounts in the Console:

Tip: Accounts Created for Integrations? In typical production settings, your end customer Accounts will be created in m3ter as a result of an Integration with one of your 3rd-party systems. For more details, see m3ter Integrations.

Creating Accounts

You can quickly create an Account manually in the Console. Accounts do not belong to Products to allow for cases where an end-customer consumes more that one of your products or services.

To create an Account:

1. Select Accounts. The Accounts page opens.

2. Select Create Account. The Accounts>Create page opens.

3. Enter the Account Details:

  • Name. The customer’s name. Required field.

  • Code. Unique identifier for the Account. You will need this Code as a unique id for API calls, such as a call to make usage data submissions for the Account. It will also be used to identify the Account in any 3rd-party systems you integrate with m3ter. Required field.

  • Email Address. Required field.

  • Parent account. Optional - if you want the Account to be the Child of another Account, then select the Parent Account. For more details see Working with Parent/Child Accounts.

4. Enter the optional Address details for the Account:

  • Address Line 1.

  • Address Line 2.

  • City / Town.

  • Region / Province.

  • Postcode / Zip.

  • Country.

Warning: Personally Identifiable Information (PII)! Under the Data Processing Agreement, the only fields you are allowed to use for any of your end-customer's PII are Name, Address, and Email Address. See the Personally Identifiable Information (PII) section for more details.

5. Enter any Bill Settings for the Account:

  • Currency. Use the drop-down list to select the currency you want to use as the billing currency for the Account. Note that:

    • If you select a currency for the Account, this will override the billing currency you've defined at Organizational level.

    • If you leave this blank, the billing currency defined at Organizational level will be used for billing on the Account. See Creating and Managing Currencies.

    • Note that if you attach a Plan to the Account that uses a different pricing currency to the selected billing currency, then you must add the relevant currency conversion rate at Organization level to ensure the billing process can convert line items calculated using the pricing currency into the selected billing currency. If you don't add these currency conversion rates, then bills will fail for the Account. See Adding Currency Conversion Rates.

  • First bill date. Optional attribute, which allows you to set a date of first billing against the end customer Account. For example, if the Plan you attach to the Account for charging is configured for monthly billing frequency and you set a First bill date of January 14th 2022, then m3ter will create a bill for the Account every month from that date. If you leave this blank then the start of billing defaults to the Epoch setting you've configured for your Organization - see Viewing and Editing Organization Configuration.

  • Credit application order. Optional setting. Select to define the order in which any Prepayment or Balance credit amounts on the Account are to be drawn-down for billing:

    • Use organization-wide configuration. Default selection. If enabled, then the setting selected at Organization level for credit draw-down order will be used. If you select any of the other four options, the Organization level setting will be overridden. See Viewing and Editing Organization Configuration.

    • Prepayment then balance. Draw-down against Prepayment credit before Balance credit.

    • Balance then prepayment. Draw-down against Balance credit before Prepayment credit.

    • Prepayment only. Only draw-down against Prepayment credit.

    • Balance only. Only draw-down against Balance credit.

  • Days before bill due. Optional setting. Enter the number of days after the Bill generation date that you want to show on Bills as the due date. This is useful for cases where you want Bills for different end-customer Accounts to show different due dates:

  • Purchase order number. Optional attribute. Allows you to assign an order number to an end-customer Account. The purchase order number will then come through into invoicing. For example, your financial systems might require this as a reference for clearing payments.

Warning: Changing Account Purchase Order Number! If you have generated Bills for an Account that has a Purchase Order number assigned to it and then changed the number, when you recalculate Bills the old number will persist on Bill Details and not be updated. This is expected behavior. If you need a Bill to show the new Purchase Order number, you must delete the Bill and regenerate it.

6. Enter any Bill Statements settings for the Account. These are optional allowing you to define how you want Bill Statements to be generated for the Account. Any settings at Account level will override Organization level settings for Bill Statements:

  • Statement definition. Optional setting. Select a Statement definition on which Statements generated for the Account will be based.

  • Auto-generate statements. Optional setting. Select for the formats in which Statements for the Account will be generated - four options:

    • Use organization-wide configuration. Default

    • None. Statements are not auto-generated.

    • JSON. Statements are generated only in JSON format.

    • JSON and CSV. Statements are generated in both JSON and CSV formats.

Tip: Bill Statements? For more on setting up and generating Bill Statements for end customer Accounts, see Working with Bill Statements.

7. Create any Custom Fields for the Account:

  • You can define Custom Fields when creating an Account or edit it at a later date to do this. Any Custom Fields you create for an Account override Custom Fields you've created for Accounts at Organizational level. We strongly recommend reviewing Working with Custom Fields before you create Custom Fields.

8. Select Create Account. The Account Details page opens with the Overview tab selected.

Note that:

  • The unique id generated for the new Account is listed under Account Details and you can copy this directly to your clipboard.

  • Any usage data ingested for the Account will be linked strictly to the Account id.

Editing and Deleting Accounts

You can edit or delete Accounts in the Console.

Warning: Deleting Accounts for which you've already submitted usage data! If you delete an Account for which you've already submitted usage data, that usage data is permanently dissociated from the Account. Even if you recreate a new Account with the same Code as the Account you deleted earlier, the usage data ingested for the deleted Account is no longer available for billing against the newly created Account using the same Code. This means you'll have to re-submit the usage data for the recreated Account if you want to use the data for billing the Account. See Editing and Deleting Accounts - Implications for Usage Data for more details.

To edit or delete an Account:

1. Select Accounts. The Accounts listing page opens.

2. Search for the Account you want to edit or delete.

3. If you want to edit the Account, select the NAME hotlink text. The Account page opens with the Overview tab selected.

4. On the Account Details panel select Edit. The Edit page opens.

5. Make your editing changes, and click Update Account. You are returned to the Account page.

6. If you want to delete the Account, stay on the Accounts listing page and select the Delete button for the Account:

A confirmation popup opens:

7. Select Yes to confirm the delete action.

Next: Attaching Plans to an Account



Additional Support

Login to the Support portal for additional help and to send questions to our Support team.