Use this type to embed information about an invoice for payment.

## Use cases

Follow this example to ensure that your `Invoice` markup is properly
structured.

> [!NOTE]
> **Note:** Before you start, review how to [embed schemas in emails](https://developers.google.com/workspace/gmail/markup/getting-started) and [test schemas](https://developers.google.com/workspace/gmail/markup/testing-your-schema).

### Invoice for automatic payment

This example shows `Invoice` markup with automatic payment specified:

### JSON-LD

    <script type='application/ld+json'>
    {
      "@context": "http://schema.org",
      "@type": "Invoice",
      "accountId": "123-456-789",
      "minimumPaymentDue": {
        "@type": "PriceSpecification",
        "price": "$70.00"
      },
      "paymentDue": "2015-11-22T08:00:00+00:00",
      "paymentStatus": "PaymentAutomaticallyApplied",
      "provider": {
        "@type": "Organization",
        "name": "Mountain View Utilities"
      },
      "totalPaymentDue": {
        "@type": "PriceSpecification",
        "price": "$70.00"
      }
    }
    </script>

### Microdata

    <div itemscope itemtype="http://schema.org/Invoice">
      <span itemprop="accountId">123-456-789</span>
      <div itemprop="minimumPaymentDue" itemscope itemtype="http://schema.org/PriceSpecification">
        <span itemprop="price">$70.00</span>
      </div>
      <span itemprop="paymentDue">2015-11-22T08:00:00+00:00</span>
      <span itemprop="paymentStatus">PaymentAutomaticallyApplied</span>
      <div itemprop="provider" itemscope itemtype="http://schema.org/Organization">
        <span itemprop="name">Mountain View Utilities</span>
      </div>
      <div itemprop="totalPaymentDue" itemscope itemtype="http://schema.org/PriceSpecification">
        <span itemprop="price">$70.00</span>
      </div>
    </div>

## Test your markup

You can validate your markup using the
[Email Markup Tester Tool](https://www.google.com/webmasters/markup-tester/).
Paste in your markup code and click the **Validate** button to scan the content
and receive a report on any errors present.

## Specification

Review the details of your email to see if any of these additional properties
apply to your invoice. By marking up these additional properties, you allow
Google to display a richer description of the invoice.

# Invoice

Type name: [Invoice](https://developers.google.com/workspace/gmail/markup/reference/types/Invoice)

Extends [Intangible](https://developers.google.com/workspace/gmail/markup/reference/types/Intangible)

| Name | Type | Description |
|---|---|---|
| accountId | [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) | The identifier for the account the payment will be applied to. |
| billingPeriod | [Duration](https://developers.google.com/workspace/gmail/markup/reference/types/Duration) | The time interval used to compute the invoice. |
| broker | [Organization](https://developers.google.com/workspace/gmail/markup/reference/types/Organization) or [Person](https://developers.google.com/workspace/gmail/markup/reference/types/Person) | An entity that arranges for an exchange between a buyer and a seller. In most cases a broker never acquires or releases ownership of a product or service involved in an exchange. If it is not clear whether an entity is a broker, seller, or buyer, the latter two terms are preferred. |
| category | [PhysicalActivityCategory](https://developers.google.com/workspace/gmail/markup/reference/types/PhysicalActivityCategory), [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) or [Thing](https://developers.google.com/workspace/gmail/markup/reference/types/Thing) | A category for the item. Greater signs or slashes can be used to informally indicate a category hierarchy. |
| confirmationNumber | [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) | A number that confirms the given order or payment has been received. |
| customer | [Organization](https://developers.google.com/workspace/gmail/markup/reference/types/Organization) or [Person](https://developers.google.com/workspace/gmail/markup/reference/types/Person) | Party placing the order or paying the invoice. |
| minimumPaymentDue | [PriceSpecification](https://developers.google.com/workspace/gmail/markup/reference/types/PriceSpecification) | The minimum payment required at this time. |
| paymentDue | [DateTime](https://developers.google.com/workspace/gmail/markup/reference/types/DateTime) | The date that payment is due. |
| paymentMethod | [PaymentMethod](https://developers.google.com/workspace/gmail/markup/reference/types/PaymentMethod) | The name of the credit card or other method of payment for the order. |
| paymentMethodId | [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) | An identifier for the method of payment used (e.g. the last 4 digits of the credit card). |
| paymentStatus | [Text](https://developers.google.com/workspace/gmail/markup/reference/types/Text) | The status of payment; whether the invoice has been paid or not. |
| provider | [Organization](https://developers.google.com/workspace/gmail/markup/reference/types/Organization) or [Person](https://developers.google.com/workspace/gmail/markup/reference/types/Person) | The organization providing the reservation. |
| referencesOrder | [Order](https://developers.google.com/workspace/gmail/markup/reference/types/Order) | The Order(s) related to this Invoice. One or more Orders may be combined into a single Invoice. |
| scheduledPaymentDate | [Date](https://developers.google.com/workspace/gmail/markup/reference/types/Date) | The date the invoice is scheduled to be paid. |
| totalPaymentDue | [PriceSpecification](https://developers.google.com/workspace/gmail/markup/reference/types/PriceSpecification) | The total amount due. |

> [!NOTE]
> **Note:** Some schemas that Google uses are still going through the standardization process of [Schema.org](https://schema.org) and might change in the future. For more information, see [Schema.org proposals](https://developers.google.com/workspace/gmail/markup/reference/schema-org-proposals).