# My organizations and websites

When you first log in to Rebilly, you create an organization as part of the setup process.
A default website is created when a new organization is created.

An organization is an entity that represents you, or your company, as a merchant.

A website is where your organization obtains a customer through a subscription.
It is also the processor account and billing descriptor used for payment transactions.

## Add a website

Use this process to add a website to your organization in Rebilly.

1. In the left navigation bar, press **Settings**.
2. In the **Management** section, press **My organization & websites**.
3. In the right of the page, press **Add website**.
4. In the **Website logo** section, press the upload logo icon, and add a logo.
5. In the **Website information** section:
    1. In the **Website name** field, enter a website name.
    2. In the **Domain** field, enter the domain of the website.
    3. In the **Customer service phone** field, enter a phone number.
    4. In the **Customer service email** field, enter an email address.
6. Press **Save**.

## Create additional organizations

Rebilly supports the association of multiple organizations to a single user login.
If you have multiple entities, you can choose to use a single Rebilly account, or create a separate Rebilly account for each organization.
For example, this is beneficial if you are managing two separate and unrelated businesses.

Invoices and orders must be associated with a single organization.
This is a mandatory requirement when creating an invoice, subscription, or payment.
A gateway account can be associated with one organization only.

To create an additional organization:

1. In the top left corner of the page, press your organization name.
2. In the drop-down, press **Add new organization**.
3. In the **Organization name** field, enter the name of the organization.
4. In the **Organization website** field, enter the URL of the organization.
5. In the **Country** dropdown, select the country of the organization.
6. In the **Reporting currency** dropdown, select the currency of the organization.
7. Press **Add organization**.

## Configure a custom domain

Custom domains are supported in billing portals, quotes, and payouts, and for the public files of your organization, such as uploaded images.
Instead of using the default Rebilly domain: `portal.secure-payments.app`, you can use your own.
A custom domain has one purpose: hosted pages, or media.

