{"__v":23,"_id":"565def2bb311ea0d00a38597","category":{"__v":11,"_id":"565def2677f0090d005819bb","pages":["565def2bb311ea0d00a38597","565f2d5d413e06170093dea4","565f2d840dc99e1900f24bb8","565f2dd8bca87d0d006bc68a","565f2e2423fd5f0d00a12a93","565f2f7c0dc99e1900f24bc2","565f2fadbca87d0d006bc698","565f2fe223fd5f0d00a12a9b","565f3011413e06170093debe","565f3040ea46251700972769","5665df7bd8a06b170063f30b"],"project":"56450a342229d7170010928a","version":"56450a342229d7170010928d","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-12-01T19:04:06.860Z","from_sync":false,"order":1,"slug":"reference","title":"Reference"},"parentDoc":null,"project":"56450a342229d7170010928a","user":"55648cf93b87582b003ab8b1","version":{"__v":9,"_id":"56450a342229d7170010928d","project":"56450a342229d7170010928a","createdAt":"2015-11-12T21:52:52.685Z","releaseDate":"2015-11-12T21:52:52.684Z","categories":["56450a352229d7170010928e","56450a472c74cf1900da48ca","565def2677f0090d005819bb","5665dfa0e93ae70d00b96a2a","5665e3db1b6559190020ae8c","5665e47763109d0d0036ba5a","5690123f18c3920d00be8b1c","56944016d8c04d1700e5ae20","569447891005590d0062cace"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"createdAt":"2015-12-01T19:04:11.985Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"## Dashboard\n\n[Your accounts dashboard][1] provides an overview of all customer accounts managed by Recurly. From this view you can search by first name, last name, email address, account code and more. The filters on this view allow you to drill into accounts by different categories. Categories overlap and are not necessarily distinct, *e.g.* the\n**Open** filter will return both **Non-subscribers** and **Subscribers**.\n\n[1]: https://app.recurly.com/go/accounts\n\n####Open\nAccounts that aren't Closed.\n####Non-subscribers\nOpen accounts with no active, canceled, or future subscriptions.\n####Subscribers\nOpen accounts with at least one active or canceled subscription.\n####In Trial\nSubscribers with at least one active or canceled subscription in trial mode.\n####Past Due\nSubscribers with an invoice in the past-due state.\n####Non-renewing\nSubscribers that won't renew after the current billing cycle (*i.e.* recently-canceled).\n####Future\nSubscribers with a subscription that hasn't yet started.\n####Closed\nAccounts that aren't Open.\n\n## Account Search\n\nYou may search for an account on any of the following fields:\n\n* Account code\n* Company name\n* Email\n* First name\n* Last name\n* Username\n* Coupon code\n\n## Account Creation\n\nFrom the accounts overview page, click **New Account** to [create a new customer account][2]. You will be asked to provide the following details:\n\n[2]: https://app.recurly.com/go/accounts/new\n\n\n####Account Code\nUniquely identifies your customers in Recurly. No two customers can share the same account code. Merchants typically align account codes with the same identifiers they use to track users in their own systUsing the customer's email address as their account code is another popular convention among Recurly merchants. Once set, the account code cannot be modified. Account codes cannot start with a period ( . ), slash ( / ), or semicolon ( ; ) and cannot have a second character that is a slash ( / ) or semicolon ( ; ).\n\n####Username\nA secondary identifier that can be searched against on the dashboard.\n\n####Email\nYour customer's email address. When provided, all Recurly communication is sent to this address. The customer will also use this email address to log into your hosted account management pages. This value does need to be unique.\n\n####CC Emails\nAdditional email address that should receive account correspondence. These should be separated only by commas and should be formed as name:::at:::domain.com only. These CC emails will receive all emails that the \"Emfield also receives.\n\n####First Name\nCustomer's first name\n\n####Last Name\nYour customer's last name\n\n####Company\nYour customer's company name (if applicable)\n\n####VAT Number (if applicable)\nVAT information\n\n####Phone Number\nYour customer's Phone number\n\n####Address\nThe account address is used in manual invoices and must contain at least a postal code and country for taxes to be calculated on any of the account's purchases.\n\n\n## Billing Info\n\nOn an account, there is a **Billing Info** section that shows stored payment information. An account can have one payment method at a time. This can be a credit card or PayPal account. Billing Info is usually filled out by the customer upon purchase or when they update their information. The merchant determines how much of the billing address is required in the Admin under Site Settings. Billing Info can be different from the account email and address.\n\n## Account Notes\n\nYour team can leave notes on an account to add context, *e.g.* the reason for a refund, customer requests, and/or complaints. These notes are internal and not exposed to your customers.\n\n## Updating Accounts\n\nOnce an account is created, all values (with the exception of the account code) may be updated.\n\n## Closing Accounts\n\nClosing an account permanently deletes its billing information and cancels any active subscriptions (canceled subscriptions will remain active until the end of the current billing cycle before expiring). We recommend closing accounts only when all business is concluded\nwith a customer.\n\nYou will see the option to close an account when viewing an account in the admin console.\n\n## Reopening Closed Accounts\n\nA closed account can be reopened by clicking the \"Reopen Account\" button in the admin console, or by creating a new account with the same account code. Reopening an account will restore its history but billing information will need to be provided by the customer to continue billing.\n\n## Deleting Accounts\n\nAccounts can only be deleted from your site while in sandbox mode (look for the Clear Test Data button in your site settings). Once your account is in production mode all data is kept for historical accounting and cannot be removed from your site.","excerpt":"Accounts are core to managing your customers inside of Recurly. The account object stores the entire Recurly history of your customer and acts as the entry point for working with a customer's billing information, subscription data, transactions, invoices and more.","slug":"accounts","type":"basic","title":"Accounts"}

Accounts

Accounts are core to managing your customers inside of Recurly. The account object stores the entire Recurly history of your customer and acts as the entry point for working with a customer's billing information, subscription data, transactions, invoices and more.

## Dashboard [Your accounts dashboard][1] provides an overview of all customer accounts managed by Recurly. From this view you can search by first name, last name, email address, account code and more. The filters on this view allow you to drill into accounts by different categories. Categories overlap and are not necessarily distinct, *e.g.* the **Open** filter will return both **Non-subscribers** and **Subscribers**. [1]: https://app.recurly.com/go/accounts ####Open Accounts that aren't Closed. ####Non-subscribers Open accounts with no active, canceled, or future subscriptions. ####Subscribers Open accounts with at least one active or canceled subscription. ####In Trial Subscribers with at least one active or canceled subscription in trial mode. ####Past Due Subscribers with an invoice in the past-due state. ####Non-renewing Subscribers that won't renew after the current billing cycle (*i.e.* recently-canceled). ####Future Subscribers with a subscription that hasn't yet started. ####Closed Accounts that aren't Open. ## Account Search You may search for an account on any of the following fields: * Account code * Company name * Email * First name * Last name * Username * Coupon code ## Account Creation From the accounts overview page, click **New Account** to [create a new customer account][2]. You will be asked to provide the following details: [2]: https://app.recurly.com/go/accounts/new ####Account Code Uniquely identifies your customers in Recurly. No two customers can share the same account code. Merchants typically align account codes with the same identifiers they use to track users in their own systUsing the customer's email address as their account code is another popular convention among Recurly merchants. Once set, the account code cannot be modified. Account codes cannot start with a period ( . ), slash ( / ), or semicolon ( ; ) and cannot have a second character that is a slash ( / ) or semicolon ( ; ). ####Username A secondary identifier that can be searched against on the dashboard. ####Email Your customer's email address. When provided, all Recurly communication is sent to this address. The customer will also use this email address to log into your hosted account management pages. This value does need to be unique. ####CC Emails Additional email address that should receive account correspondence. These should be separated only by commas and should be formed as name@domain.com only. These CC emails will receive all emails that the "Emfield also receives. ####First Name Customer's first name ####Last Name Your customer's last name ####Company Your customer's company name (if applicable) ####VAT Number (if applicable) VAT information ####Phone Number Your customer's Phone number ####Address The account address is used in manual invoices and must contain at least a postal code and country for taxes to be calculated on any of the account's purchases. ## Billing Info On an account, there is a **Billing Info** section that shows stored payment information. An account can have one payment method at a time. This can be a credit card or PayPal account. Billing Info is usually filled out by the customer upon purchase or when they update their information. The merchant determines how much of the billing address is required in the Admin under Site Settings. Billing Info can be different from the account email and address. ## Account Notes Your team can leave notes on an account to add context, *e.g.* the reason for a refund, customer requests, and/or complaints. These notes are internal and not exposed to your customers. ## Updating Accounts Once an account is created, all values (with the exception of the account code) may be updated. ## Closing Accounts Closing an account permanently deletes its billing information and cancels any active subscriptions (canceled subscriptions will remain active until the end of the current billing cycle before expiring). We recommend closing accounts only when all business is concluded with a customer. You will see the option to close an account when viewing an account in the admin console. ## Reopening Closed Accounts A closed account can be reopened by clicking the "Reopen Account" button in the admin console, or by creating a new account with the same account code. Reopening an account will restore its history but billing information will need to be provided by the customer to continue billing. ## Deleting Accounts Accounts can only be deleted from your site while in sandbox mode (look for the Clear Test Data button in your site settings). Once your account is in production mode all data is kept for historical accounting and cannot be removed from your site.