After you create a custom domain for hosted pages, select it when you create a billing portal.
You can also edit the settings later to change the domain.
For more information, see [Create a billing portal](https://www.rebilly.com/docs/settings/billing-portals/#create-a-billing-portal).
Once a media domain is verified, the public files of your organization are served from the media domain.
If you delete the media domain, links to public files on the media domain stop working.

To create a custom domain:

1. In the left navigation bar, press **Settings**.
2. In the **Management** section, press **My organization & websites**.
3. In the **Custom domains** section, press **Add custom domain**, then in the **Domain** field, enter your custom domain.
4. Under **Use this domain for**, select from the following:
    - **Hosted pages**: Checkout forms, payment forms, and billing portals.
    - **Media**: Public files, such as images.
      An organization can have one media domain.
      A hostname cannot be a media domain in both the live and the sandbox environment.
5. Press **Add**.
6. Log in to your DNS management service, create a CNAME DNS entry for your custom domain, and point it to the Rebilly URL that matches the purpose of the domain:
    - Hosted pages, live environment: `custom.secure-payments.app`
    - Hosted pages, sandbox environment: `sandbox-custom.secure-payments.app`
    - Media, live environment: `media.rebilly.com`
    - Media, sandbox environment: `media-sandbox.rebilly.com`
7. Wait until the domain has the **Verified** status.
  A hosted pages domain is verified a few minutes after the CNAME DNS entry is created, and receives its signed SSL certificate on the first page request.
  A media domain is verified once its certificate is issued, which can take up to an hour.
  If a media domain still has the **Pending** status after an hour, delete it and add it again.
  For information on what each status means, see [Custom domain statuses](#custom-domain-statuses).

### Custom domain statuses

In the **Custom domains** section, each custom domain has one or two of the following statuses:

- **Pending**: The domain is not verified yet.
  The domain is pending until the CNAME DNS entry points to the Rebilly URL that matches the purpose of the domain.
  A media domain is also pending until its certificate is issued.
  Issuing a certificate takes up to an hour.
  The status is checked every few minutes.
- **Verified**: The domain is ready to use.
  A verified media domain is checked again every hour.
  If a problem is found, the domain keeps the **Verified** status and a second status is displayed next to **Verified**.
  After the problem is fixed, the second status is removed at the next hourly check.
- **Certificate failed**: The certificate for the domain cannot be issued and is not requested again automatically.
  This status is displayed for media domains only.
  A common cause is a Certification Authority Authorization (CAA) DNS entry on the domain that does not include Amazon as a certificate authority.
  To request a new certificate, correct the DNS entries for the domain, then delete the custom domain and add it again.
  This status can also be displayed next to **Verified**, for example when the certificate for the domain expires, and the same fix applies.
- **Hostname taken**: The domain is already set up on a content delivery network (CDN), for example as a media domain in the other environment.
  This status is displayed for media domains only.
  A hostname cannot be a media domain in both the live and the sandbox environment.
  To use the domain in this environment, delete it in the other environment, or remove it from the CDN where it is set up.
  Within an hour, the domain is verified in this environment.
  You do not need to add the domain again.
  If you cannot find where the domain is set up, [contact Rebilly support](/support/).
- **CNAME missing**: The CNAME DNS entry of a verified media domain no longer points to the Rebilly URL for media.
  This status is displayed next to **Verified**, for media domains only.
  To fix the problem, point the CNAME DNS entry back to the Rebilly URL for media.

## Edit a website

Use this process to edit the details of a website.

1. In the left navigation bar, press **Settings**.
2. In the **Management** section, press **My organization & websites**.
3. To edit a website: On the right of a website tile, press **Actions**, then press **Edit Website**.
4. In the **Website logo** section, select from the following:
    - Add a logo: Press the upload logo icon.
    - Change a logo: Press **Change logo**.
    - Delete a logo: Press **Remove logo**.
5. In the **Website information** section:
    1. In the **Website name** field, enter a website name.
    2. In the **Domain** field, enter the domain of the website.
    3. In the **Customer service phone** field, enter a phone number.
    4. In the **Customer service email** field, enter an email address.
6. Press **Save**.

## Edit an organization

Use this process to edit the details of an organization and to globally configure the Time To Live (TTL) of pending orders.

1. In the left navigation bar, press **Settings**.
2. In the **Management** section, press **My organization & websites**.
3. On the right of the **Organization details** tile, press **Edit**.
4. Select from the following:

  **Add or change organization logo**

  In the **Organization logo** section, select from the following:

    - Add a logo: Press the upload logo icon.
    - Change a logo: Press **Change logo**.
    - Delete a logo: Press **Remove logo**.
  **Edit organization information**

  Use this process to edit the details of an organization.

  In the **Organization information** section:

    1. In the **Organization name** field, edit the organization name.
    2. In the **Address**, **City**, **Country**, **Region**, and **Postal code** fields, enter or edit the address of the organization.
    3. In the **Phone number** field, enter or edit the phone number of the organization.
      To add more than one phone number, press **Add phone number**.
      If the organization has more than one phone number, to set the default phone number, press **Make primary**.
    4. In the **Email** field, enter or edit the email address of the organization.
      To add more than one email address, press **Add email**.
      If the organization has more than one email address, to set the default email address, press **Make primary**.
  **Configure organization settings**

  To configure global organization settings that are applied to all websites in the organization, in the **Organization settings** section, select from the following:

  **Tax descriptor that is displayed on invoices**

  To specify the tax descriptor that is displayed on invoices: Select the **Tax descriptor** checkbox and enter the tax descriptor.

  **Invoice time zone for invoice timestamps**

  To specify the time zone for invoice timestamps: Select the **Invoice time zone** field and select the time zone.
  For more information, see [Invoice time zone](/docs/settings/organizations-and-websites#invoice-time-zone-for-invoice-timestamps).

  **Time To Live (TTL) of pending orders**

  To specify the Time To Live (TTL) of pending orders, and automatically abandon them if a customer does not activate the order within a specific time frame:

    1. In the **Pending orders and delinquency periods** section, select the **Automatically abandon pending orders** checkbox.
    2. Specify the timeframe.
  **Delinquency period for all orders**

  To specify a delinquency period for all orders, and automatically churn subscriptions if an invoice is not paid within the specified time frame:

    1. In the **Pending orders and delinquency periods** section, select the **Automatically add delinquency periods to orders** checkbox.
    2. Specify the delinquency period.
  **Subtract recurring discounts with a specified end date or usage limit from order MRR**

  In the **Monthly Recurring Revenue (MRR)** section, select the **Subtract recurring discounts with a specified end date or usage limit from order MRR** checkbox.

  For more information, see [Monthly recurring revenue](/docs/kpis/billing-kpis#monthly-recurring-revenue).

  **Subtract one-time discounts from order MRR**

  In the **Monthly Recurring Revenue (MRR)** section, select the **Subtract one-time discounts from order MRR** checkbox.

  For more information, see [Monthly recurring revenue](/docs/kpis/billing-kpis#monthly-recurring-revenue).
5. Press **Save**.

## Edit organization settings

Use this process to edit global organization settings that are applied to all orders that are created in the organization.

1. In the left navigation bar, press **Settings**.
2. In the **Management** section, press **My organization & websites**.
3. On the right of the **Organization settings** tile, press **Edit**.
4. Select from the following:

  **Tax descriptor that is displayed on invoices**

  To specify the tax descriptor that is displayed on invoices: Select the **Tax descriptor** checkbox and enter the tax descriptor.

  **Invoice time zone for invoice timestamps**

  To specify the time zone for invoice timestamps: Select the **Invoice time zone** field and select the time zone.
  For more information, see [Invoice time zone](/docs/settings/organizations-and-websites#invoice-time-zone-for-invoice-timestamps).

  **Time To Live (TTL) of pending orders**

  To specify the Time To Live (TTL) of pending orders, and automatically abandon them if a customer does not activate the order within a specific time frame:

    1. In the **Pending orders and delinquency periods** section, select the **Automatically abandon pending orders** checkbox.
    2. Specify the timeframe.
  **Delinquency period for all orders**

  To specify a delinquency period for all orders, and automatically churn subscriptions if an invoice is not paid within the specified time frame:

    1. In the **Pending orders and delinquency periods** section, select the **Automatically add delinquency periods to orders** checkbox.
    2. Specify the delinquency period.
  **Subtract recurring discounts with a specified end date or usage limit from order MRR**

  In the **Monthly Recurring Revenue (MRR)** section, select the **Subtract recurring discounts with a specified end date or usage limit from order MRR** checkbox.

  For more information, see [Monthly recurring revenue](/docs/kpis/billing-kpis#monthly-recurring-revenue).

  **Subtract one-time discounts from order MRR**

  In the **Monthly Recurring Revenue (MRR)** section, select the **Subtract one-time discounts from order MRR** checkbox.

  For more information, see [Monthly recurring revenue](/docs/kpis/billing-kpis#monthly-recurring-revenue).

## Export organization data

Use this option to export organization data in ZIP format.
You can only process one data export request at a time.
Data export requests must finish processing before a new data export can be requested.

1. In the left navigation bar, press **Settings**.
2. In the **Management** section, press **My organization & websites**.
3. In the **Export organization data** section, press **Export**, then wait until the data is generated.
4. When the data generation process is complete, to download in ZIP format, press **Download the export file**.

## Manage Apple Pay domains

Apple Pay works in embedded payment forms only on domains that are registered with Apple.
An organization can have up to 99 Apple Pay domains in each environment.
The live and sandbox environments have separate lists of domains.

To use Apple Pay on a domain, host the [Rebilly verification file for Apple Pay](https://www.rebilly.com/.well-known/apple-developer-merchantid-domain-association) on the domain.
For example, `https://store.example.com/.well-known/apple-developer-merchantid-domain-association`.
If you use the Rebilly custom domains feature, the file is already on the domain.
When the file is on a domain, the domain is registered automatically the first time a customer pays with Apple Pay on it.
For information on how to set up Apple Pay, see [Set up Apple Pay](/docs/dev-docs/digital-wallets#set-up-apple-pay).

### View Apple Pay domains

Use this process to view the Apple Pay domains of your organization.

1. In the left navigation bar, press **Settings**.
2. In the **Management** section, press **My organization & websites**.
3. In the **Apple Pay domains** section, view the domains and the number of domains out of 99.

### Add an Apple Pay domain

Use this process to register a domain before the first customer visits it.
The verification file must be on the domain.

1. In the left navigation bar, press **Settings**.
2. In the **Management** section, press **My organization & websites**.
3. In the **Apple Pay domains** section, press **Add Apple Pay domain**.
4. In the **Domain** field, enter or select the domain exactly as customers visit it, for example, `store.example.com`.
5. Press **Save**.

### Remove an Apple Pay domain

Use this process to remove a domain that you do not use.
When the organization has 99 domains, Apple Pay does not work on a new domain until you remove a domain.

When you remove a domain, Apple Pay stops working on that domain.
If the verification file is still on the domain, the domain is registered again the next time a customer pays with Apple Pay on it.

1. In the left navigation bar, press **Settings**.
2. In the **Management** section, press **My organization & websites**.
3. In the **Apple Pay domains** section, on the right of the domain, press **Remove**.
4. In the confirmation dialog, press **Remove domain**.

## Manage tax ID numbers

Use this process to add, delete, or choose a default tax ID number.

As a merchant, you may need to display tax ID numbers on invoices you issue.
This process describes how to add and manage organization tax ID numbers.
For more information on managing taxes, see [Taxes](/docs/settings/taxes).

1. In the left navigation bar, press **Settings**.
2. In the **Management** section, press **My organization & websites**.
3. In the **Tax ID numbers** section, select from the following:
    - Add a new tax ID number: Press **Add tax ID number**.
    - Delete a tax ID number: On the right of a tax ID number, press **Actions**, then press **Delete**.
    - Set a default tax ID number: On the right of a tax ID number, press **Actions**, then press **Set as default**.

## Manage tax locations

Use this process to add, edit, or delete tax locations.

As a merchant, you may need to collect taxes in different locations using the TaxJar or Avalara tax calculator.
This process describes how to add and manage additional organization tax addresses.
For more information on managing taxes, see [Taxes](/docs/settings/taxes).

This feature is only available to U.S.-based organizations.

1. In the left navigation bar, press **Settings**.
2. In the **Management** section, press **My organization & websites**.
3. In the **Tax locations** section, select from the following:
    - Add a new tax location: Press **Add tax location**.
    - Edit a tax location: On the right of a tax location, press **Edit**, edit, then press **Update**.
    - Delete a tax location: On the right of a tax location, press **Delete**.

## Set default payout allocation order

Use this process to set the organization default configuration for automatic payout allocations, including which payment methods are used and their priority.

If the default order for payout allocations is not set, the priority is: payment cards, then alternative payment methods, then the selected payment instrument.

When a payout request batch has no saved allocation order, the organization default applies.
To set a different allocation order for one batch, use the **Allocation order** section on the batch **In progress** tab and press **Save**.

For more information, see [Automatically allocate funds for a batch](/docs/data-tables/manage-payout-requests#automatically-allocate-funds-for-a-batch) and [Allocate funds](/docs/data-tables/manage-payout-requests#allocate-funds).

1. In the left navigation bar, press **Settings**.
2. In the **Management** section, press **My organization & websites**.
3. In the **Default payout allocation order** section, select one or more of the following:
    - Add a payment method: Press **Add a method**, search for and select a payment method, then press **Apply changes**.
    - Remove a payment method: On the right of the payment method, press **Remove**, then press **Apply changes**.
      This option is available only when more than two payment methods are configured.
    - Reorder payment methods: Press and drag the payment methods to set priority, then press **Apply changes**. \

The order of payment methods determines allocation priority.
Allocation starts with the first method and continues in order until the payout amount is fulfilled, or no further allocations are possible.

## Edit payout request settings

Use this process to configure the initial state for payout requests for a specific website.
For information on the payout request lifecycle, see [Manage payout requests](/docs/data-tables/manage-payout-requests#payout-request-process).

If the initial payout request state is not configured, the default status is `ready`.

You can set the initial state to one of the following:

- `pending`: The payout request enters the `pending` state for a configured period before it can be reviewed or approved by a member of your organization.
  When the pending period ends, the payout request automatically transitions to the `ready` state.
- `ready`: The payout request enters the `ready` state and can be reviewed and approved immediately by a member of your organization.

1. In the left navigation bar, press **Settings**.
2. In the **Management** section, press **My organization & websites**.
3. In the **Websites** section, in the right of a website, press **Actions**, then press **Edit payout request settings**.
4. In the **Initial payout request state** section, select from the following:

  **Create payout requests in the 'ready' status**

    1. Select **Ready**.
    2. Press **Save settings**.
  **Create payout requests in the 'pending' status**

    1. Select **Pending**.
    2. In the **Pending period** field, enter the number of hours that payout requests remain in the `pending` status.
    3. In the **Transition time** field, enter the daily time when eligible payout requests automatically transition from pending to ready.
    4. Press **Save settings**.

## Obtain your organization ID and website ID

Use this process to obtain your organization ID and website ID.
Both IDs are required to interact with the Rebilly API.

When you first log in to Rebilly, you create an organization as part of the setup process.
A default website is created when a new organization is created.
The website ID is a unique identifier which describes your website or websites.
The organization ID describes your organization or organizations.

1. In the left navigation bar, press **Settings**.
2. In the **Management** section, press **My organization & websites**.
3. In the **Organization details** section, note the **ID** value.
4. In the **Websites** section, note the **ID** value.

## View organization details

Use this process to view organization details.

1. In the left navigation bar, press **Settings**.
2. In the **Management** section, press **My organization & websites**.
3. In the **Organization details** section, view the organization details.
  To edit organization details, press **Edit**.
