On This Page

{#jumplink-list}  
[Markdown](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing.md)

Generating a Report with Invoice Data {#invoicing-report}
=========================================================

This task describes how to use the Reports feature in the `Business Center` to generate a report that contains only your invoicing data.

1. On the left navigation panel, navigate to ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-icon-reports.svg/jcr:content/renditions/original) **Reports \&gt; Downloadable Reports \&gt; Available Reports**.  
   The Available Reports window appears. {#invoicing-report_step-1}
   {#invoicing-report_step-1}
2. Click the **Create custom report**.  
   The Create Report Subscription window appears.  
   ![](/content/dam/new-documentation/documentation/en-us/olh/Invoicing/images/invoice-report-1.png/jcr:content/renditions/original) {#invoicing-report_step-2}
   {#invoicing-report_step-2}
3. In the Advanced Report Features section, click the Connection Method drop-down menu and choose **Invoicing**.  
   There is additional required information you must enter before you can generate a report. For more information, see [Creating New Custom Report Subscriptions](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/create_new_subscription.md "").  
   ![](/content/dam/new-documentation/documentation/en-us/olh/Invoicing/images/invoice-report-2.png/jcr:content/renditions/original) {#invoicing-report_step-3-cmd}
   {#invoicing-report_step-3}
4. When done, click **Create**.  
   The Report Subscription Management window appears.  
   Click the **Custom Report Subscriptions** tab to view your new custom report that includes invoicing data.  
   ![](/content/dam/new-documentation/documentation/en-us/olh/Invoicing/images/invoice-report-3.png/jcr:content/renditions/original) {#invoicing-report_step-4}
   {#invoicing-report_step-4}

Invoicing Developer Guide {#invoicing-about-guide}
==================================================

This section describes how to use this guide and where to find further information.

Audience and Purpose
:
This guide is written for merchants who want to use the invoicing services. It describes tasks that a merchant must complete in order to create, send, and manage invoices using the invoicing API or Microsoft Outlook add-in. It also describes how to include extra security to your invoices with payer authentication and how to set up automated webhook notifications when an invoice is updated. It is intended to help the merchant provide a seamless customer payment experience.

Convention
:
This special statement is used in this document:

    > IMPORTANT
    > An *Important* statement contains information essential to successfully completing a task or learning a concept.

Customer Support
:
For support information about any service, visit the Support Center:

<http://support.cybersource.com>

Recent Revisions to This Document {#invoicing-doc-rev}
======================================================

25.06.02
--------

Updated the list of webhook event types that you can subscribe to receive notifications. See [Webhook Notifications for Invoicing](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-webhooks-intro.md "").

25.06.01
--------

This revision contains only editorial changes and no technical updates.

25.04.01
--------

This revision contains only editorial changes and no technical updates.

25.03.01
--------

Added information about how to approve and reject invoice payments that are flagged for fraud using the `Business Center`. See [Approving Payment Flagged for Fraud](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-ebc/invoicing-fraud-review.md "") and [Rejecting Payment Flagged for Fraud](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-ebc/invoicing-fraud-review-reject.md "").  
Added information about how to create a custom message and select menu on your invoice checkout page using the `Business Center`. See [Create a Custom Text Field for an Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-ebc/invoicing-mdf-textbox.md "").

25.02.01
--------

Updated the supported events for Invoicing Webhooks. For more information, see [Webhook Notifications for Invoicing](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-webhooks-intro.md "").  
Added support for filtering invoice transaction using transaction management in the `Business Center`. See [Filtering Invoice Transactions in Transaction Management](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-ebc/invoicing-trxn-mgmt-filter.md "").  
Added support for generating a custom report with invoice transaction data using the `Business Center`. See [Generating a Report with Invoice Data](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-ebc/invoicing-ebc-reports.md "").

24.10.01
--------

Added these new sections for drafting an invoice:

* Create a draft invoice that is not emailed to the customer when the invoice is published. See [Create a Draft Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-draft-intro.md "").
* Create a draft invoice that is emailed to the customer when the invoice is published. See [Create a Deliverable Draft Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-draft-dlvr-intro.md "").

24.07.01
--------

This guide has been reorganized.  
Added support for the Visa Invoicing Add-In for Microsoft Outlook. For more information, see [Add Invoicing Add-In to Outlook](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-addin-intro.md "").  
Added support for Invoicing Webhooks. For more information, see [Webhook Notifications for Invoicing](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-webhooks-intro.md "").  
Added information about using the invoicing service in the `Business Center`. See [Manage Invoices Using the Business Center](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-ebc.md "").

24.05.01
--------

Initial release.

VISA Platform Connect: Specifications and Conditions for Resellers/Partners {#vpc-partner-reseller-disclaimer}
==============================================================================================================

The following are specifications and conditions that apply to a Reseller/Partner enabling its merchants through Cybersource for Visa Platform Connect ("VPC") processing. Failure to meet any of the specifications and conditions below is subject to the liability provisions and indemnification obligations under Reseller/Partner's contract with Visa/Cybersource.

1. Before boarding merchants for payment processing on a VPC acquirer's connection, Reseller/Partner and the VPC acquirer must have a contract or other legal agreement that permits Reseller/Partner to enable its merchants to process payments with the acquirer through the dedicated VPC connection and/or traditional connection with such VPC acquirer.
2. Reseller/Partner is responsible for boarding and enabling its merchants in accordance with the terms of the contract or other legal agreement with the relevant VPC acquirer.
3. Reseller/Partner acknowledges and agrees that all considerations and fees associated with chargebacks, interchange downgrades, settlement issues, funding delays, and other processing related activities are strictly between Reseller and the relevant VPC acquirer.
4. Reseller/Partner acknowledges and agrees that the relevant VPC acquirer is responsible for payment processing issues, including but not limited to, transaction declines by network/issuer, decline rates, and interchange qualification, as may be agreed to or outlined in the contract or other legal agreement between Reseller/Partner and such VPC acquirer.

DISCLAIMER: NEITHER VISA NOR CYBERSOURCE WILL BE RESPONSIBLE OR LIABLE FOR ANY ERRORS OR OMISSIONS BY THE Visa Platform Connect ACQUIRER IN PROCESSING TRANSACTIONS. NEITHER VISA NOR CYBERSOURCE WILL BE RESPONSIBLE OR LIABLE FOR RESELLER/PARTNER BOARDING MERCHANTS OR ENABLING MERCHANT PROCESSING IN VIOLATION OF THE TERMS AND CONDITIONS IMPOSED BY THE RELEVANT Visa Platform Connect ACQUIRER.

Introduction to Invoicing {#Introduction}
=========================================

The Invoicing API enables you to create and send invoices as well as track outstanding invoices. Your customers can pay using their preferred payment method from any device on a secure `Cybersource` hosted website. Automated reminders are available to help you remind customers of upcoming due dates or overdue invoices. For more information, see [Invoicing API Requests](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro.md "").  
You can also customize your invoice payment page to display your brand logo and color, as well as add custom messages to your invoice emails. Shipping information and phone numbers can also be collected at the time of payment. For more information, see [Invoice Settings API Requests](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-settings-intro.md "").  
The Invoicing API uses Cybersource's `Unified Checkout` to securely process payments so that you do not have to handle confidential payment data. Fraud and risk management tools are incorporated into `Unified Checkout` to prevent fraud and reduce chargebacks. For additional security, you can add payer authentication to your invoice payment processing. For more information, see [Add Payer Authentication to Invoicing](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-features-intro.md "").  
To quickly and easily create, send, and manage invoices from your Microsoft Outlook desktop application, `Cybersource` offers the Visa Invoicing Add-In. The add-in can be downloaded and installed from Microsoft's AppSource. For more information, see [Add Invoicing Add-In to Outlook](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-addin-intro.md "").  
To receive notifications when an invoice is paid, sent, or cancelled, you can create a subscription to receive invoicing webhook notifications. For more information, see [Webhook Notifications for Invoicing](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-webhooks-intro.md "").

> IMPORTANT
> The merchant is responsible for complying with any legal and tax requirements when issuing invoices to clients. ` Cybersource ` does not certify that the invoicing tool meets any such client requirements.

Requirements
------------

The Invoicing API requires a transaction MID account and API authentication before you can begin sending API messages to `Cybersource`. For more information, see the [*REST Getting Started User Guide*](https://developer.cybersource.com/docs/cybs/en-us/platform/developer/all/rest/rest-getting-started/restgs-intro.md "").

Use the `Business Center`
-------------------------

You can also create, process, and manage invoices using the `Business Center`. For information about how to access and use invoicing in the `Business Center`, see [Manage Invoices Using the Business Center](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-ebc.md "").

Configure `Unified Checkout`
----------------------------

Invoicing supports `Unified Checkout`, which enables you to accept numerous types of digital payments, such as Apple Pay, `Click to Pay`, and Google Pay.  
For more information about enabling these digital payments using `Unified Checkout`, see the [Enable Digital Payments](https://developer.cybersource.com/docs/cybs/en-us/digital-accept-flex/developer/all/rest/digital-accept-flex/uc-intro/uc-configuration-intro/uc-enable-digital-pay-intro.md "") section in the *Digital Accept Secure Integration Developer Guide*.

Tokenization for Merchant-Initiated Transactions {#Introduction_mits}
---------------------------------------------------------------------

You can create Token Management Service (TMS) tokens from invoice transactions using Transaction Management in the `Business Center`.

> IMPORTANT
> If you create and use TMS tokens for merchant-initiated transactions (MITs), you must comply with the **Consent Agreement Provisions** as stated in the [*Improving Authorization Management for Transactions with Stored Credentials*](https://usa.visa.com/dam/VCOM/global/support-legal/documents/stored-credential-transaction-framework-vbs-10-may-17.pdf "") guide.

Sandbox Testing {#Introduction_invoice-settings-toc}
----------------------------------------------------

You can test invoicing API requests using the [Invoicing API Reference](https://developer.cybersource.com/api-reference-assets/index.md#invoicing "") in the `Cybersource` developer center.

Invoicing API Requests {#invoicing-services-intro}
==================================================

When creating an invoice, you can choose to create a draft or published invoice. If you create a published invoice, you can specify whether the invoice is immediately emailed to the customer or not. This table describes the different methods for creating an invoice.

|             Invoice Method             |                                                                                                                                                                                                                                                                                                                                                                                  Description                                                                                                                                                                                                                                                                                                                                                                                   |                                            Field Values Specific to this Method                                            |
|----------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------|
| Create a Draft Invoice                 | Create an invoice draft that is only viewable by you. When you are ready to share the invoice with the customer, you must publish it by sending a *send invoice* request. To create a draft invoice that is **not** sent as an email to the customer when you publish it, see [Create a Draft Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-draft-intro.md ""). To create a draft invoice that is sent as an email to the customer when you publish it, see [Create a Deliverable Draft Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-draft-dlvr-intro.md ""). | invoiceInformation.deliveryMode : Possible values: * `email` * `none` invoiceInformation.sendImmediately : Set to `false`. |
| Create and Send an Invoice Immediately | Create a published invoice that is immediately emailed to the customer by Cybersource. The customer can view and pay the invoice when they receive the invoice email. For more information, see [Create and Send an Invoice Immediately](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-send-intro.md "").                                                                                                                                                                                                                                                                                                                                                                       | invoiceInformation.deliveryMode : Set to `email`. invoiceInformation.sendImmediately : Set to `true`.                      |
| Create an Invoice without Sending it   | Create a published invoice that you can share with the customer by sending the customer the generated URL. This method gives you control over the distribution of the invoices. For more information, see [Create an Invoice without Sending it](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-intro.md "").                                                                                                                                                                                                                                                                                                                                                                    | invoiceInformation.deliveryMode : Set to `none`. invoiceInformation.sendImmediately : Set to `true`.                       |
[Invoice Creation Methods]

The invoicing API also enables you to perform these follow-on services after creating an invoice:

* [Send or resend an invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-send-intro.md "")
* [Get an invoice's details](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-get-details-intro.md "")
* [Get lists of invoices](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-get-list-intro.md "")
* [Update an invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-update-intro.md "")
* [Cancel an invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-cancel-intro.md "")  
  You can also customize your invoices to align with your brand. For more information, see [Invoice Settings API Requests](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-settings-intro.md "").

Create a Draft Invoice {#invoicing-services-create-draft-intro}
===============================================================

Drafting an invoice creates an unpublished invoice that is viewable only by you. When sending the draft invoice request, set the invoiceInformation.deliveryMode field to `none` to ensure that the invoice draft is not automatically sent in an email message to the customer when the invoice is published. When you are ready to publish the draft invoice, you can send a *send invoice* request. After publishing the drafted invoice, the invoice's status updates from `DRAFT` to `CREATED`.

Itemized Invoices
:
An invoice can display a single billed amount or list up to 30 billed items. To list the billed items in the invoice, include the items in the request using the line item array fields. An invoice with line items is known as an *itemized* invoice. For more information about how to include line items in your request, see [Including Line Items in an Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-line-items.md "").

Invoice Numbers
:
You can assign a unique invoice number in the invoiceInformation.invoiceNumber request field. The invoice number is required for follow-on API requests and tracking. You should store the invoice number in your system so that you can optimally perform the follow-on requests. If you do not include a unique invoice number when creating an invoice, `Cybersource` generates a unique invoice number for you in the invoiceInformation.invoiceNumber response field. IMPORTANT You cannot update the invoice number after it is generated.

Installment Payments
:
Invoices can be paid in installment payments when these fields and values are included in the request. If an invoice is payable in installments, multiple customers can make payments towards the same invoice.

    invoiceInformation.allowPartialPayments
    :
        Set to `true`.


    orderInformation.amountDetails.minimumPartialAmount
    :
        Set to the minimum amount allowed for a partial payment.

Partner Information
:
If your merchant account is associated with a `Cybersource` partner, you can include your partner solution ID (PSID) in the request message for tracking and reporting purposes. To include your PSID, use the clientReferenceInformation.partner.solutionId request field and set its field value to your PSID.

Alternative Methods to Create an Invoice
:
To create a *draft* invoice that is sent in an email message to the customer when you publish it, see [Create a Draft Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-draft-intro.md "").

    To create a new invoice that is **not** immediately sent in an email to the customer, see [Create an Invoice without Sending it](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-intro.md "").

    To create **and send** a new invoice at the same time, see [Create and Send an Invoice Immediately](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-send-intro.md "").

Endpoint
--------

Send an API POST request message to one of these endpoints:  
**Test:** `POST ``https://apitest.cybersource.com``/invoicing/v2/invoices`  
**Production:** `POST ``https://api.cybersource.com``/invoicing/v2/invoices`  
**India Production:** `POST https://api.in.cybersource.com/invoicing/v2/invoices`

Response to a Successful Request
--------------------------------

A successfully drafted invoice is indicated by the `DRAFT` status in the status response field.  
The redirect URL generated in the invoiceInformation.paymentLink response field is usable only by you and not the customer.  
Additional invoice details are included in the response message for you to review.

Follow-On API Requests
----------------------

After successfully drafting an invoice, you can send these follow-on API requests.

Send an Invoice
:
After drafting an invoice, you can publish and send an invoice using the send invoice request. For more information, see [Send an Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-send-intro.md "").

Update an Invoice
:
To update customer information or item details in an already drafted invoice, send an update invoice request. For more information, see [Update an Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-update-intro.md "").

Cancel an Invoice
:
To cancel a drafted invoice, send the a cancel invoice request. For more information, see [Cancel an Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-cancel-intro.md "").

Get Invoice Details
:
To retrieve a drafted invoice's details, send a get invoice details request. For more information, see [Get Invoice Details](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-get-details-intro.md "").

Line Items {#invoicing-services-line-items}
===========================================

You can itemize invoices by using the line item fields when you create, draft, and update an invoice.  
*Line items* are used to include information about your customers' purchases. Information can include product name, quantity, and price.  
Line items are included in a request in the lineItem\[\] array request field.  
These fields are required for each line item in your request:

[orderInformation.lineItems\[\].productName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-product-name.md "")
:

orderInformation.lineItems\[\].productSku
:

[orderInformation.lineItems\[\].quantity](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-quantity.md "")
:

[orderInformation.lineItems\[\].totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-total-amount.md "")
:

[orderInformation.lineItems\[\].unitPrice](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-unit-price.md "")
:

These fields are optional for each line item in your request:

[orderInformation.lineItems\[\].discountAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-discount-amount.md "")
:

orderInformation.lineItems\[\].discountRate
:

[orderInformation.lineItems\[\].taxAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-tax-amount-request.md "")
:

[orderInformation.lineItems\[\].taxRate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-tax-rate.md "")
:

Example: Including Line Items  
This example shows three valid line items.

```
{ 
  "orderInformation": {
    "lineItems": [
      {
        "productSku": "ABCD1234",
        "productName": "First line item's name",
        "quantity": "20",
        "unitPrice": "12.05",
        "discountAmount": "13.04",
        "taxAmount": "0.0",
        "taxRate": "0.0",
        "totalAmount": "247.86"
      },
      {
        "productSku": "EFGH5678",
        "productName": "Second line item's name",
        "quantity": "20",
        "unitPrice": "12.05",
        "discountAmount": "13.04",
        "taxAmount": "0.0",
        "taxRate": "0.0",
        "totalAmount": "247.86"
      },
      {
        "productSku": "IJKL9999",
        "productName": "Third line item's name",
        "quantity": "20",
        "unitPrice": "12.05",
        "discountAmount": "13.04",
        "taxAmount": "0.0",
        "taxRate": "0.0",
        "totalAmount": "247.86"
      }
    ]
  }
}
```

Required Fields for Drafting an Invoice {#invoicing-services-create-draft-req-fields}
=====================================================================================

This section lists the required fields necessary to create these types of invoices:
* In-person draft invoice
* Email draft invoice
* Itemized email draft invoice

The invoice created using these fields and specified values is not immediately sent to the customer.

Required Fields for Drafting an In-Person Invoice
-------------------------------------------------

invoiceInformation.deliveryMode
:
Set to one of these possible values to determine whether or not the invoice is emailed to the customer when you send a send invoice request:

    * `email`: An invoice email is sent to the customer when you send the follow-on send invoice request for this invoice draft. The invoice status updates to `SENT`.
    * `none`: When you process a follow-on send invoice request to publish the drafted invoice, the invoice is not sent in an email to the customer. To share the invoice with the customer, send the customer the redirect URL in the invoiceInformation.paymentLink response field. The invoice updates change to `CREATED`.

invoiceInformation.description
:

invoiceInformation.dueDate
:

invoiceInformation.sendImmediately
:
Set to `false`.

[orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "")
:

[orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "")
:

Required Fields for Drafting an Email Invoice {#invoicing-services-create-draft-req-fields_customer-fields}
-----------------------------------------------------------------------------------------------------------

customerInformation.email
:

customerInformation.name
:

invoiceInformation.deliveryMode
:
Set to `email`.

invoiceInformation.dueDate
:

invoiceInformation.sendImmediately
:
Set to `false`.

[orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "")
:

[orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "")
:

Required Fields for Drafting an Invoice with Line Items {#invoicing-services-create-draft-req-fields_line-item-fields}
----------------------------------------------------------------------------------------------------------------------

customerInformation.email
:

customerInformation.name
:

invoiceInformation.deliveryMode
:
Set to one of these possible values to determine whether or not the invoice will be emailed to the customer when you send a send invoice request:

    * `email`: An invoice email is sent to the customer when you send the follow-on send invoice request for this invoice draft. The invoice status will change to `SENT`.
    * `none`: When you process a follow-on send invoice request to publish the drafted invoice, the invoice is not sent in an email to the customer. To share the invoice with the customer, send the customer the redirect URL in the invoiceInformation.paymentLink response field. The invoice status will change to `CREATED`.

invoiceInformation.dueDate
:

invoiceInformation.sendImmediately
:
Set to `false`.

[orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "")
:

[orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "")
:

[orderInformation.lineItems\[\].productName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-product-name.md "")
:

orderInformation.lineItems\[\].productSku
:

[orderInformation.lineItems\[\].quantity](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-quantity.md "")
:

[orderInformation.lineItems\[\].totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-total-amount.md "")
:

[orderInformation.lineItems\[\].unitPrice](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-unit-price.md "")
:

Optional Fields for Invoice Creation {#invoicing-services-create-opt-fields}
============================================================================

You can include these optional fields when sending create invoice requests:

[clientReferenceInformation.partner.developerId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-partner-developer-id.md "")
:
Set to your developer ID.

[clientReferenceInformation.partner.solutionId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-partner-solution-id.md "")
:
Set to your partner solution ID (PSID).

customerInformation.company.name
:

customerInformation.email
:

customerInformation.merchantCustomerId
:

customerInformation.name
:

invoiceInformation.allowPartialPayments
:
Set to one of these possible values:

    * `false`: The invoice must be paid in a single payment.
    * `true`: The invoice is payable in installments.

invoiceInformation.deliveryMode
:

invoiceInformation.description
:
This field becomes optional when either one of these conditions is met:

    * The line item fields are present in the request message.
    * When drafting a deliverable invoice, the invoiceInformation.deliveryMode request field is set to `email`.

invoiceInformation.invoiceNumber
:
Set to a unique number to create an invoice number.

    If you do not include this field and a unique value, the invoicing API automatically generates an invoice number for the new invoice.

    > IMPORTANT You cannot update this invoice number after sending the API request.

merchantDefinedFieldValues.definition.id\[\].value
:

orderInformation.amountDetails.freight.amount
:

orderInformation.amountDetails.freight.taxable
:

orderInformation.amountDetails.freight.taxRate
:

orderInformation.amountDetails.minimumPartialAmount
:

orderInformation.amountDetails.subAmount
:

Optional Fields for Discounts and Taxes {#invoicing-services-opt-details-tax-fields}
====================================================================================

You can include discounts and taxes to either the total billed amount or to billed line items in an invoice.

> IMPORTANT You cannot include discounts or taxes to both the total billed amount and line items in the same request.
> IMPORTANT
> The merchant is responsible for complying with any legal and tax requirements when issuing invoices to clients. ` Cybersource ` does not certify that the invoicing tool meets any such client requirements.

Discount Fields for the Invoice Total
-------------------------------------

[orderInformation.amountDetails.discountAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-discount-amount.md "")
:

orderInformation.amountDetails.discountPercent
:

Discount Fields for Line Items
------------------------------

[orderInformation.lineItems\[\].discountAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-discount-amount.md "")
:

[orderInformation.lineItems\[\].discountRate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-discount-rate.md "")
:

Tax Fields for the Invoice Total
--------------------------------

orderInformation.amountDetails.taxDetails.amount
:

orderInformation.amountDetails.taxDetails.rate
:

orderInformation.amountDetails.taxDetails.type
:

Tax Fields for Line Items
-------------------------

[orderInformation.lineItems\[\].taxAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-tax-amount-request.md "")
:

[orderInformation.lineItems\[\].taxRate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-tax-rate.md "")
:

Example: Drafting an Invoice {#invoicing-services-create-draft-done-ex-rest}
============================================================================

Request

```
{
  "invoiceInformation": {
    "description": "Food",
    "dueDate": "2019-07-11",
    "sendImmediately": false,
    "deliveryMode": "none"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "2623.64",
      "currency": "USD"
    }
  }
}
```

Response to a Successful Request

```keyword
{
  "_links": {
    "self": {
      "href": "/v2/invoices/98762",
      "method": "GET"
    },
    "update": {
      "href": "/v2/invoices/98762",
      "method": "PUT"
    },
    "deliver": {
      "href": "/v2/invoices/98762/delivery",
      "method": "POST"
    },
    "cancel": {
      "href": "/v2/invoices/98762/cancelation",
      "method": "POST"
    }
  },
  "id": "98762",
  "submitTimeUtc": "2024-08-02T19:24:06.184293960Z",
  "status": "CREATED",
  "processingInformation": {
    "requestPhone": false,
    "requestShipping": false
  },
  "invoiceInformation": {
    "invoiceNumber": "98762",
    "description": "Food",
    "dueDate": "2019-07-11",
    "allowPartialPayments": false,
    "paymentLink": "https://businesscenter.cybersource.com/ebc2/invoicing/payInvoice/NyvghJCpsrrZAjkvZNxelqUrI7iyOdLXFXWS8e5MLXyLYbifinsuYfBk6kaYo3co?version=v2.1",
    "deliveryMode": "None"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": 2623.64,
      "currency": "USD",
      "balanceAmount": 2623.64
    }
  }
}
```

Request

```
{
  "customerInformation": {
    "name": "Tanya Lee",
    "email": "tanya.lee@my-email.world"
  },
  "invoiceInformation": {
    "dueDate": "2019-07-11",
    "sendImmediately": false,
    "deliveryMode": "none"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "293.50",
      "currency": "USD"
    },
    "lineItems": [
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "quantity": "20",
        "unitPrice": "12.05",
        "totalAmount": "241.00"
      },
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "quantity": "10",
        "unitPrice": "5.25",
        "totalAmount": "52.50"
      }
    ]
  }
}
```

Response to a Successful Request

```
{
  "_links": {
    "self": {
      "href": "/v2/invoices/98764",
      "method": "GET"
    },
    "update": {
      "href": "/v2/invoices/98764",
      "method": "PUT"
    },
    "deliver": {
      "href": "/v2/invoices/98764/delivery",
      "method": "POST"
    },
    "cancel": {
      "href": "/v2/invoices/98764/cancelation",
      "method": "POST"
    }
  },
  "id": "98764",
  "submitTimeUtc": "2024-08-02T22:14:13.000671718Z",
  "status": "DRAFT",
  "customerInformation": {
    "name": "Tanya Lee",
    "email": "tanya.lee@my-email.world"
  },
  "processingInformation": {
    "requestPhone": false,
    "requestShipping": false
  },
  "invoiceInformation": {
    "invoiceNumber": "98764",
    "dueDate": "2019-07-11",
    "allowPartialPayments": false,
    "deliveryMode": "None"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": 293.5,
      "currency": "USD"
    },
    "lineItems": [
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "unitPrice": 12.05,
        "quantity": 20,
        "totalAmount": 241
      },
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "unitPrice": 5.25,
        "quantity": 10,
        "totalAmount": 52.5
      }
    ]
  }
}
```

REST Interactive Example: Create an Invoice Draft {#invoicing-services-create-draft-ex-live}
============================================================================================

Click this image to access the interactive code example for creating a invoice draft.

#### Figure: {#invoicing-services-create-draft-ex-live_cybs-create-invoice}

Interactive Code [![Image and link to the interactive code example for creating a new
invoice.](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-services-create.png/jcr:content/renditions/original)](https://developer.cybersource.com/api-reference-assets/index.md#invoicing_invoices_create-a-new-invoice "")

Create a Deliverable Draft Invoice {#invoicing-services-create-draft-dlvr-intro}
================================================================================

Drafting an invoice creates an unpublished invoice that is viewable only by you. To draft an invoice that will be delivered to the customer in an email message when you publish it, set the invoiceInformation.deliveryMode request field to `email`. When you are ready to publish and share the invoice with a customer, you can send the follow-on *send invoice* request. The customer will then receive an email with the invoice and the invoice's status will update from `DRAFT` to `SENT`.

Itemized Invoices
:
An invoice can display a single billed amount or list up to 30 billed items. To list the billed items in the invoice, include the items in the request using the line item array fields. An invoice with line items is known as an *itemized* invoice. For more information about how to include line items in your request, see [Including Line Items in an Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-line-items.md "").

Invoice Numbers
:
You can assign a unique invoice number in the invoiceInformation.invoiceNumber request field. The invoice number is required for follow-on API requests and tracking. You should store the invoice number in your system so that you can optimally perform the follow-on requests. If you do not include a unique invoice number when creating an invoice, `Cybersource` generates a unique invoice number for you in the invoiceInformation.invoiceNumber response field. IMPORTANT You cannot update the invoice number after it is generated.

Installment Payments
:
Invoices can be paid in installment payments when these fields and values are included in the request. If an invoice is payable in installments, multiple customers can make payments towards the same invoice.

    invoiceInformation.allowPartialPayments
    :
        Set to `true`.


    orderInformation.amountDetails.minimumPartialAmount
    :
        Set to the minimum amount allowed for a partial payment.

Partner Information
:
If your merchant account is associated with a `Cybersource` partner, you can include your partner solution ID (PSID) in the request message for tracking and reporting purposes. To include your PSID, use the clientReferenceInformation.partner.solutionId request field and set its field value to your PSID.

Alternative Methods to Create an Invoice
:
To create a *draft* invoice that is **not** sent in an email message to the customer when you publish it, see [Create a Draft Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-draft-intro.md "").

    To create a new invoice that is **not** immediately sent in an email message to the customer, see [Create an Invoice without Sending it](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-intro.md "").

    To create **and send** a new invoice at the same time, see [Create and Send an Invoice Immediately](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-send-intro.md "").

Endpoint
--------

Send an API POST request message to one of these endpoints:  
**Test:** `POST ``https://apitest.cybersource.com``/invoicing/v2/invoices`  
**Production:** `POST ``https://api.cybersource.com``/invoicing/v2/invoices`  
**India Production:** `POST https://api.in.cybersource.com/invoicing/v2/invoices`

Response to a Successful Request
--------------------------------

A successfully drafted invoice is indicated by the `DRAFT` status in the status response field.  
The redirect URL generated in the invoiceInformation.paymentLink response field is usable only by you and not the customer.  
Additional invoice details are included in the response message for you to review.

Follow-On API Requests
----------------------

After successfully drafting an invoice, you can send these follow-on API requests.

Send an Invoice
:
After drafting an invoice, you can publish and send an invoice using the send invoice request. For more information, see [Send an Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-send-intro.md "").

Update an Invoice
:
To update customer information or item details in an already drafted invoice, send an update invoice request. For more information, see [Update an Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-update-intro.md "").

Cancel an Invoice
:
To cancel a drafted invoice, send the a cancel invoice request. For more information, see [Cancel an Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-cancel-intro.md "").

Get Invoice Details
:
To retrieve a drafted invoice's details, send a get invoice details request. For more information, see [Get Invoice Details](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-get-details-intro.md "").

Line Items {#invoicing-services-line-items-dlvr}
================================================

You can itemize invoices by using the line item fields when you create, draft, and update an invoice.  
*Line items* are used to include information about your customers' purchases. Information can include product name, quantity, and price.  
Line items are included in a request in the lineItem\[\] array request field.  
These fields are required for each line item in your request:

[orderInformation.lineItems\[\].productName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-product-name.md "")
:

orderInformation.lineItems\[\].productSku
:

[orderInformation.lineItems\[\].quantity](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-quantity.md "")
:

[orderInformation.lineItems\[\].totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-total-amount.md "")
:

[orderInformation.lineItems\[\].unitPrice](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-unit-price.md "")
:

These fields are optional for each line item in your request:

[orderInformation.lineItems\[\].discountAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-discount-amount.md "")
:

orderInformation.lineItems\[\].discountRate
:

[orderInformation.lineItems\[\].taxAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-tax-amount-request.md "")
:

[orderInformation.lineItems\[\].taxRate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-tax-rate.md "")
:

Example: Including Line Items  
This example shows three valid line items.

```
{ 
  "orderInformation": {
    "lineItems": [
      {
        "productSku": "ABCD1234",
        "productName": "First line item's name",
        "quantity": "20",
        "unitPrice": "12.05",
        "discountAmount": "13.04",
        "taxAmount": "0.0",
        "taxRate": "0.0",
        "totalAmount": "247.86"
      },
      {
        "productSku": "EFGH5678",
        "productName": "Second line item's name",
        "quantity": "20",
        "unitPrice": "12.05",
        "discountAmount": "13.04",
        "taxAmount": "0.0",
        "taxRate": "0.0",
        "totalAmount": "247.86"
      },
      {
        "productSku": "IJKL9999",
        "productName": "Third line item's name",
        "quantity": "20",
        "unitPrice": "12.05",
        "discountAmount": "13.04",
        "taxAmount": "0.0",
        "taxRate": "0.0",
        "totalAmount": "247.86"
      }
    ]
  }
}
```

Required Fields for Drafting an Invoice {#invoicing-services-create-draft-dlvr-req-fields}
==========================================================================================

This section lists the required fields necessary to create these types of invoices:
* In-person draft invoice
* Email draft invoice
* Itemized email draft invoice

The invoice created using these fields and specified values is not immediately sent to the customer.

Required Fields for Drafting an In-Person Invoice
-------------------------------------------------

invoiceInformation.deliveryMode
:
Set to one of these possible values to determine whether or not the invoice is emailed to the customer when you send a send invoice request:

    * `email`: An invoice email is sent to the customer when you send the follow-on send invoice request for this invoice draft. The invoice status updates to `SENT`.
    * `none`: When you process a follow-on send invoice request to publish the drafted invoice, the invoice is not sent in an email to the customer. To share the invoice with the customer, send the customer the redirect URL in the invoiceInformation.paymentLink response field. The invoice updates change to `CREATED`.

invoiceInformation.description
:

invoiceInformation.dueDate
:

invoiceInformation.sendImmediately
:
Set to `false`.

[orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "")
:

[orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "")
:

Required Fields for Drafting an Email Invoice {#invoicing-services-create-draft-dlvr-req-fields_customer-fields}
----------------------------------------------------------------------------------------------------------------

customerInformation.email
:

customerInformation.name
:

invoiceInformation.deliveryMode
:
Set to `email`.

invoiceInformation.dueDate
:

invoiceInformation.sendImmediately
:
Set to `false`.

[orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "")
:

[orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "")
:

Required Fields for Drafting an Invoice with Line Items {#invoicing-services-create-draft-dlvr-req-fields_line-item-fields}
---------------------------------------------------------------------------------------------------------------------------

customerInformation.email
:

customerInformation.name
:

invoiceInformation.deliveryMode
:
Set to one of these possible values to determine whether or not the invoice will be emailed to the customer when you send a send invoice request:

    * `email`: An invoice email is sent to the customer when you send the follow-on send invoice request for this invoice draft. The invoice status will change to `SENT`.
    * `none`: When you process a follow-on send invoice request to publish the drafted invoice, the invoice is not sent in an email to the customer. To share the invoice with the customer, send the customer the redirect URL in the invoiceInformation.paymentLink response field. The invoice status will change to `CREATED`.

invoiceInformation.dueDate
:

invoiceInformation.sendImmediately
:
Set to `false`.

[orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "")
:

[orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "")
:

[orderInformation.lineItems\[\].productName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-product-name.md "")
:

orderInformation.lineItems\[\].productSku
:

[orderInformation.lineItems\[\].quantity](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-quantity.md "")
:

[orderInformation.lineItems\[\].totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-total-amount.md "")
:

[orderInformation.lineItems\[\].unitPrice](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-unit-price.md "")
:

Optional Fields for Invoice Creation {#invoicing-services-create-dlvr-opt-fields}
=================================================================================

You can include these optional fields when sending create invoice requests:

[clientReferenceInformation.partner.developerId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-partner-developer-id.md "")
:
Set to your developer ID.

[clientReferenceInformation.partner.solutionId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-partner-solution-id.md "")
:
Set to your partner solution ID (PSID).

customerInformation.company.name
:

customerInformation.email
:

customerInformation.merchantCustomerId
:

customerInformation.name
:

invoiceInformation.allowPartialPayments
:
Set to one of these possible values:

    * `false`: The invoice must be paid in a single payment.
    * `true`: The invoice is payable in installments.

invoiceInformation.deliveryMode
:

invoiceInformation.description
:
This field becomes optional when either one of these conditions is met:

    * The line item fields are present in the request message.
    * When drafting a deliverable invoice, the invoiceInformation.deliveryMode request field is set to `email`.

invoiceInformation.invoiceNumber
:
Set to a unique number to create an invoice number.

    If you do not include this field and a unique value, the invoicing API automatically generates an invoice number for the new invoice.

    > IMPORTANT You cannot update this invoice number after sending the API request.

merchantDefinedFieldValues.definition.id\[\].value
:

orderInformation.amountDetails.freight.amount
:

orderInformation.amountDetails.freight.taxable
:

orderInformation.amountDetails.freight.taxRate
:

orderInformation.amountDetails.minimumPartialAmount
:

orderInformation.amountDetails.subAmount
:

Optional Fields for Discounts and Taxes {#invoicing-services-opt-details-dlvr-tax-fields}
=========================================================================================

You can include discounts and taxes to either the total billed amount or to billed line items in an invoice.

> IMPORTANT You cannot include discounts or taxes to both the total billed amount and line items in the same request.
> IMPORTANT
> The merchant is responsible for complying with any legal and tax requirements when issuing invoices to clients. ` Cybersource ` does not certify that the invoicing tool meets any such client requirements.

Discount Fields for the Invoice Total
-------------------------------------

[orderInformation.amountDetails.discountAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-discount-amount.md "")
:

orderInformation.amountDetails.discountPercent
:

Discount Fields for Line Items
------------------------------

[orderInformation.lineItems\[\].discountAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-discount-amount.md "")
:

[orderInformation.lineItems\[\].discountRate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-discount-rate.md "")
:

Tax Fields for the Invoice Total
--------------------------------

orderInformation.amountDetails.taxDetails.amount
:

orderInformation.amountDetails.taxDetails.rate
:

orderInformation.amountDetails.taxDetails.type
:

Tax Fields for Line Items
-------------------------

[orderInformation.lineItems\[\].taxAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-tax-amount-request.md "")
:

[orderInformation.lineItems\[\].taxRate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-tax-rate.md "")
:

Example: Drafting a Deliverable Invoice {#invoicing-services-create-draft-ex-rest}
==================================================================================

Request

```
{
  "customerInformation": {
    "name": "Tanya Lee",
    "email": "tanya.lee@my-email.world"
  },
  "invoiceInformation": {
    "dueDate": "2019-07-11",
    "sendImmediately": false,
    "deliveryMode": "email"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "247.86",
      "currency": "USD"
    },
    "lineItems": [
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "quantity": "20",
        "unitPrice": "12.05",
        "totalAmount": "247.86"
      }
    ]
  }
}
```

Response to a Successful Request

```
{
  "_links": {
    "self": {
      "href": "/v2/invoices/2669",
      "method": "GET"
    },
    "update": {
      "href": "/v2/invoices/2669",
      "method": "PUT"
    },
    "deliver": {
      "href": "/v2/invoices/2669/delivery",
      "method": "POST"
    },
    "cancel": {
      "href": "/v2/invoices/2669/cancelation",
      "method": "POST"
    }
  },
  "id": "2669",
  "submitTimeUtc": "2024-07-24T18:24:36.153361386Z",
  "status": "DRAFT",
  "customerInformation": {
    "name": "Tanya Lee",
    "email": "tanya.lee@my-email.world"
  },
  "processingInformation": {
    "requestPhone": false,
    "requestShipping": false
  },
  "invoiceInformation": {
    "invoiceNumber": "2669",
    "dueDate": "2019-07-11",
    "allowPartialPayments": false,
    "deliveryMode": "Email"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": 247.86,
      "currency": "USD",
      "balanceAmount": 247.86
    },
    "lineItems": [
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "unitPrice": 12.05,
        "quantity": 20,
        "totalAmount": 247.86
      }
    ]
  }
}
```

Request

```
{
  "customerInformation": {
    "name": "Tanya Lee",
    "email": "tanya.lee@my-email.world"
  },
  "invoiceInformation": {
    "dueDate": "2019-07-11",
    "sendImmediately": false,
    "deliveryMode": "email"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": 293.5,
      "currency": "USD"
    },
    "lineItems": [
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "unitPrice": 12.05,
        "quantity": 20,
        "totalAmount": 241
      },
      {
        "productSku": "P653727383",
        "productName": "Second line item's name",
        "unitPrice": 5.25,
        "quantity": 10,
        "totalAmount": 52.5
      }
    ]
  }
}
```

Response to a Successful Request

```
{
  "_links": {
    "self": {
      "href": "/v2/invoices/98765",
      "method": "GET"
    },
    "update": {
      "href": "/v2/invoices/98765",
      "method": "PUT"
    },
    "deliver": {
      "href": "/v2/invoices/98765/delivery",
      "method": "POST"
    },
    "cancel": {
      "href": "/v2/invoices/98765/cancelation",
      "method": "POST"
    }
  },
  "id": "98765",
  "submitTimeUtc": "2024-08-02T22:18:24.341304588Z",
  "status": "DRAFT",
  "customerInformation": {
    "name": "Tanya Lee",
    "email": "tanya.lee@my-email.world"
  },
  "processingInformation": {
    "requestPhone": false,
    "requestShipping": false
  },
  "invoiceInformation": {
    "invoiceNumber": "98765",
    "dueDate": "2019-07-11",
    "allowPartialPayments": false,
    "deliveryMode": "Email"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": 293.5,
      "currency": "USD",
      "balanceAmount": 293.5
    },
    "lineItems": [
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "unitPrice": 12.05,
        "quantity": 20,
        "totalAmount": 241
      },
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "unitPrice": 5.25,
        "quantity": 10,
        "totalAmount": 52.5
      }
    ]
  }
}
```

REST Interactive Example: Create an Invoice Draft {#invoicing-services-create-draft-dlvr-ex-live}
=================================================================================================

Click this image to access the interactive code example for creating a invoice draft.

#### Figure: {#invoicing-services-create-draft-dlvr-ex-live_d10e20}

Interactive Code [![Image and link to the interactive code example for creating a new
invoice.](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-services-create.png/jcr:content/renditions/original)](https://developer.cybersource.com/api-reference-assets/index.md#invoicing_invoices_create-a-new-invoice "")

Create and Send an Invoice Immediately {#invoicing-services-create-send-intro}
==============================================================================

Creating and sending an invoice publishes a payable invoice that is automatically emailed to the customer. In addition to the sent email, you can also share the invoice by sending the customer the redirect URL generated in the invoiceInformation.paymentLink response field.

Itemized Invoices
:
An invoice can display a single billed amount or list up to 30 billed items. To list the billed items in the invoice, include the items in the request using the line item array fields. An invoice with line items is known as an *itemized* invoice. For more information about how to include line items in your request, see [Including Line Items in an Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-line-items.md "").

Invoice Numbers
:
You can assign a unique invoice number in the invoiceInformation.invoiceNumber request field. The invoice number is required for follow-on API requests and tracking. You should store the invoice number in your system so that you can optimally perform the follow-on requests. If you do not include a unique invoice number when creating an invoice, `Cybersource` generates a unique invoice number for you in the invoiceInformation.invoiceNumber response field. IMPORTANT You cannot update the invoice number after it is generated.

Installment Payments
:
Invoices can be paid in installment payments when these fields and values are included in the request. If an invoice is payable in installments, multiple customers can make payments towards the same invoice.

    invoiceInformation.allowPartialPayments
    :
        Set to `true`.


    orderInformation.amountDetails.minimumPartialAmount
    :
        Set to the minimum amount allowed for a partial payment.

Partner Information
:
If your merchant account is associated with a `Cybersource` partner, you can include your partner solution ID (PSID) in the request message for tracking and reporting purposes. To include your PSID, use the clientReferenceInformation.partner.solutionId request field and set its field value to your PSID.

Alternative Methods to Create an Invoice
:
To create a new invoice that is **not** immediately sent in an email to the customer, see [Create an Invoice without Sending it](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-intro.md "").

    To create an invoice **draft** that is not payable or viewable to the customer, see [Create a Draft Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-draft-intro.md "").

Endpoint
--------

Send an API POST request message to one of these endpoints:  
**Test:** `POST ``https://apitest.cybersource.com``/invoicing/v2/invoices`  
**Production:** `POST ``https://api.cybersource.com``/invoicing/v2/invoices`  
**India Production:** `POST https://api.in.cybersource.com/invoicing/v2/invoices`

Successful Response
-------------------

A successfully created and sent invoice is indicated by the `SENT` status in the status response field. The response message also includes the newly created invoice's details.

Required Fields for Creating and Sending an Invoice {#invoicing-services-create-send-req-fields}
================================================================================================

This section lists the required fields necessary to create and send these types of invoices:
* Email invoice
* Itemized email invoice

Required Fields for an Email Invoice {#invoicing-services-create-send-req-fields_customer-fields}
-------------------------------------------------------------------------------------------------

customerInformation.email
:

customerInformation.name
:

invoiceInformation.deliveryMode
:
Set to `email`.

invoiceInformation.description
:

invoiceInformation.dueDate
:

invoiceInformation.sendImmediately
:
Set to `true`.

[orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "")
:

[orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "")
:

Required Fields for an Email Invoice with Line Items {#invoicing-services-create-send-req-fields_line-item-fields}
------------------------------------------------------------------------------------------------------------------

customerInformation.email
:

customerInformation.name
:

invoiceInformation.deliveryMode
:
Set to `email`.

invoiceInformation.dueDate
:

invoiceInformation.sendImmediately
:
Set to `true`.

[orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "")
:

[orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "")
:

[orderInformation.lineItems\[\].productName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-product-name.md "")
:

orderInformation.lineItems\[\].productSku
:

[orderInformation.lineItems\[\].quantity](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-quantity.md "")
:

[orderInformation.lineItems\[\].totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-total-amount.md "")
:

[orderInformation.lineItems\[\].unitPrice](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-unit-price.md "")
:

Optional Fields for Invoice Creation {#invoicing-services-create-send-opt-fields}
=================================================================================

You can include these optional fields when sending create invoice requests:

[clientReferenceInformation.partner.developerId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-partner-developer-id.md "")
:
Set to your developer ID.

[clientReferenceInformation.partner.solutionId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-partner-solution-id.md "")
:
Set to your partner solution ID (PSID).

customerInformation.company.name
:

customerInformation.email
:

customerInformation.merchantCustomerId
:

customerInformation.name
:

invoiceInformation.allowPartialPayments
:
Set to one of these possible values:

    * `false`: The invoice must be paid in a single payment.
    * `true`: The invoice is payable in installments.

invoiceInformation.deliveryMode
:

invoiceInformation.description
:
This field is optional when the line item fields are present in the request message.

invoiceInformation.invoiceNumber
:
Set to a unique number to create an invoice number.

    If you do not include this field and a unique value, the invoicing API automatically generates an invoice number for the new invoice.

    > IMPORTANT You cannot update this invoice number after sending the API request.

merchantDefinedFieldValues.definition id\[\].value
:

orderInformation.amountDetails.freight.amount
:

orderInformation.amountDetails.freight.taxable
:

orderInformation.amountDetails.freight.taxRate
:

orderInformation.amountDetails.minimumPartialAmount
:

orderInformation.amountDetails.subAmount
:

Example: Creating and Sending an Invoice {#invoicing-services-create-send-ex-rest}
==================================================================================

Request

```
{
  "customerInformation": {
    "email": "test@email.com"
  },
  "invoiceInformation": {
    "description": "This is a test invoice",
    "dueDate": "2019-07-11",
    "sendImmediately": true,
    "deliveryMode": "email"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "2623.64",
      "currency": "USD"
    }
  }
}
```

Response to a Successful Request

```keyword
{
  "_links": {
    "self": {
      "href": "/v2/invoices/98768",
      "method": "GET"
    },
    "update": {
      "href": "/v2/invoices/98768",
      "method": "PUT"
    },
    "deliver": {
      "href": "/v2/invoices/98768/delivery",
      "method": "POST"
    },
    "cancel": {
      "href": "/v2/invoices/98768/cancelation",
      "method": "POST"
    }
  },
  "id": "98768",
  "submitTimeUtc": "2024-08-03T00:40:31.143121084Z",
  "status": "SENT",
  "customerInformation": {
    "email": "test@cybs.com"
  },
  "processingInformation": {
    "requestPhone": false,
    "requestShipping": false
  },
  "invoiceInformation": {
    "invoiceNumber": "98768",
    "description": "This is a test invoice",
    "dueDate": "2019-07-11",
    "allowPartialPayments": false,
    "paymentLink": "https://businesscenter.cybersource.com/ebc2/invoicing/payInvoice/2AgCNHLrUtD7hfFR5SVh5DSxISAbFD9zybhUjpxpZuXKLQVyuLttP78uWWLRSSNX?version=v2.1",
    "deliveryMode": "Email"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": 2623.64,
      "currency": "USD",
      "balanceAmount": 2623.64
    }
  }
}
```

Request

```
{
  "customerInformation": {
    "name": "Tanya Lee",
    "email": "tanya.lee@my-email.world"
  },
  "invoiceInformation": {
    "dueDate": "2019-07-11",
    "sendImmediately": true,
    "deliveryMode": "email"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": 293.5,
      "currency": "USD"
    },
    "lineItems": [
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "unitPrice": 12.05,
        "quantity": 20,
        "totalAmount": 241
      },
      {
        "productSku": "P653727383",
        "productName": "Second line item's name",
        "unitPrice": 5.25,
        "quantity": 10,
        "totalAmount": 52.5
      }
    ]
  }
}
```

Response to a Successful Request

```keyword
{
  "_links": {
    "self": {
      "href": "/v2/invoices/98769",
      "method": "GET"
    },
    "update": {
      "href": "/v2/invoices/98769",
      "method": "PUT"
    },
    "deliver": {
      "href": "/v2/invoices/98769/delivery",
      "method": "POST"
    },
    "cancel": {
      "href": "/v2/invoices/98769/cancelation",
      "method": "POST"
    }
  },
  "id": "98769",
  "submitTimeUtc": "2024-08-03T00:43:05.320320438Z",
  "status": "SENT",
  "customerInformation": {
    "name": "Tanya Lee",
    "email": "test@cybs.com"
  },
  "processingInformation": {
    "requestPhone": false,
    "requestShipping": false
  },
  "invoiceInformation": {
    "invoiceNumber": "98769",
    "dueDate": "2019-07-11",
    "allowPartialPayments": false,
    "paymentLink": "https://businesscenter.cybersource.com/ebc2/invoicing/payInvoice/XvgrhdaVUbBJb466S9nxqXpp1e2UHoFEUlhye9gtiwgi7gzv5fwqV8YgfP6xep0D?version=v2.1",
    "deliveryMode": "Email"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": 293.5,
      "currency": "USD",
      "balanceAmount": 293.5
    },
    "lineItems": [
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "unitPrice": 12.05,
        "quantity": 20,
        "totalAmount": 241
      },
      {
        "productSku": "P653727383",
        "productName": "Second line item's name",
        "unitPrice": 5.25,
        "quantity": 10,
        "totalAmount": 52.5
      }
    ]
  }
}
```

REST Interactive Example: Create and Send an Invoice {#invoicing-services-create-send-ex-live}
==============================================================================================

Click this image to access the interactive code example for creating and sending a new invoice.

#### Figure:

Interactive Code [![Image and link to the interactive code example for creating a new
invoice.](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-services-create.png/jcr:content/renditions/original)](https://developer.cybersource.com/api-reference-assets/index.md#invoicing_invoices_create-a-new-invoice "")

Create an Invoice without Sending it {#invoicing-services-create-intro}
=======================================================================

Creating a new invoice publishes a payable invoice. To share the created invoice with a customer, send the customer the redirect URL generated in the invoiceInformation.paymentLink response field.

Itemized Invoices
:
An invoice can display a single billed amount or list up to 30 billed items. To list the billed items in the invoice, include the items in the request using the line item array fields. An invoice with line items is known as an *itemized* invoice. For more information about how to include line items in your request, see [Including Line Items in an Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-line-items.md "").

Invoice Numbers
:
You can assign a unique invoice number in the invoiceInformation.invoiceNumber request field. The invoice number is required for follow-on API requests and tracking. You should store the invoice number in your system so that you can optimally perform the follow-on requests. If you do not include a unique invoice number when creating an invoice, `Cybersource` generates a unique invoice number for you in the invoiceInformation.invoiceNumber response field. IMPORTANT You cannot update the invoice number after it is generated.

Installment Payments
:
Invoices can be paid in installment payments when these fields and values are included in the request. If an invoice is payable in installments, multiple customers can make payments towards the same invoice.

    invoiceInformation.allowPartialPayments
    :
        Set to `true`.


    orderInformation.amountDetails.minimumPartialAmount
    :
        Set to the minimum amount allowed for a partial payment.

Partner Information
:
If your merchant account is associated with a `Cybersource` partner, you can include your partner solution ID (PSID) in the request message for tracking and reporting purposes. To include your PSID, use the clientReferenceInformation.partner.solutionId request field and set its field value to your PSID.

Alternative Methods to Create an Invoice
:
To create **and send** a new invoice at the same time, see [Create and Send an Invoice Immediately](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-send-intro.md "").

    To create an invoice **draft** that is not payable or viewable to the customer, see [Create a Draft Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-draft-intro.md "").

Endpoint {#invoicing-services-create-intro_endpoint-create-invoice}
-------------------------------------------------------------------

Send an API POST request message to one of these endpoints:  
**Test:** `POST ``https://apitest.cybersource.com``/invoicing/v2/invoices`  
**Production:** `POST ``https://api.cybersource.com``/invoicing/v2/invoices`  
**India Production:** `POST https://api.in.cybersource.com/invoicing/v2/invoices`

Successful Response
-------------------

A successfully created invoice is indicated by the `CREATED` status in the status response field. The response message also includes the newly created invoice's details for the new invoice.

Follow-On API Requests
----------------------

After creating an invoice, you can send these follow-on API requests.

Send an Invoice
:
After creating an invoice, you can email the invoice to the customer using a send invoice request. For more information, see [Send an Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-send-intro.md "").

Update an Invoice
:
To update customer information or item details in an invoice, send an update invoice request. For more information, see [Update an Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-update-intro.md "").

Cancel an Invoice
:
To cancel an invoice, send a cancel invoice request. For more information, see [Cancel an Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-cancel-intro.md "").

Get Invoice Details
:
You can retrieve an invoice's details by sending a get invoice details request. For more information, see [Get Invoice Details](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-get-details-intro.md "").

Get List of Invoices
:
After creating multiple invoices, you might want to search for certain invoices. To retrieve a filtered list of invoices, send a get list of invoices request. For more information, see [Get a List of Invoices](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-get-list-intro.md "").

Required Fields for Creating an Invoice {#invoicing-services-create-req-fields}
===============================================================================

This section lists the required fields necessary to create these types of invoices:
* In-person invoice
* Email invoice
* Itemized email invoice

The invoice created using these fields and specified values is not immediately sent to the customer.

Required Fields for Creating an In-Person Invoice
-------------------------------------------------

invoiceInformation.deliveryMode
:
Set to `none`.

invoiceInformation.description
:

invoiceInformation.dueDate
:

invoiceInformation.sendImmediately
:
Set to `true`.

[orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "")
:

[orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "")
:

Required Fields for Creating an Email Invoice {#invoicing-services-create-req-fields_customer-fields}
-----------------------------------------------------------------------------------------------------

customerInformation.email
:

customerInformation.name
:

invoiceInformation.deliveryMode
:
Set to `none`.

invoiceInformation.dueDate
:

invoiceInformation.sendImmediately
:
Set to `true`.

[orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "")
:

[orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "")
:

Required Fields for Creating an Itemized Email Invoice {#invoicing-services-create-req-fields_line-item-fields}
---------------------------------------------------------------------------------------------------------------

customerInformation.email
:

customerInformation.name
:

invoiceInformation.deliveryMode
:
Set to `none`.

invoiceInformation.dueDate
:

invoiceInformation.sendImmediately
:
Set to `true`.

[orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "")
:

[orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "")
:

[orderInformation.lineItems\[\].productName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-product-name.md "")
:
Include for each item listed in the invoice.

orderInformation.lineItems\[\].productSku
:
Include for each item listed in the invoice.

[orderInformation.lineItems\[\].quantity](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-quantity.md "")
:
Include for each item listed in the invoice.

[orderInformation.lineItems\[\].totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-total-amount.md "")
:
Include for each item listed in the invoice.

[orderInformation.lineItems\[\].unitPrice](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-unit-price.md "")
:
Include for each item listed in the invoice.

Example: Creating an Invoice {#invoicing-services-create-ex-rest}
=================================================================

Request

```
{
  "invoiceInformation": {
    "description": "Food",
    "dueDate": "2019-07-11",
    "sendImmediately": true,
    "deliveryMode": "none"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "2623.64",
      "currency": "USD"
    }
  }
}
```

Response to a Successful Request

```keyword
{
  "_links": {
    "self": {
      "href": "/v2/invoices/98761",
      "method": "GET"
    },
    "update": {
      "href": "/v2/invoices/98761",
      "method": "PUT"
    },
    "deliver": {
      "href": "/v2/invoices/98761/delivery",
      "method": "POST"
    },
    "cancel": {
      "href": "/v2/invoices/98761/cancelation",
      "method": "POST"
    }
  },
  "id": "98761",
  "submitTimeUtc": "2024-08-02T18:39:57.548314337Z",
  "status": "CREATED",
  "processingInformation": {
    "requestPhone": false,
    "requestShipping": false
  },
  "invoiceInformation": {
    "invoiceNumber": "98761",
    "description": "Food",
    "dueDate": "2019-07-11",
    "allowPartialPayments": false,
    "paymentLink": "https://businesscenter.cybersource.com/ebc2/invoicing/payInvoice/wzvrzUssiXFLJ2RcJcmbuQEoHSrlcQudy9dL91Jxo8n4VcoRhNWRp8wvVDz8xtlD?version=v2.1",
    "deliveryMode": "None"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": 2623.64,
      "currency": "USD",
      "balanceAmount": 2623.64
    }
  }
}
```

Request

```
{
  "customerInformation": {
    "name": "Tanya Lee",
    "email": "tanya.lee@my-email.world"
  },
  "invoiceInformation": {
    "dueDate": "2019-07-11",
    "sendImmediately": true,
    "deliveryMode": "none"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": 293.5,
      "currency": "USD"
    },
    "lineItems": [
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "unitPrice": 12.05,
        "quantity": 20,
        "totalAmount": 241
      },
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "unitPrice": 5.25,
        "quantity": 10,
        "totalAmount": 52.5
      }
    ]
  }
}
```

Response to a Successful Request

```
{
  "_links": {
    "self": {
      "href": "/v2/invoices/98766",
      "method": "GET"
    },
    "update": {
      "href": "/v2/invoices/98766",
      "method": "PUT"
    },
    "deliver": {
      "href": "/v2/invoices/98766/delivery",
      "method": "POST"
    },
    "cancel": {
      "href": "/v2/invoices/98766/cancelation",
      "method": "POST"
    }
  },
  "id": "98766",
  "submitTimeUtc": "2024-08-03T00:02:49.453695409Z",
  "status": "CREATED",
  "customerInformation": {
    "name": "Tanya Lee",
    "email": "tanya.lee@my-email.world"
  },
  "processingInformation": {
    "requestPhone": false,
    "requestShipping": false
  },
  "invoiceInformation": {
    "invoiceNumber": "98766",
    "dueDate": "2019-07-11",
    "allowPartialPayments": false,
    "paymentLink": "/ebc2/invoicing/payInvoice/JBOA7CQeoSFuUluwLqw2c6n8rf0KCO0cgJz19uQmxO9rF5tT8FdNGRTL9OHapjlr?version=v2.1",
    "deliveryMode": "None"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": 293.5,
      "currency": "USD",
      "balanceAmount": 293.5
    },
    "lineItems": [
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "unitPrice": 12.05,
        "quantity": 20,
        "totalAmount": 241
      },
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "unitPrice": 5.25,
        "quantity": 10,
        "totalAmount": 52.5
      }
    ]
  }
}
```

REST Interactive Example: Create a New Invoice {#invoicing-services-create-ex-live}
===================================================================================

Click this image to access the interactive code example for creating a new invoice.

#### Figure:

Interactive Code [![Image and link to the interactive code example for creating a new
invoice.](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-services-create.png/jcr:content/renditions/original)](https://developer.cybersource.com/api-reference-assets/index.md#invoicing_invoices_create-a-new-invoice "")

Get a List of Invoices {#invoicing-services-get-list-intro}
===========================================================

You can retrieve a list of your invoices by sending a get invoice list request. To filter the list results, you can add an optional string of query parameters to the endpoint. Filtering list results can help you retrieve specific invoices faster.  
You can filter invoices by:

* Number of invoices retrieved
* Order of invoices
* Status

Endpoints
---------

Send your API request to one of these endpoints:  
**Test:** `GET ``https://apitest.cybersource.com``/invoicing/v2/invoices`  
**Production:** `GET ``https://api.cybersource.com``/invoicing/v2/invoices`  
**India Production:** `GET https://api.in.cybersource.com/invoicing/v2/invoices`

Generate an Endpoint with Query Parameters {#invoicing-services-get-list-req-fields}
====================================================================================

You can filter your search results by appending an optional string of query parameters to the endpoint. A query parameter is also known as a *query-string*.  
Begin each string with a question mark (`?`) to designate the start of the query parameters, and include an ampersand (`&`) at the beginning of each consecutive query parameter.  
Use this format for appending a string of query parameters as name-value pairs:  
`?name1=value&name2=value&nameN=value`  
These are the query parameters to filter the retrieved list results:

| Query Parameter |                                                                                                                                                                                                                                                     Description                                                                                                                                                                                                                                                      |
|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| offset          | The page offset number. This determines the order in which the invoices are retrieved, beginning with the consecutive number from the string value. For example, an offset of `3` results in a filtered list that begins with the fourth listed invoice. Set to a whole number.                                                                                                                                                                                                                                      |
| limit           | The maximum number of items being retrieved. Set to a whole number.                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| status          | The status of the invoice. Set to one of these possible values: * `CANCELED` * `CREATED` * `DRAFT` * `PAID` * `PARTIAL` * `PENDING`: The customer has initiated a payment for an invoice that is in the `CREATED`, `SENT`, or `PARTIAL` status. The invoice can no longer be edited, and the customer can no longer initiate an payment in order to avoid a double payment. If the invoice payment requires a fraud review, the invoice will remain in the `PENDING` status until you approve or reject it. * `SENT` |
[Query Parameters]

In this example, up to 100 draft invoices are retrieved beginning with the fourth listed invoice:

```keyword
GET https://apitest.cybersource.com/invoicing/v2/invoices?offset=3&limit=100&status=DRAFT
```

Example: Get a List of Invoices {#invoicing-services-get-list-ex-rest}
======================================================================

Endpoint with Optional Query Parameters

```keyword
GET https://apitest.cybersource.com/invoicing/v2/invoices?offset=0&limit=5&status=DRAFT
```

Request

```
{}
```

Response to a Successful Request

```
{
  "_links": {
    "self": {
      "href": "/v2/invoices/?offset=0&limit=5",
      "method": "GET"
    },
    "next": {
      "href": "/v2/invoices/?offset=5&limit=5",
      "method": "GET"
    }
  },
  "submitTimeUtc": "2024-07-24T18:44:11.469054445Z",
  "totalInvoices": 38449,
  "invoices": [
    {
      "_links": {
        "self": {
          "href": "/v2/invoices/2670",
          "method": "GET"
        },
        "update": {
          "href": "/v2/invoices/2670",
          "method": "PUT"
        },
        "deliver": {
          "href": "/v2/invoices/2670/delivery",
          "method": "POST"
        },
        "cancel": {
          "href": "/v2/invoices/2670/cancelation",
          "method": "POST"
        }
      },
      "id": "2670",
      "status": "SENT",
      "customerInformation": {
        "name": "Tanya Lee"
      },
      "invoiceInformation": {
        "dueDate": "2019-07-11",
        "paymentLink": "https://developer.cybersource.com/ebc2/invoicing/payInvoice/W447tdnINi5t5wu6QA0KUE2HYWY2rQQ0zXL5b5z6M50w4Ea9FFlcYrEmp09pFlzl?version=v2.1"
      },
      "orderInformation": {
        "amountDetails": {
          "totalAmount": 247.86,
          "currency": "USD"
        }
      }
    },
    {
      "_links": {
        "self": {
          "href": "/v2/invoices/2669",
          "method": "GET"
        },
        "update": {
          "href": "/v2/invoices/2669",
          "method": "PUT"
        },
        "deliver": {
          "href": "/v2/invoices/2669/delivery",
          "method": "POST"
        },
        "cancel": {
          "href": "/v2/invoices/2669/cancelation",
          "method": "POST"
        }
      },
      "id": "2669",
      "status": "DRAFT",
      "customerInformation": {
        "name": "Tanya Lee"
      },
      "invoiceInformation": {
        "dueDate": "2019-07-11"
      },
      "orderInformation": {
        "amountDetails": {
          "totalAmount": 247.86,
          "currency": "USD"
        }
      }
    },
    {
      "_links": {
        "self": {
          "href": "/v2/invoices/2668",
          "method": "GET"
        },
        "update": {
          "href": "/v2/invoices/2668",
          "method": "PUT"
        },
        "deliver": {
          "href": "/v2/invoices/2668/delivery",
          "method": "POST"
        },
        "cancel": {
          "href": "/v2/invoices/2668/cancelation",
          "method": "POST"
        }
      },
      "id": "2668",
      "status": "DRAFT",
      "customerInformation": {
        "name": "Tanya Lee"
      },
      "invoiceInformation": {
        "dueDate": "2019-07-11"
      },
      "orderInformation": {
        "amountDetails": {
          "totalAmount": 2623.64,
          "currency": "USD"
        }
      }
    },
    {
      "_links": {
        "self": {
          "href": "/v2/invoices/2667",
          "method": "GET"
        },
        "update": {
          "href": "/v2/invoices/2667",
          "method": "PUT"
        },
        "deliver": {
          "href": "/v2/invoices/2667/delivery",
          "method": "POST"
        },
        "cancel": {
          "href": "/v2/invoices/2667/cancelation",
          "method": "POST"
        }
      },
      "id": "2667",
      "status": "DRAFT",
      "customerInformation": {
        "name": "Tanya Lee"
      },
      "invoiceInformation": {
        "dueDate": "2019-07-11"
      },
      "orderInformation": {
        "amountDetails": {
          "totalAmount": 2623.64,
          "currency": "USD"
        }
      }
    },
    {
      "_links": {
        "self": {
          "href": "/v2/invoices/2666",
          "method": "GET"
        },
        "update": {
          "href": "/v2/invoices/2666",
          "method": "PUT"
        },
        "deliver": {
          "href": "/v2/invoices/2666/delivery",
          "method": "POST"
        },
        "cancel": {
          "href": "/v2/invoices/2666/cancelation",
          "method": "POST"
        }
      },
      "id": "2666",
      "status": "CREATED",
      "customerInformation": {
        "name": "Tanya Lee"
      },
      "invoiceInformation": {
        "dueDate": "2019-07-11",
        "paymentLink": "https://developer.cybersource.com/ebc2/invoicing/payInvoice/i0wUKECHxctWAjRPKFgyEtZiSWxwgtZljBVSrxfFjbBVGgLpET8ROvOPdnhwCJTC?version=v2.1"
      },
      "orderInformation": {
        "amountDetails": {
          "totalAmount": 2623.64,
          "currency": "USD"
        }
      }
    }
  ]
}
```

REST Interactive Example: Get a List of Invoices {#invoicing-services-get-list-ex-live}
=======================================================================================

Click this image to access the interactive code example for retrieving a list of invoices.

#### Figure:

Interactive Code [![Image and link to the interactive code example for creating a new
invoice.](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-services-create.png/jcr:content/renditions/original)](https://developer.cybersource.com/api-reference-assets/index.md#invoicing_invoices_get-a-list-of-invoices "")

Get Invoice Details {#invoicing-services-get-details-intro}
===========================================================

Retrieve an invoice's details to check its current status and payment history. Retrieving an invoice's details requires the unique invoice number assigned when the invoice was created.  
If you need more information about the payment history, you can also use the transaction details API. For more information, see the [Transaction Details API](https://developer.cybersource.com/docs/cybs/en-us/txn-search/developer/all/rest/txn-search/txn-details-intro.md "") section in the *Transaction Search and Details API Developer Guide*.

Endpoints
---------

Send your API request to one of these endpoints:  
**Test:** `GET https://``https://apitest.cybersource.com``/invoicing/v2/invoices/`*{id}*  
**Production:** `GET https://``https://api.cybersource.com``/invoicing/v2/invoices/`*{id}*  
**India Production:** `GET https://api.in.cybersource.com/invoicing/v2/invoices/`*{id}*  
The *`{id}`* is the invoice number from the invoice creation response message.

Successful Response
-------------------

A response contains this invoice information:

|           Response Field           |                                                                                                                                                                                                                                                                                                                                                                                Description                                                                                                                                                                                                                                                                                                                                                                                |
|------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| submitTimeUtc                      | The date and time that the invoice was sent, in UTC format.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| status                             | The invoice status. Possible values: * `CANCELED`: The invoice is cancelled. * `CREATED`: The invoice is created. * `DRAFT`: The invoice is drafted and not published. * `PAID`: The invoice is fully paid. The customer is notified that the payment is successful. * `PARTIAL`: The invoice is partially paid. * `PENDING`: Fraud management is reviewing the invoice and you must accept or reject the payment. The customer is also notified that the payment is processing. When you accept the payment, the invoice updates to the `PAID` status. If you reject the payment, the invoice updates to the `SENT` status. > IMPORTANT This status is only retrievable for merchants with fraud management enabled. * `SENT`: The invoice is delivered to the customer. |
| customerInformation (field object) | The customer's information, such as name and email.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| invoiceInformation (field object)  | The `paymentLink` field contains the direct URL to the invoice.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| orderInformation (field object)    | The itemized amount charged for the billed goods and services.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| invoiceHistory (field object)      | An array of invoice status changes and the date and time stamp of each invoice status changed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
[Response Fields to a Successful Request]

Example: Get Invoice Details {#invoicing-services-get-details-ex-rest}
======================================================================

Endpoint with an Invoice Number

```keyword
GET https://https://api.cybersource.com/invoicing/v2/invoices/2670
```

Request

```
{}
```

Response to a Successful Request

```keyword
{
  "_links": {
    "self": {
      "href": "/v2/invoices/2670",
      "method": "GET"
    },
    "update": {
      "href": "/v2/invoices/2670",
      "method": "PUT"
    },
    "deliver": {
      "href": "/v2/invoices/2670/delivery",
      "method": "POST"
    },
    "cancel": {
      "href": "/v2/invoices/2670/cancelation",
      "method": "POST"
    }
  },
  "id": "2670",
  "submitTimeUtc": "2024-07-24T18:36:18.863175539Z",
  "status": "SENT",
  "customerInformation": {
    "name": "Tanya Lee",
    "email": "tanya.lee@my-email.world"
  },
  "processingInformation": {
    "requestPhone": false,
    "requestShipping": false
  },
  "invoiceInformation": {
    "invoiceNumber": "2670",
    "dueDate": "2019-07-11",
    "allowPartialPayments": false,
    "paymentLink": "https://businesscenter.cybersource.com/ebc2/invoicing/payInvoice/W447tdnINi5t5wu6QA0KUE2HYWY2rQQ0zXL5b5z6M50w4Ea9FFlcYrEmp09pFlzl?version=v2.1",
    "deliveryMode": "Email"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": 247.86,
      "currency": "USD",
      "balanceAmount": 247.86
    },
    "lineItems": [
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "unitPrice": 12.05,
        "quantity": 20,
        "totalAmount": 247.86
      }
    ]
  },
  "invoiceHistory": [
    {
      "event": "SEND",
      "date": "2024-07-24T18:35:23.320Z"
    },
    {
      "event": "DRAFT",
      "date": "2024-07-24T18:35:22.960Z"
    }
  ]
}
```

REST Interactive Example: Get Invoice Details {#invoicing-services-get-details-ex-live}
=======================================================================================

Click this image to access the interactive code example for retrieving invoice details.

#### Figure:

Interactive Code [![Image and link to the interactive code example for creating a new
invoice.](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-services-create.png/jcr:content/renditions/original)](https://developer.cybersource.com/api-reference-assets/index.md#invoicing_invoices_get-invoice-details "")

Update an Invoice {#invoicing-services-update-intro}
====================================================

You can update an invoice if no payment has been made. Include all of the fields that were contained in the original request message in the update request. If you do not include a field that was in the original request message, the field information associated with it will be removed in the updated invoice.  
If you update the customer's email in the customerInformation.email request field, the generated redirect URL in the invoiceInformation.paymentLink response field changes and the previous URL becomes invalid. You can either share the new redirect URL with the customer, or resend the updated invoice using the send invoice request. For more information about how to resend an invoice, see [Send an Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-send-intro.md "").

Itemized Invoices
:
An invoice can display a single billed amount or list up to 30 billed items. To list the billed items in the invoice, include the items in the request using the line item array fields. An invoice with line items is known as an *itemized* invoice. For more information about how to include line items in your request, see [Including Line Items in an Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-line-items.md "").

Installment Payments
:
Invoices can be paid in installment payments when these fields and values are included in the request. If an invoice is payable in installments, multiple customers can make payments towards the same invoice.

    invoiceInformation.allowPartialPayments
    :
        Set to `true`.


    orderInformation.amountDetails.minimumPartialAmount
    :
        Set to the minimum amount allowed for a partial payment.

Partner Information
:
If your merchant account is associated with a `Cybersource` partner, you can include your partner solution ID (PSID) in the request message for tracking and reporting purposes. To include your PSID, use the clientReferenceInformation.partner.solutionId request field and set its field value to your PSID.

Endpoints
---------

Send your API request message to one of these endpoints:  
**Test:** `PUT ``https://apitest.cybersource.com``/invoicing/v2/invoices/`*{id}*  
**Production:** `PUT ``https://api.cybersource.com``/invoicing/v2/invoices/`*{id}*  
**India Production:** `PUT https://api.in.cybersource.com/invoicing/v2/invoices/`*{id}*  
The *`{id}`* is the invoice number from the response to the create invoice request.

Required Fields for Updating an Invoice {#invoicing-services-update-req-fields}
===============================================================================

Include these fields and any additional fields contained in the original request to create the invoice.

invoiceInformation.description
:
This field becomes optional if the line item fields are present in the request message.

invoiceInformation.dueDate
:

[orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "")
:

[orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "")
:

orderInformation.lineItems\[\].productSku
:

Optional Fields for Updating an Invoice {#invoicing-services-update-opt-fields}
===============================================================================

Include all of the fields contained in the original request. If you do not include a field that was in the original request, the field information associated with it is removed in the updated invoice.

[clientReferenceInformation.partner.solutionId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-partner-solution-id.md "")
:
Set to your partner solution ID (PSID).

[clientReferenceInformation.partner.developerId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-partner-developer-id.md "")
:
Set to your developer ID.

customerInformation.company.name
:

customerInformation.email
:

customerInformation.merchantCustomerId
:

customerInformation.name
:

invoiceInformation.allowPartialPayments
:

invoiceInformation.deliveryMode
:

invoiceInformation.description
:
This field is optional when either of these conditions is met:

    * The invoiceInformation.deliveryMode request field is set to `email`.
    * The line item fields are present in the request message.

invoiceInformation.invoiceNumber
:
Set to a unique number to create an invoice number.

    If you do not include this field and a unique value, the invoicing API automatically generates an invoice number for the new invoice.

    > IMPORTANT You cannot update this invoice number after sending the API request.

invoiceInformation.sendImmediately
:

[orderInformation.amountDetails.discountAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-discount-amount.md "")
:

orderInformation.amountDetails.discountPercent
:

orderInformation.amountDetails.freight.amount
:

orderInformation.amountDetails.freight.taxable
:

orderInformation.amountDetails.freight.taxRate
:

orderInformation.amountDetails.minimumPartialAmount
:

orderInformation.amountDetails.subAmount
:

orderInformation.amountDetails.taxDetails.amount
:

orderInformation.amountDetails.taxDetails.rate
:

orderInformation.amountDetails.taxDetails.type
:

[orderInformation.lineItems\[\].discountAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-discount-amount.md "")
:

orderInformation.lineItems\[\].discountRate
:

[orderInformation.lineItems\[\].taxAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-tax-amount-request.md "")
:

[orderInformation.lineItems\[\].taxRate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-tax-rate.md "")
:

[orderInformation.lineItems\[\].productName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-product-name.md "")
:

orderInformation.lineItems\[\].productSku
:

[orderInformation.lineItems\[\].quantity](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-quantity.md "")
:

[orderInformation.lineItems\[\].totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-total-amount.md "")
:

[orderInformation.lineItems\[\].unitPrice](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-unit-price.md "")
:

Example: Updating an Invoice {#invoicing-services-update-ex-rest}
=================================================================

Endpoint to Update an Invoice

```keyword
https://api.cybersource.com/invoicing/v2/invoices/98761
```

Request

```
{
  "customerInformation": {
    "name": "Tanya Lee",
    "email": "tanya.lee@my-email.world"
  },
  "invoiceInformation": {
    "dueDate": "2019-07-15"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "2623.64",
      "currency": "USD"
    },
    "lineItems": [
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "quantity": "20",
        "unitPrice": "12.05",
        "totalAmount": "247.86"
      }
    ]
  }
}
```

Response to a Successful Request

```keyword
{
  "_links": {
    "self": {
      "href": "/v2/invoices/2670",
      "method": "GET"
    },
    "update": {
      "href": "/v2/invoices/2670",
      "method": "PUT"
    },
    "deliver": {
      "href": "/v2/invoices/2670/delivery",
      "method": "POST"
    },
    "cancel": {
      "href": "/v2/invoices/2670/cancelation",
      "method": "POST"
    }
  },
  "id": "2670",
  "submitTimeUtc": "2024-07-24T19:40:37.289869220Z",
  "status": "SENT",
  "customerInformation": {
    "name": "Tanya Lee",
    "email": "tanya.lee@my-email.world"
  },
  "processingInformation": {
    "requestPhone": false,
    "requestShipping": false
  },
  "invoiceInformation": {
    "invoiceNumber": "2670",
    "dueDate": "2019-07-15",
    "allowPartialPayments": false,
    "paymentLink": "https://businesscenter.cybersource.com/ebc2/invoicing/payInvoice/W447tdnINi5t5wu6QA0KUE2HYWY2rQQ0zXL5b5z6M50w4Ea9FFlcYrEmp09pFlzl?version=v2.1",
    "deliveryMode": "Email"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": 2623.64,
      "currency": "USD",
      "balanceAmount": 2623.64
    },
    "lineItems": [
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "unitPrice": 12.05,
        "quantity": 20,
        "totalAmount": 247.86
      }
    ]
  }
}
```

Request with Optional Fields

```
{
  "customerInformation": {
    "name": "Tanya Lee",
    "email": "tanya.lee@my-email.world",
    "merchantCustomerId": "1234",
    "company": {
      "name": "ABC"
    }
  },
  "invoiceInformation": {
    "description": "This is an updated test invoice",
    "dueDate": "2019-07-15",
    "allowPartialPayments": true,
    "deliveryMode": "none"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "2623.64",
      "currency": "USD",
      "discountAmount": "126.08",
      "discountPercent": 5,
      "subAmount": 2749.72,
      "minimumPartialAmount": 200,
      "taxDetails": {
        "type": "State Tax",
        "amount": "208.00",
        "rate": "8.25"
      },
      "freight": {
        "amount": "20.00",
        "taxable": true,
        "taxRate": "0.01"
      }
    },
    "lineItems": [
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "quantity": "20",
        "unitPrice": "12.05",
        "discountAmount": "13.04",
        "discountRate": "0.0",
        "taxAmount": "0.0",
        "taxRate": "0.0",
        "totalAmount": "247.86"
      }
    ]
  }
}
```

Response to a Successful Request with Optional Fields

```keyword
{
  "_links": {
    "self": {
      "href": "/v2/invoices/2670",
      "method": "GET"
    },
    "update": {
      "href": "/v2/invoices/2670",
      "method": "PUT"
    },
    "deliver": {
      "href": "/v2/invoices/2670/delivery",
      "method": "POST"
    },
    "cancel": {
      "href": "/v2/invoices/2670/cancelation",
      "method": "POST"
    }
  },
  "id": "2670",
  "submitTimeUtc": "2024-07-24T19:46:18.914132825Z",
  "status": "SENT",
  "customerInformation": {
    "name": "Tanya Lee",
    "email": "tanya.lee@my-email.world",
    "merchantCustomerId": "1234",
    "company": {
      "name": "ABC"
    }
  },
  "processingInformation": {
    "requestPhone": false,
    "requestShipping": false
  },
  "invoiceInformation": {
    "invoiceNumber": "2670",
    "description": "This is an updated test invoice",
    "dueDate": "2019-07-15",
    "allowPartialPayments": true,
    "paymentLink": "https://businesscenter.cybersource.com/ebc2/invoicing/payInvoice/W447tdnINi5t5wu6QA0KUE2HYWY2rQQ0zXL5b5z6M50w4Ea9FFlcYrEmp09pFlzl?version=v2.1",
    "deliveryMode": "None"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": 2623.64,
      "currency": "USD",
      "balanceAmount": 2623.64,
      "discountAmount": 126.08,
      "discountPercent": 5,
      "subAmount": 2749.72,
      "minimumPartialAmount": 200,
      "taxDetails": {
        "type": "State Tax",
        "amount": 208,
        "rate": 8.25
      },
      "freight": {
        "amount": 20,
        "taxable": true,
        "taxRate": 0.01
      }
    },
    "lineItems": [
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "unitPrice": 12.05,
        "quantity": 20,
        "discountAmount": 13.04,
        "taxAmount": 0,
        "taxRate": 0,
        "totalAmount": 247.86
      }
    ]
  }
}
```

REST Interactive Example: Update an Invoice {#invoicing-services-update-ex-live}
================================================================================

Click this image to access the interactive code example for updating an invoice.

#### Figure:

Interactive Code [![Image and link to the interactive code example for creating a new
invoice.](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-services-create.png/jcr:content/renditions/original)](https://developer.cybersource.com/api-reference-assets/index.md#invoicing_invoices_update-an-invoice "")

Send an Invoice {#invoicing-services-send-intro}
================================================

You can send a published or drafted invoice that was not sent when it was initially created. You can also resend an unpaid invoice or a partially paid invoice. Fully paid or canceled invoices cannot be resent.

Endpoints
---------

Send your API request message to one of these endpoints.  
**Test:** `POST ``https://apitest.cybersource.com``/invoicing/v2/invoices/`*{id}*`/delivery`  
**Production:** `POST ``https://api.cybersource.com``/invoicing/v2/invoices/`*{id}*`/delivery`  
**India Production:** `POST https://api.in.cybersource.com/invoicing/v2/invoices/`*{id}*`/delivery`  
The *`{id}`* is the invoice number from the response to the create invoice request.

Successful Response
-------------------

A successful request is indicated by an updated submit time in the submitTimeUtc response field.  
The invoice status in the status response field might update to a new status depending on the field value that was set in the invoiceInformation.deliveryMode request field when the invoice was initially created.  
Use this table to determine how an invoice's status will change when you send or resend it. The Initial Status column indicates the invoice's initial status, which was in the status response field. The Delivery Method column indicates whether or not the customer was immediately emailed when the invoice was created, which was determined by the invoiceInformation.deliveryMode field value. The Notification Description column explains what happens to an invoice when you submit a send invoice request, which is the result of the invoice's initial status and whether or not it was emailed to the customer. The New Status column indicates the new status of the invoice after you submit a send invoice request, which can be found in the status response field.

| Initial Status | Delivery Method |                                                                                        Notification Description                                                                                         | New Status |
|----------------|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------|
| `DRAFT`        | `email`         | An invoice email is sent to the customer.                                                                                                                                                               | `SENT`     |
| `DRAFT`        | `none`          | The customer is **not** sent an invoice email. To share the newly created invoice with the customer, send the customer the redirect URL generated in the invoiceInformation.paymentLink response field. | `CREATED`  |
| `CREATED`      | `email`         | An invoice email is sent to the customer.                                                                                                                                                               | `SENT`     |
| `SENT`         | `email`         | An invoice email is resent to the customer.                                                                                                                                                             | `SENT`     |
| `PARTIAL`      | `email`         | An invoice email is sent to the customer.                                                                                                                                                               | `PARTIAL`  |
[New Invoice Statuses]

Example: Send an Invoice {#invoicing-services-send-ex-rest}
===========================================================

Endpoint with an Invoice Number

```keyword
https://api.cybersource.com/invoicing/v2/invoices/2675/delivery
```

Request

```
{}
```

Response to a Successful Request

```
{
  "_links": {
    "self": {
      "href": "/v2/invoices/2675",
      "method": "GET"
    },
    "update": {
      "href": "/v2/invoices/2675",
      "method": "PUT"
    },
    "deliver": {
      "href": "/v2/invoices/2675/delivery",
      "method": "POST"
    },
    "cancel": {
      "href": "/v2/invoices/2675/cancelation",
      "method": "POST"
    }
  },
  "id": "2675",
  "submitTimeUtc": "2024-07-24T19:54:06.665139633Z",
  "status": "CREATED",
  "customerInformation": {
    "name": "Tanya Lee",
    "email": "tanya.lee@my-email.world",
    "merchantCustomerId": "1234",
    "company": {
      "name": "ABC"
    }
  },
  "processingInformation": {
    "requestPhone": false,
    "requestShipping": false
  },
  "invoiceInformation": {
    "invoiceNumber": "2675",
    "description": "This is a test invoice",
    "dueDate": "2019-07-11",
    "allowPartialPayments": true,
    "paymentLink": "https://developer.cybersource.com/ebc2/invoicing/payInvoice/9fO0CogtSMJiDO3VKR4GYijUSYHtKV4kjS6u0ENZpY9iq2pkdKJmwTTSlGCDOVHJ?version=v2.1",
    "deliveryMode": "None"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": 2623.64,
      "currency": "USD",
      "balanceAmount": 2623.64,
      "discountAmount": 126.08,
      "discountPercent": 5,
      "subAmount": 2749.72,
      "minimumPartialAmount": 20,
      "taxDetails": {
        "type": "State Tax",
        "amount": 208,
        "rate": 8.25
      },
      "freight": {
        "amount": 20,
        "taxable": true
      }
    },
    "lineItems": [
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "unitPrice": 12.05,
        "quantity": 20,
        "discountAmount": 13.04,
        "taxAmount": 0,
        "taxRate": 0,
        "totalAmount": 247.86
      }
    ]
  }
}
```

REST Interactive Example: Send an Invoice {#invoicing-services-send-ex-live}
============================================================================

Click this image to access the interactive code example for sending or resending an invoice.

#### Figure:

Interactive Code [![Image and link to the interactive code example for creating a new
invoice.](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-services-create.png/jcr:content/renditions/original)](https://developer.cybersource.com/api-reference-assets/index.md#invoicing_invoices_send-an-invoice "")

Cancel an Invoice {#invoicing-services-cancel-intro}
====================================================

You can cancel an unpaid invoice. Partially paid or fully paid invoices cannot be cancelled.  
Cancelling an invoice requires the invoice number that was assigned when the invoice was created.

Endpoints
---------

Send your API request message to one of these endpoints:  
**Production:** `POST ``https://api.cybersource.com``/invoicing/v2/invoices/`*{id}*`/cancelation`  
**Test:** `POST ``https://apitest.cybersource.com``/invoicing/v2/invoices/`*{id}*`/cancelation`  
**India Production:** `POST https://api.in.cybersource.com/invoicing/v2/invoices/`*{id}*`/cancelation`  
The *`{id}`* is the invoice number from the response to the create invoice request.

Successful Response
-------------------

A successful request is indicated by the `canceled` status in the status response field and an updated time in the submitTimeUtc response field.

Example: Cancelling an Invoice {#invoicing-services-cancel-ex-rest}
===================================================================

Endpoint with an Invoice Number

```keyword
https://apitest.cybersource.com/invoicing/v2/invoices/2675/cancelation
```

Request

```
{}
```

Response to a Successful Request

```
{
  "_links": {
    "self": {
      "href": "/v2/invoices/2675",
      "method": "GET"
    }
  },
  "id": "2675",
  "submitTimeUtc": "2024-07-24T19:56:06.410896558Z",
  "status": "CANCELED",
  "customerInformation": {
    "name": "Tanya Lee",
    "email": "tanya.lee@my-email.world",
    "merchantCustomerId": "1234",
    "company": {
      "name": "ABC"
    }
  },
  "processingInformation": {
    "requestPhone": false,
    "requestShipping": false
  },
  "invoiceInformation": {
    "invoiceNumber": "2675",
    "description": "This is a test invoice",
    "dueDate": "2019-07-11",
    "allowPartialPayments": true,
    "deliveryMode": "None"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": 2623.64,
      "currency": "USD",
      "balanceAmount": 2623.64,
      "discountAmount": 126.08,
      "discountPercent": 5,
      "subAmount": 2749.72,
      "minimumPartialAmount": 20,
      "taxDetails": {
        "type": "State Tax",
        "amount": 208,
        "rate": 8.25
      },
      "freight": {
        "amount": 20,
        "taxable": true
      }
    },
    "lineItems": [
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "unitPrice": 12.05,
        "quantity": 20,
        "discountAmount": 13.04,
        "taxAmount": 0,
        "taxRate": 0,
        "totalAmount": 247.86
      }
    ]
  }
}
```

REST Interactive Example: Cancel an Invoice {#invoicing-services-cancel-ex-live}
================================================================================

Click this image to access the interactive code example for cancelling an invoice.

#### Figure:

Interactive Code [![Image and link to the interactive code example for creating a new
invoice.](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-services-create.png/jcr:content/renditions/original)](https://developer.cybersource.com/api-reference-assets/index.md#invoicing_invoices_cancel-an-invoice "")

Including Line Items in an Invoice {#invoicing-services-line-items}
===================================================================

You can itemize invoices by including the line item fields in your request when you create, draft, and update an invoice.  
*Line items* are used to include information about your customers' purchases. Information can include product name, quantity, and price.  
Line items are included in a request in the lineItem\[\] array request field.  
You can include the line item fields in these requests:

* [Create a Draft Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-draft-intro.md "")
* [Create a Deliverable Draft Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-draft-dlvr-intro.md "")
* [Create and Send an Invoice Immediately](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-send-intro.md "")
* [Create an Invoice without Sending it](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-create-intro.md "")
* [Update an Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-services-intro/invoicing-services-update-intro.md "")

These fields are required for each line item in your request:

[orderInformation.lineItems\[\].productName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-product-name.md "")
:

orderInformation.lineItems\[\].productSku
:

[orderInformation.lineItems\[\].quantity](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-quantity.md "")
:

[orderInformation.lineItems\[\].totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-total-amount.md "")
:

[orderInformation.lineItems\[\].unitPrice](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-unit-price.md "")
:

These fields are optional for each line item in your request:

[orderInformation.lineItems\[\].discountAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-discount-amount.md "")
:

orderInformation.lineItems\[\].discountRate
:

[orderInformation.lineItems\[\].taxAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-tax-amount-request.md "")
:

[orderInformation.lineItems\[\].taxRate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-tax-rate.md "")
:

Example: Including Line Items  
This excerpt from a request shows three valid line items.

```
{ 
  "orderInformation": {
    "lineItems": [
      {
        "productSku": "ABCD1234",
        "productName": "First line item's name",
        "quantity": "20",
        "unitPrice": "12.05",
        "discountAmount": "13.04",
        "taxAmount": "0.0",
        "taxRate": "0.0",
        "totalAmount": "247.86"
      },
      {
        "productSku": "EFGH5678",
        "productName": "Second line item's name",
        "quantity": "20",
        "unitPrice": "12.05",
        "discountAmount": "13.04",
        "taxAmount": "0.0",
        "taxRate": "0.0",
        "totalAmount": "247.86"
      },
      {
        "productSku": "IJKL9999",
        "productName": "Third line item's name",
        "quantity": "20",
        "unitPrice": "12.05",
        "discountAmount": "13.04",
        "taxAmount": "0.0",
        "taxRate": "0.0",
        "totalAmount": "247.86"
      }
    ]
  }
}
```

Invoice Settings API Requests {#invoicing-settings-intro}
=========================================================

The Invoice Settings API enables you to customize your invoice checkout experience, add a custom message to your email communications, and enable payer authentication. You can also retrieve the invoice settings for your payment page.

* [Update Invoice Settings](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-settings-intro/invoicing-settings-update.md "")
* [Get Invoice Settings](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-settings-intro/invoicing-settings-get.md "")

Update Invoice Settings {#invoicing-settings-update}
====================================================

Updating your invoice settings enables you to customize the checkout experience of the invoice payment page to match your branding:

* Brand colors
* Business name
* Logo
* VAT tax number

You can also choose to capture a customer's shipping information, phone number, and email during the checkout process.  
To enable payer authentication, see [Add Payer Authentication to Invoicing](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-features-intro.md "").

Endpoints
---------

Send your API request message to one of these endpoints:  
**Production:** `PUT ``https://api.cybersource.com``/invoicing/v2/invoiceSettings`  
**Test:** `PUT ``https://apitest.cybersource.com``/invoicing/v2/invoiceSettings`  
**India Production:** `PUT https://api.in,cybersource.com/invoicing/v2/invoiceSettings`

Fields for Updating Invoice Settings {#invoicing-settings-update-fields}
========================================================================

The update invoice settings request does not require a specific set of fields. Instead, you can choose the fields to include in your request based on aspects of your checkout experience, email communications, and payer authentication enablement.

|           Name           |                   API Request Field                    |                                                                                                                                                                                     Description                                                                                                                                                                                      |
|--------------------------|--------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Business Name            | invoiceSettingsInformation.merchantDisplayName         | The business name displayed on the invoice.                                                                                                                                                                                                                                                                                                                                          |
| Currency                 | invoiceSettingsInformation.defaultCurrencyCode         | The currency of the billed amount. The currency code default value is set to `USD` when this field is not specified. Only three-character ISO Standard Currency Codes are accepted. For more information, see [ISO Standard Currency Codes](https://developer.cybersource.com/docs/cybs/en-us/currency-codes/reference/all/na/currency-codes/currency-codes.md "") reference guide.. |
| Header Background Color  | invoiceSettingsInformation.headerStyle.backgroundColor | The background color of the displayed invoice. Only hexadecimal code values with a prefixed `#` are accepted. Example: `#000000`                                                                                                                                                                                                                                                     |
| Header Font Color        | invoiceSettingsInformation.headerStyle.fontColor       | The invoice font color. Only hexadecimal code values with a prefixed `#` are accepted. Example: `#000000`                                                                                                                                                                                                                                                                            |
| Logo                     | invoiceSettingsInformation.merchantLogo                | The binary format of your logo that determines the image displayed to your customers. Image files are restricted to 1 MB and must be encoded in Base64 format. These are the supported file types: * gif * jpg * png                                                                                                                                                                 |
| VAT Tax Number           | invoiceSettingsInformation.vatRegistrationNumber       | The government-assigned tax identification number.                                                                                                                                                                                                                                                                                                                                   |
| VAT Tax Number Displayed | invoiceSettingsInformation.showVatNumber               | The toggle for displaying the VAT tax number in the invoice. Possible values: * `false`: Do not display the VAT tax number. * `true`: Display the VAT tax number.                                                                                                                                                                                                                    |
[Update Checkout Page Settings]

|      Name      |               API Request Field               |                                                                                                                                                                                                                    Description                                                                                                                                                                                                                    |
|----------------|-----------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Email Message  | invoiceSettingsInformation.customEmailMessage | The custom message in the invoice email.                                                                                                                                                                                                                                                                                                                                                                                                          |
| Email Reminder | invoiceSettingsInformation.enableReminders    | The toggle for sending an email reminder to the customer five days before the invoice due and one day after it is past due. Possible values: * `False`: No email reminder is sent. * `True`: Email reminders are sent.                                                                                                                                                                                                                            |
| Language       | invoiceSettingsInformation.deliveryLanguage   | The language of the email message sent to the customer. Set to one of these possible values: * `de-DE`: German (Germany) * `en-US`: English (United States) * `es-419`: Spanish as used in Latin America and the Caribbean * `fr-FR`: French (France) * `ja-JP`: Japanese (Japan) * `pt-BR`: Portuguese (Brazil) * `ru-RU`: Russian (Russia) * `zh-CN`: Chinese (Simplified, People's Republic of China) * `zh-TW`: Chinese (Traditional, Taiwan) |
[Update Email Communication Settings]

|              Name               |                     API Request Field                     |                                                                                                                                                                                                Description                                                                                                                                                                                                |
|---------------------------------|-----------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Payer Authentication Enablement | invoiceSettingsInformation.payerAuthenticationInInvoicing | The indicator for payer authentication enablement. Possible values: * `disable`: Disable 3-D Secure * `enable`: Enable 3-D Secure payer authentication For more information about including payer authentication to your invoices, see [Add Payer Authentication to Invoicing](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-features-intro.md ""). |
[Payer Authentication Enablement Settings]

Example: Update Invoice Settings {#invoicing-settings-update-ex}
================================================================

Request

```
{
  "invoiceSettingsInformation": {
    "merchantLogo": "/9j/4AAQSkZJRgABAQEAYA",
    "merchantDisplayName": "Custom Merchant Display Name",
    "customEmailMessage": "Custom merchant email message",
    "enableReminders": true,
    "headerStyle": {
      "fontColor": "#000001",
      "backgroundColor": "#FFFFFF"
    },
    "deliveryLanguage": "en-US",
    "defaultCurrencyCode": "USD",
    "payerAuthenticationInInvoicing": "enable",
    "showVatNumber": false,
    "vatRegistrationNumber": "Inv1234"
  }
}
```

Response to a Successful Request

```
{
  "submitTimeUtc": "2024-07-27T22:20:52.238332595Z",
  "invoiceSettingsInformation": {
    "merchantDisplayName": "Custom Merchant Display Name",
    "customEmailMessage": "Custom merchant email message",
    "enableReminders": true,
    "headerStyle": {
      "fontColor": "#000001",
      "backgroundColor": "#FFFFFF"
    },
    "deliveryLanguage": "en-US",
    "defaultCurrencyCode": "USD",
    "payerAuthentication3DSVersion": "True",
    "showVatNumber": false,
    "phoneNumber": false,
    "shipTo": false,
    "email": true
  }
}
```

REST Interactive Example: Update Invoice Settings {#invoicing-settings-update-ex-live}
======================================================================================

Click this image to access the interactive code example for updating invoice settings.

#### Figure:

Update Invoice Settings in the Developer Center Sandbox [![Image and link to the interactive code example for updating invoice
settings.](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-settings-cybs.png/jcr:content/renditions/original)](https://developer.cybersource.com/api-reference-assets/index.md#invoicing_invoice-settings_update-invoice-settings "")

Get Invoice Settings {#invoicing-settings-get}
==============================================

You can retrieve the invoice settings for your payment page by sending a get invoice request.

Endpoints
---------

Send the API request to one of these endpoints:  
**Production:** `GET ``https://api.cybersource.com``/invoicing/v2/invoiceSettings`  
**Test:** `GET ``https://apitest.cybersource.com``/invoicing/v2/invoiceSettings`  
**India Production:** `GET https://api.in.cybersource.com/invoicing/v2/invoiceSettings`

Successful Response
-------------------

A successful request is indicated by a response message that includes this information:

* Logo
* Business name
* Customized email message
* Email reminder indicator
* Color and font of the invoice
* Language used in the invoice
* Currency of the invoiced amount
* Payer authentication enablement indicator

Example: Get Invoice Settings {#invoicing-settings-get-ex}
==========================================================

Endpoint

```keyword
GET https://api.cybersource.com/invoicing/v2/invoiceSettings
```

Request

```
{}
```

Response to a Successful Request

```
{
  "submitTimeUtc": "2024-07-27T23:42:03.522831275Z",
  "invoiceSettingsInformation": {
    "merchantDisplayName": "Custom Merchant Display Name",
    "customEmailMessage": "Custom merchant email message",
    "enableReminders": true,
    "headerStyle": {
      "fontColor": "#000001",
      "backgroundColor": "#FFFFFF"
    },
    "deliveryLanguage": "en-US",
    "defaultCurrencyCode": "USD",
    "payerAuthentication3DSVersion": "True",
    "showVatNumber": false,
    "phoneNumber": false,
    "shipTo": false,
    "email": true
  }
}
```

REST Interactive Example: Get Invoice Settings {#invoicing-settings-get-ex-live}
================================================================================

Click this image to access the interactive code example for updating invoice settings.

#### Figure:

Update Invoice Settings in the Developer Center Sandbox [![Image and link to the interactive code example for updating invoice
settings.](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-settings-cybs.png/jcr:content/renditions/original)](https://developer.cybersource.com/api-reference-assets/index.md#invoicing_invoice-settings_get-invoice-settings "")

Add Payer Authentication to Invoicing {#invoicing-features-intro}
=================================================================

You can enable Payer Authentication in your invoices.  
Payer Authentication, also known as 3-D Secure, helps to minimize costly fraudulent transactions by adding an extra layer of protection to the payment process. The solution enables issuers to authenticate the cardholder using various available methods, such as one-time passwords and biometrics.  
Invoicing supports these Payer Authentication services:

* American Express SafeKey
* JCB J/Secure
* Mastercard Identity Check
* Visa Secure

Card Types
:
Payer Authentication supports these card types:

    * American Express
    * Discover
    * JCB
    * Mastercard
    * Visa

Prerequisites for Payer Authentication
--------------------------------------

To sign-up and enable Payer Authentication, you must complete these tasks.

1. Contact your `Cybersource` account representative and provide your:
   * `Cybersource` test merchant ID
   * [Merchant information](#invoicing-features-intro_pa-required-merchant-info-table "")
2. Contact your acquirer, also known as the merchant bank, to establish the Payer Authentication service.
3. If you are using an API, your software developer should become familiar with the API fields and technical details of this service.

Required Merchant Information {#invoicing-features-intro_merch-info}
--------------------------------------------------------------------

To enable Payer Authentication services, contact customer support and provide this information about your company and acquiring bank.

| Information                                                                                                                                                               | Description                                                                                                                                                                                                                                                                                   |
|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| About your company                                                                                                                                                        | * Your `Cybersource` merchant ID. * URL of your company's website, for example: *http://www.example.com*. * Two-character ISO code for your country. * 3-D Secure requestor ID. * 3-D Secure requestor name. * Merchant category code. {#invoicing-features-intro_ul-company}                 |
| Bank information                                                                                                                                                          | * Name of your bank acquirer. * Complete name and address of your bank contact, including email address. {#invoicing-features-intro_ul-bank}                                                                                                                                                  |
| Payment card information Supported card types: * American Express * Diners Club * Discover * JCB * Mastercard * Maestro * Visa {#invoicing-features-intro_ul_ydn_sfk_byb} | Information provided by your acquirer about each payment card company for which you are configured, including: * Six-digit BIN numbers. * Acquirer merchant ID: the merchant ID assigned by your acquirer. * All currencies that you can process. {#invoicing-features-intro_ul-card-company} |
[Required Merchant Information for Payer Authentication Services]

Enable Payer Authentication
---------------------------

After completing the above requirements, you must enable Payer Authentication using either the invoicing API or the `Business Center`.

API Enablement
:
To enable Payer Authentication using the invoicing API, send an *update invoice settings* request and set the invoiceSettingsInformation.payerAuthenticationInInvoicing request field to `enable`.

    For more information, see [Update Invoice Settings](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-settings-intro/invoicing-settings-update.md "").

`Business Center` Enablement
:
1. Log in to the `Business Center`.
* **Test:**  
[`https://businesscentertest.cybersource.com`](https://businesscentertest.cybersource.com/ebc2/ "")
* **Production:**  
**Production:** [`https://businesscenter.cybersource.com`](https://businesscenter.cybersource.com/ebc2/ "")
2. On the `Business Center`'s left navigation bar, navigate to ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-bttn-invoicing.svg/jcr:content/renditions/original) Invoicing \&gt; Manage Invoices.
3. Click ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-icon-accnt-mgmt.svg/jcr:content/renditions/original) **Settings**.  
![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-payerauth-ebc-settings.png/jcr:content/renditions/original)
4. Click the **Security** tab.
5. Select the **Enable** option.
6. Click **Save** when done.  
![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-settings-enable.png/jcr:content/renditions/original)

Add Invoicing Add-In to Outlook {#invoicing-addin-intro}
========================================================

The Visa Invoicing Add-In enables you to manage invoices directly from your Microsoft Outlook desktop application. From Outlook you can:

* Create new simplified or itemized invoices.
* Send invoices quickly and securely to your customers.
* Track your customers' outstanding, overdue, and paid invoices.
* Remind your customers to pay any outstanding or overdue invoices.

When you enter a customer's email address as the recipient of an email, the add-in uses the saved customer's information from your `Cybersource` account to auto-generate messages with a secure payment link.  
To use the Visa invoicing services from the add-in, you can log in to your existing `Cybersource` account from the add-in, or register to create a test `Cybersource` account.

Set Up Add-In
-------------

Follow one of these methods to set up the Visa Invoicing Add-in in Microsoft Outlook:

Set Up Add-In with an Existing `Cybersource` Account
:
1. Install the Visa Invoicing Add-In from the Microsoft App store.
2. Log in to your `Cybersource` account.

    For more information, see [Set up add-in with an existing account](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-addin-intro/invoicing-addin-setup-existing-task.md "").

Set Up Add-In with a New `Cybersource` Account
:
1. Install the Visa Invoicing Add-In from the Microsoft App store.
2. Register a `Cybersource` test account.
3. Go live by sending a MID configuration request.

    For more information, see [Set up add-in with a new account](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-addin-intro/invoicing-addin-setup-new-task.md "").

Services
--------

These services are available in Outlook with the Visa Invoicing Add-In:

* [Create a Simple Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-addin-intro/invoicing-addin-services-create-task.md "")
* [Create an Itemized Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-addin-intro/invoicing-addin-services-create-item-task.md "")
* [Manage Invoices](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-addin-intro/invoicing-addin-services-track-task.md "")
* [Revoke and Reconnect Outlook Permissions](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-addin-intro/invoicing-addin-services-revoke-task.md "")
* [Sign Out](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-addin-intro/invoicing-addin-services-signout-task.md "")

Set Up Add-In with Existing Account {#invoicing-addin-setup-existing-task}
==========================================================================

Follow these steps to install and set up the Visa Invoicing Add-In for Microsoft Outlook if you already have a production `Cybersource` account.

1. Go to the Microsoft AppSource.{#invoicing-addin-setup-existing-task_1}
   {#invoicing-addin-setup-existing-task_1}
2. Use the AppSource search field to find the **Visa Invoicing** add-in.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-appsource.png/jcr:content/renditions/original) {#invoicing-addin-setup-existing-task_2}
   {#invoicing-addin-setup-existing-task_2}
3. Click **Get it now** to download and install it.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-appsource-overview.png/jcr:content/renditions/original) {#invoicing-addin-setup-existing-task_3}
   {#invoicing-addin-setup-existing-task_3}
4. If you are not already signed in to your Microsoft account, enter your account credentials on the Sign in to Microsoft AppSource window, then click **Sign in**.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-appsource-signin.png/jcr:content/renditions/original) {#invoicing-addin-setup-existing-task_4}
   {#invoicing-addin-setup-existing-task_4}
5. Confirm or edit your details, and click **Get it now**.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-appsource-signin-get.png/jcr:content/renditions/original) {#invoicing-addin-setup-existing-task_5}
   {#invoicing-addin-setup-existing-task_5}
6. A window opens asking if you would like to install Visa invoicing. Click **Continue**.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-appsource-continue.png/jcr:content/renditions/original)  
   The Visa Invoicing Add-in installs on your Outlook desktop application. {#invoicing-addin-setup-existing-task_6}
   {#invoicing-addin-setup-existing-task_6}
7. Open your Outlook desktop application and click the **Visa Invoicing** add-in.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-icon.png/jcr:content/renditions/original) {#invoicing-addin-setup-existing-task_7}
   {#invoicing-addin-setup-existing-task_7}
8. On the Welcome page, click **Get started**.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-getstarted.png/jcr:content/renditions/original) {#invoicing-addin-setup-existing-task_8}
   {#invoicing-addin-setup-existing-task_8}
9. On the next page, choose the **Production** or **Test** environment, whichever your account is configured for, and then click **Sign in to Visa Invoicing**.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-signin.png/jcr:content/renditions/original) {#invoicing-addin-setup-existing-task_9}
   {#invoicing-addin-setup-existing-task_9}
10. On the sign-in page, enter your `Business Center` organization ID, username, and password. Click **Sign in**.  
    ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-signin-fill.png/jcr:content/renditions/original) {#invoicing-addin-setup-existing-task_10}
    {#invoicing-addin-setup-existing-task_10}
11. Review the permissions disclosure, and click **Allow** to grant Microsoft Outlook access to your `Business Center` account for invoicing purposes.  
    ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-perm.png/jcr:content/renditions/original)  
    When you log in to the Visa Invoicing add-in, the Dashboard opens. You can choose from several tasks such as creating and managing invoices, managing permissions, and signing out. Any invoices you already have are listed.  
    ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-dashboard.png/jcr:content/renditions/original) {#invoicing-addin-setup-existing-task_11}
    {#invoicing-addin-setup-existing-task_11}

Set Up Add-In with New Account {#invoicing-addin-setup-new-task}
================================================================

Follow these steps to install and set up the Visa Invoicing Add-In for Microsoft Outlook if you do not already have a `Cybersource` account.

1. Go to the Microsoft AppSource.
2. Use the AppSource search field to find the **Visa Invoicing** add-in.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-appsource.png/jcr:content/renditions/original)
3. Click **Get it now** to download and install it.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-appsource-overview.png/jcr:content/renditions/original)
4. If you are not already signed in to your Microsoft account, enter your account credentials on the Sign in to Microsoft AppSource window, then click **Sign in**.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-appsource-signin.png/jcr:content/renditions/original)
5. Confirm or edit your details, and click **Get it now**.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-appsource-signin-get.png/jcr:content/renditions/original)
6. A window opens asking if you would like to install Visa invoicing. Click **Continue**.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-appsource-continue.png/jcr:content/renditions/original)  
   The Visa Invoicing Add-in installs on your Outlook desktop application.
7. Open your Outlook desktop application and click the **Visa Invoicing** add-in.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-icon.png/jcr:content/renditions/original)
8. On the Welcome page, click **Get started**.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-getstarted.png/jcr:content/renditions/original)
9. Click **Create an account at Visa Invoicing**.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-signin.png/jcr:content/renditions/original)  
   You are redirected to the Sign up for an account page.
10. On the Sign up for an account page, enter the information requested, check the **Terms and conditions** check box, and then click **Create Account**.  
    ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-signup.png/jcr:content/renditions/original)
11. Check your email account for a `Cybersource` Account Creation confirmation email message. The email will contain your account ID and your organization ID. In the email, click **Set up your username and password now**.  
    ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-email.png/jcr:content/renditions/original)  
    You are redirected to the account creation page.
12. On the New User Sign Up page, enter your Organization ID and Contact Email, and then click **Submit**.  
    ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-signup-org.png/jcr:content/renditions/original)
13. On the Create User Name page, enter your first name, last name, and username, and then click **Next step**.  
    ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-signup-name.png/jcr:content/renditions/original)
14. On the Create Password page, enter a password that conforms to the password requirements, and then click **Create user**.  
    ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-signup-pw.png/jcr:content/renditions/original)  
    The Successfully Created User page opens, confirming that your account is successfully created.  
    ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-signup-done.png/jcr:content/renditions/original)
15. Open your Outlook desktop application and click the **Visa Invoicing** add-in.  
    ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-icon.png/jcr:content/renditions/original)
16. On the Welcome page, click **Get started**.  
    ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-getstarted.png/jcr:content/renditions/original)
17. Select **Test** environment and then click **Sign in to Visa Invoicing**.
18. On the sign-in page, enter your `Business Center` organization ID, username, and password. Click **Sign in**.  
    ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-signin-fill.png/jcr:content/renditions/original)
19. Review the permissions disclosure, and click **Allow** to grant Microsoft Outlook access to your `Business Center` account for invoicing purposes.  
    ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-perm.png/jcr:content/renditions/original)  
    When you log in to the Visa Invoicing add-in, the Dashboard opens. You can choose from several tasks such as creating and managing invoices, managing permissions, and signing out. Any invoices you already have are listed.  
    ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-dashboard.png/jcr:content/renditions/original)
20. When you are ready to activate your account for the production environment, click **Go live**.  
    ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-live.png/jcr:content/renditions/original)  
    You are redirected to the Cybersource Support Center.
21. Click **Sign in**.  
    ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-support.png/jcr:content/renditions/original)  
    You are redirected to the `Business Center` login page.
22. Enter your organization ID, username, and password. When done, click **Log in**.  
    ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-ebc.png/jcr:content/renditions/original)  
    You are redirected to the Cybersource Support Center page.
23. At the top of the page, choose **Support Cases \&gt; MID Configuration Request**.  
    ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-config.png/jcr:content/renditions/original)
24. On the MID configuration request page, click the **MID activation** button to the right. Repeat for all other options that apply to you. When done, click **Submit**.  
    ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-outlook-midconfig.png/jcr:content/renditions/original)  
    You have successfully submitted a request to create a production account.

Create a Simple Invoice {#invoicing-addin-services-create-task}
===============================================================

A simple invoice is an invoice that displays a single amount for which your customer is being billed. To send an itemized invoice instead, see [Create an Itemized Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-addin-intro/invoicing-addin-services-create-item-task.md "").  
Follow these steps to create and send a simple invoice.

1. Open the Visa Invoicing add-in in your Microsoft Outlook desktop application.{#invoicing-addin-services-create-task_1}
   {#invoicing-addin-services-create-task_1}

2. Click the **Create simple invoice** tab.

3. Enter the following field information:

   |      Field       |                                                 Description                                                 |
   |------------------|-------------------------------------------------------------------------------------------------------------|
   | Customer name    | The customer's name or business name.                                                                       |
   | Customer email   | The customer's email address or business email address.                                                     |
   | Invoice number   | A unique number for identifying an invoice. This number cannot change. It is also known as an *invoice ID*. |
   | Description      | A description of the billed goods or service for the invoice.                                               |
   | Amount           | The amount billed to the customer in the invoice.                                                           |
   | Invoice due date | The date by which the invoice must be paid.                                                                 |
   [Invoice Fields]

   Click **Insert invoice link**.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-simple.png/jcr:content/renditions/original)  
   An invoice payment link is inserted into the email message body. If you are using a `Business Center` test account, an additional test link is inserted for you to test paying the invoice in the test environment.

4. Send the email message with the invoice link included in the message body.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-simple-email.png/jcr:content/renditions/original)

Create an Itemized Invoice {#invoicing-addin-services-create-item-task}
=======================================================================

An itemized invoice lists each good and service for which your customer is being billed. This helps your customer to know the cost of individual goods and services. To send a simple invoice instead, see [Create a Simple Invoice](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/invoicing-addin-intro/invoicing-addin-services-create-task.md "").  
Follow these steps to create and send an itemized invoice.

1. Open the Visa Invoicing add-in in your Microsoft Outlook desktop application.

2. Click the **Create list invoice** tab.

3. Enter the following field information:

   |       Field        |                                                                                                                                                                          Description                                                                                                                                                                          |
   |--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
   | Customer name\*    | The customer's name or business name.                                                                                                                                                                                                                                                                                                                         |
   | Customer email\*   | The customer's email address or business email address.                                                                                                                                                                                                                                                                                                       |
   | Invoice number\*   | A unique number for identifying an invoice. This number cannot change. It is also known as an *invoice ID*.                                                                                                                                                                                                                                                   |
   | Description\*      | A description of the billed goods or service for the invoice.                                                                                                                                                                                                                                                                                                 |
   | Invoice due date\* | The date by which the invoice must be paid.                                                                                                                                                                                                                                                                                                                   |
   | Item name\*        | The name of the listed good or service the customer is being billed for.                                                                                                                                                                                                                                                                                      |
   | Amount\*           | The billed amount for the listed good or service.                                                                                                                                                                                                                                                                                                             |
   | Quantity\*         | The number of goods or services listed in the invoice.                                                                                                                                                                                                                                                                                                        |
   | Discount           | The deducted amount from an itemized good or service amount. Choose a ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-bttn-bill.svg/jcr:content/renditions/original) fixed amount or a ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-icon-percent.svg) percentage amount for the deducted amount. |
   | Tax                | The tax percentage amount to be added to the billed amount.                                                                                                                                                                                                                                                                                                   |
   | Shipping           | The fee amount for shipping the invoiced goods or services.                                                                                                                                                                                                                                                                                                   |
   | Shipping Tax       | The tax percentage amount to be added to the shipping fee.                                                                                                                                                                                                                                                                                                    |
   | The asterisk (\*) denotes that the field information is required.                                                                                                                                                                                                                                                                                                                 ||
   [Invoice Fields]

4. To add listed items, click ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-bttn-add.svg/jcr:content/renditions/original) **Add another item** and enter the field information.

5. When you are done entering all of the listed item information, click **Insert invoice link**.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-itemized.png/jcr:content/renditions/original)  
   An invoice payment link is inserted into the email message body. If you are using a `Business Center` test account, an additional test link is inserted for you to test paying the invoice in the test environment.

6. Send the email message with the invoice link included in the message body.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-itemized-email.png/jcr:content/renditions/original)

Manage Invoices {#invoicing-addin-services-track-task}
======================================================

Follow these steps to view, track, and resend an invoice.

1. Open the Visa Invoicing add-in in your Microsoft Outlook desktop application.

2. Click the **Dashboard** tab.  
   Use the ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-bttn-sort.svg/jcr:content/renditions/original) (sort) button to organize the list by invoice number, due date, or status.

   |                                                    Tracking and Billing Information                                                     |                                                                                             Description                                                                                             |
   |-----------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
   | Invoice no. ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-bttn-sort.svg/jcr:content/renditions/original) | The unique invoice number used to identify and track and an individual invoice.                                                                                                                     |
   | Amount                                                                                                                                  | The billed amount in the invoice.                                                                                                                                                                   |
   | Due date ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-bttn-sort.svg/jcr:content/renditions/original)    | The date by which the billed amount is owed.                                                                                                                                                        |
   | Status ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-bttn-sort.svg/jcr:content/renditions/original)      | Indicates whether the invoice has been paid. Possible values: * OVERDUE: The invoice is not paid, and the due date is passed. * PAID: The invoice is paid. * UNPAID: The invoice has not been paid. |
   [Dashboard]

   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-dashboard.png/jcr:content/renditions/original)

3. Click the invoice number of the invoice you want to view.  
   The Invoice page opens.

4. If the invoice is unpaid or overdue, you can resend it. Click **Insert invoice link**.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoice-addin-dashboard-view.png/jcr:content/renditions/original)  
   An invoice payment link is inserted into the email message body.

5. Send the email message with the invoice link included in the message body.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-dashboard-resend.png/jcr:content/renditions/original)

Revoke and Reconnect Outlook Permissions {#invoicing-addin-services-revoke-task}
================================================================================

Follow these steps to revoke Outlook's permission to access your `Business Center` invoicing information.

1. Log in to the `Business Center`:  
   [`https://businesscentertest.cybersource.com`](https://businesscentertest.cybersource.com/ebc2/ "")
2. On the left navigation panel, navigate to ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-icon-accnt-mgmt.svg/jcr:content/renditions/original) **Account Management \&gt; Authorized applications**.
3. To revoke permissions, click **Revoke** for Invoicing.  
   If it any time you want to grant Outlook permission to access your invoicing information again, follow the above steps and click **Reconnect** instead of **Revoke**.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-revoke.png/jcr:content/renditions/original)

Sign Out {#invoicing-addin-services-signout-task}
=================================================

Follow these steps to sign out of the Visa Invoicing add-in.

1. Open the Visa Invoicing add-in in your Microsoft Outlook desktop application.
2. Click ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-bttn-default.svg/jcr:content/renditions/original) Tap ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-bttn-options-vertical.svg/jcr:content/renditions/original) Tap ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-bttn-options-vertical.svg/jcr:content/renditions/original) .  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-signout.png/jcr:content/renditions/original)
3. Click **Sign out**.  
   The Sign out window opens.  
   ![](/content/dam/new-documentation/documentation/en-us/topics/payments-processing/payment-services/invoicing/images/invoicing-addin-signout-ok.png/jcr:content/renditions/original)
4. Click **OK**.  
   The Visa Invoicing add-in sign-in page displays.

Webhook Notifications for Invoicing {#invoicing-webhooks-intro}
===============================================================

Webhooks are automated notifications generated by system events that occur in your organization. You can create a webhook subscription for invoicing events to receive a notification when an invoice is:

* Cancelled
* Five-day early reminder
* Fully paid
* Overdue reminder
* Partially paid
* Sent

You must have a URL for the webhook notifications to be sent to.  
Notifications that contain sensitive, personally identifiable information (PII), such as account numbers, are sent using message-level encryption. Transport Layer Security is required in order to ensure data integrity.  
There are additional requirements for implementing webhooks that are not discussed in this guide. To create to webhook subscription to receive invoicing related notifications, see the [*Webhooks Implementation Guide for the REST API*](https://developer.cybersource.com/docs/cybs/en-us/webhooks/implementation/all/rest/webhooks/wh-fg-intro.md "").

Invoicing Product ID and Event Types
------------------------------------

When you send a *create a webhook subscription* request, set the products.productId field to `customerInvoicing` and set the products.eventTypes field to one or more of the values listed in the Event Type Field Value column in the table below. If you include multiple event types in your request, separate each event type field value with the comma character (`,`).

|     Product ID      |             Event Type Field Value             |                                                                  Description                                                                   |
|---------------------|------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------|
| `customerInvoicing` | `invoicing.customer.invoice.cancel`            | Merchants can subscribe to this event type to automate how their system is informed when an invoice is cancelled.                              |
| `customerInvoicing` | `invoicing.customer.invoice.overdue-reminder ` | Notifies you 1 day after the invoice payment is due. This event is triggered if you have invoice reminders enabled in your invoice settings.   |
| `customerInvoicing` | `invoicing.customer.invoice.paid`              | Merchants can subscribe to this event type to automate how their system is informed when an invoice is fully paid.                             |
| `customerInvoicing` | `invoicing.customer.invoice.partial-payment`   | Merchants can subscribe to this event type to automate how their system is informed when an invoice is partially paid.                         |
| `customerInvoicing` | `invoicing.customer.invoice.reminder`          | Notifies you 5 days before the invoice payment is due. This event is triggered if you have invoice reminders enabled in your invoice settings. |
| `customerInvoicing` | `invoicing.customer.invoice.send`              | Merchants can subscribe to this event type to automate how their system is informed when an invoice is sent to the customer.                   |
[Invoicing Webhook Product ID and Event Types]

Example: Creating an Invoice Webhook Subscription {#x-ex-rest}
==============================================================

> IMPORTANT  
> There are additional requirements for implementing webhooks that are not discussed in this guide. To create to webhook subscription to receive invoicing related notifications, see the [*Webhooks Implementation Guide for the REST API*](https://developer.cybersource.com/docs/cybs/en-us/webhooks/implementation/all/rest/webhooks/wh-fg-intro.md "").  
> Only use this example to reference how to format the eventTypes request field and its values.
> Request

```
{
  "name": "Invoicing Webhooks",
  "description": "Webhooks for Invoicing Events",
  "organizationId": "organizationId",
  "productId": "customerInvoicing",
  "eventTypes": [
    "invoicing.customer.invoice.cancel",
    "invoicing.customer.invoice.paid",
    "invoicing.customer.invoice.partial-payment",
    "invoicing.customer.invoice.send"
  ],
  "webhookUrl": "https://test.com:443/test",
  "healthCheckUrl": "https://test.com:443/test",
  "notificationScope": "SELF",
  "retryPolicy": {
    "algorithm": "ARITHMETIC",
    "firstRetry": 1,
    "interval": 1,
    "numberOfRetries": 3,
    "deactivateFlag": "false",
    "repeatSequenceCount": 0,
    "repeatSequenceWaitTime": 0
  },
  "securityPolicy": {
    "securityType": "KEY",
    "proxyType": "external"
  }
}
```

Response to a Successful Request

```
{
  "organizationId": "invoicetest",
  "productId": "customerInvoicing",
  "eventTypes": [
    "invoicing.customer.invoice.cancel",
    "invoicing.customer.invoice.paid",
    "invoicing.customer.invoice.partial-payment",
    "invoicing.customer.invoice.send"
  ],
  "webhookId": "fc880f5a-2145-44db-e053-9e588e0a6a26",
  "name": "Invoicing Webhooks",
  "webhookUrl": "https://test.com:443/test",
  "healthCheckUrl": "https://test.com:443/test",
  "createdOn": "2023-05-25T16:24:51.886Z",
  "status": "INACTIVE",
  "description": "Webhooks for Invoicing Events",
  "retryPolicy": {
    "algorithm": "ARITHMETIC",
    "firstRetry": 1,
    "interval": 1,
    "numberOfRetries": 3,
    "deactivateFlag": false,
    "repeatSequenceCount": 0,
    "repeatSequenceWaitTime": 0
  },
  "securityPolicy": {
    "securityType": "KEY",
    "proxyType": "external",
    "digitalSignatureEnabled": "yes"
  },
  "version": "3",
  "deliveryType": "nrtdCentral",
  "notificationScope": "SELF"
}
```

Manage Invoices Using the `Business Center` {#invoicing-ebc}
============================================================

This section describes how to log in and perform these invoicing tasks in the `Business Center`:

* Enable 3-D secure for your invoices
* Manage your invoices
* Apply fraud management detection to your invoices
* Filter invoice transactions using transaction management
* Generate reports with invoice data
* Create custom fields and messages in an invoice

For additional documentation about how to perform other invoicing tasks in the `Business Center`, choose ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-icon-support.svg/jcr:content/renditions/original) **Support \&gt; Help** on the top right of the `Business Center` home screen.

Logging in to the `Business Center`
-----------------------------------

You can create, send, and manage invoices using the `Business Center`:

* **Test:** [`https://businesscentertest.cybersource.com`](https://businesscentertest.cybersource.com/ebc2/ "")
* **Production:** [`https://businesscenter.cybersource.com`](https://businesscenter.cybersource.com/ebc2/ "")

After logging into the `Business Center`, choose ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-bttn-invoicing.svg/jcr:content/renditions/original) **Invoicing** on the left navigation panel to access the Invoicing menu.

Enabling 3-D Secure for Invoices {#invoicing-3ds}
=================================================

3-D Secure helps to minimize costly fraudulent transactions by adding an extra layer of protection to the payment process.  
Follow these steps to enable 3-D Secure for your invoice transactions. You must have Payer Authentication already enabled for your account. If you do not, or you do not know, contact your Cybersource account representative to enable it.

1. Log in to the `Business Center`:
   * **Test:** [`https://businesscentertest.cybersource.com`](https://businesscentertest.cybersource.com/ebc2/ "")
   * **Production:** [`https://businesscenter.cybersource.com`](https://businesscenter.cybersource.com/ebc2/ "")
     {#invoicing-3ds_step-ebc-login}
     {#invoicing-3ds_step-ebc-login}
2. On the left navigation panel, choose ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-bttn-invoicing.svg/jcr:content/renditions/original) **Invoicing \&gt; Manage Invoices**.  
   The Manage Invoices page appears.
3. Click **Settings**.  
   ![](/content/dam/new-documentation/documentation/en-us/olh/Invoicing/images/invoice-3DS-settings.png/jcr:content/renditions/original)
4. Click the **Security** tab.  
   The 3-D Secure section appears.
5. Choose **Enable**.
6. When done, click **Save**.  
   ![](/content/dam/new-documentation/documentation/en-us/olh/Invoicing/images/invoice-3DS-enable.png/jcr:content/renditions/original)

Fraud Management for Invoices {#invoicing-decision-manager}
===========================================================

This section describes how to use `Decision Manager` to apply fraud detection to invoice transactions.
Follow these steps to create a profile and a corresponding profile selector rule for your invoice transactions.

1. Log in to the `Business Center`:

   * **Test:** [`https://businesscentertest.cybersource.com`](https://businesscentertest.cybersource.com/ebc2/ "")
   * **Production:** [`https://businesscenter.cybersource.com`](https://businesscenter.cybersource.com/ebc2/ "")
2. On the left navigation panel, choose ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-icon-dm.svg/jcr:content/renditions/original) **`Decision Manager` \&gt; Configuration \&gt; Profiles**.  
   The Profiles page appears.

3. In the Order Profiles section, click **ADD EMPTY PROFILE**.  
   The Profile Editor page appears.

4. Enter the relevant information for these sections and their corresponding fields:

   #### ADDITIONAL INFORMATION

   * Profile Definition
   * Queue Selection
   * Fraud Score Threshold Rule Generator  
     ![](/content/dam/new-documentation/documentation/en-us/olh/Invoicing/images/invoice-profile.png/jcr:content/renditions/original)
5. In the Rules section, select only Accept and Reject rules, and enter any relevant information into the **Priority** and **Execution Timing** fields.

6. When done, click **APPLY** . You can click **SAVE** instead if you do not want the new profile to be immediately active.  
   The Profiles page appears.

7. In the Profile Selectors section, click **ADD SELECTOR RULE**.  
   The Rule Definition page appears.

8. In the Rule Definition section, enter this field information:

   |      Field      |                         Definition                         |
   |-----------------|------------------------------------------------------------|
   | **Name**        | The name of the profile selector rule.                     |
   | **Description** | The description that explains the profile selector rule.   |
   | **Profile**     | Choose the profile you created on the Profile Editor page. |
   [Rule Definition Fields and Values]

9. In the Rule Conditions section, choose these options:

   1. Select **All conditions below are true**. By default, it should already be selected.
   2. Set Order Elements to **Connection Method**.
   3. Set Comparison Operator to **is equal to**.
   4. Set Comparison Values to **Custom Value**.
   5. In the Custom Value(s) field, enter Invoicing.  
      ![](/content/dam/new-documentation/documentation/en-us/olh/Invoicing/images/invoice-profile-conditions.png/jcr:content/renditions/original)
10. When done, click **APPLY** . You can click **SAVE** instead if you do not want the new profile selector to be immediately active.  
    ![](/content/dam/new-documentation/documentation/en-us/olh/Invoicing/images/invoice-profile-selector.png/jcr:content/renditions/original)

#### RESULT

The new profile selector now appears as an active selector.

Approving Payment Flagged for Fraud {#invoicing-fraud-review}
=============================================================

This section describes how to approve an invoice payment that is flagged for fraud.  
When the customer completes an invoice payment, this message may display to them: "Success. Your transaction is being processed. We will notify you when it is completed."  
This message indicates that the payment is flagged for fraud. The customer must now wait until you accept or reject the payment using Decision Manager in the `Business Center`. Until you accept or reject the payment, the customer can no longer make the payment. If the customer reloads the payment screen, this message displays: "Information: A payment is pending completion."  
Follow these steps to approve a payment flagged for fraud:

1. Log in to the `Business Center`:
   * **Test:** [`https://businesscentertest.cybersource.com`](https://businesscentertest.cybersource.com/ebc2/ "")
   * **Production:** [`https://businesscenter.cybersource.com`](https://businesscenter.cybersource.com/ebc2/ "")
2. On the left navigation panel choose ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-icon-dm.svg/jcr:content/renditions/original) **Decision Manager \&gt; Case Management \&gt; Cases**.  
   The Case Management page appears.
3. Click the order number of the pending invoice payment.  
   A decision window appears.
4. To approve the flagged invoice payment, click ![](/content/dam/new-documentation/documentation/en-us/common/images/circlecheck-filled.svg/jcr:content/renditions/original) (approve).
5. After reviewing the comments and reason codes, click **ACCEPT**.  
   The settlement information displays.
6. Click **SETTLE**.  
   The payment is now settled.
7. (Optional) You can enable automatic settlement and reversals for accepted and rejected payments. This expedites the review process.
   1. On the left navigation panel, choose ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-icon-dm.svg/jcr:content/renditions/original) **Decision Manager \&gt; Configurations \&gt; Extended Settings**.  
      The Extended Settings page opens.
   2. In the Payment Processing section, use the Description drop-down menu to choose **Enable with Settlement Selected**. This option enables payments that you accept to automatically settle.  
      ![](/content/dam/new-documentation/documentation/en-us/olh/Invoicing/images/invoice-enable-auto-settle.png/jcr:content/renditions/original)

Rejecting Payment Flagged for Fraud {#invoicing-fraud-review-reject}
====================================================================

This section describes how to reject an invoice payment that is flagged for fraud.  
When the customer completes an invoice payment, this message may display to them: "Success. Your transaction is being processed. We will notify you when it is completed."  
This message indicates that the payment is flagged for fraud. The customer must now wait until you accept or reject the payment using Decision Manager in the `Business Center`. Until you accept or reject the payment, the customer can no longer make the payment. If the customer reloads the payment screen, this message displays: "Information: A payment is pending completion."  
Follow these steps to reject a payment flagged for fraud:

1. Log in to the `Business Center`:
   * **Test:** [`https://businesscentertest.cybersource.com`](https://businesscentertest.cybersource.com/ebc2/ "")
   * **Production:** [`https://businesscenter.cybersource.com`](https://businesscenter.cybersource.com/ebc2/ "")
2. On the left navigation panel choose ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-icon-dm.svg/jcr:content/renditions/original) **Decision Manager \&gt; Case Management \&gt; Cases**.  
   The Case Management page appears.
3. Click the order number of the pending invoice payment.  
   A decision window appears.
4. To reject the flagged invoice payment, click ![](/content/dam/new-documentation/documentation/en-us/common/images/circlex-filled.svg/jcr:content/renditions/original) (reject).
5. After reviewing the comments and reason codes, click **Select**.  
   The successful rejection message displays.
6. (Optional) You can enable automatic settlement and reversals for accepted and rejected payments. This expedites the review process, making a seamless review experience.
   1. On the left navigation panel choose ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-icon-dm.svg/jcr:content/renditions/original) **Decision Manager \&gt; Configurations \&gt; Extended Settings**.  
      The Extended Settings page opens.
   2. In the Decision Reject section, use the Description drop-down menu to choose **Enable with authorization reversal selected by default**. This option enables payments that you reject to automatically reverse.  
      ![](/content/dam/new-documentation/documentation/en-us/olh/Invoicing/images/invoice-enable-auto-settle.png/jcr:content/renditions/original)

Filtering Invoice Transactions in Transaction Management {#invoicing-trxn-mgmt-filter}
======================================================================================

This task describes how to view only your invoice transactions by using the filter tool in Transaction Management.

1. Log in to the `Business Center`:
   * **Test:** [`https://businesscentertest.cybersource.com`](https://businesscentertest.cybersource.com/ebc2/ "")
   * **Production:** [`https://businesscenter.cybersource.com`](https://businesscenter.cybersource.com/ebc2/ "")
2. On the left navigation panel, click ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-icon-trxn-mgmt.svg/jcr:content/renditions/original) **Transaction Management** **\&gt;** **Transactions**.  
   The Transaction page appears.
3. Click **Add filter**.  
   The **New Filter** field appears.
4. Click the **New Filter** field and enter Client Application or choose **Client Application** from the drop-down menu.
5. Click the **New Filter** field again and enter Invoicing or choose **Invoicing** from the drop-down menu.
6. When done, click **Search**.  
   The Search Results table displays only your invoice transactions.  
   ![](/content/dam/new-documentation/documentation/en-us/olh/Invoicing/images/invoice-trxn-mgmt-filter.png/jcr:content/renditions/original)
7. (Optional) To verify that the transactions listed in the Search Results table are invoicing transactions, click **Edit columns**.  
   The Edit Table Layout section appears.
8. Click **Add item**.  
   The Add Table Column page appears.
9. In the **Select Table Column** field, enter Client Application or choose **Client Application** from the drop-down menu, and then click **Save**.  
   The Edit Table Layout section appears.
10. Click **Save**.  
    The Search Results table appears with your filtered transactions and the new Client Application column. Each entry in the Client Application column should contain the Invoicing value, indicating that the transaction is an invoice.  
    ![](/content/dam/new-documentation/documentation/en-us/olh/Invoicing/images/invoice-trxn-mgmt-filter-column-1.png/jcr:content/renditions/original)

Generating a Report with Invoice Data {#invoicing-ebc-reports}
==============================================================

This task describes how to use the Reports feature in the `Business Center` to generate a report that contains only your invoicing data.

1. Log in to the `Business Center`:
   * **Test:** [`https://businesscentertest.cybersource.com`](https://businesscentertest.cybersource.com/ebc2/ "")
   * **Production:** [`https://businesscenter.cybersource.com`](https://businesscenter.cybersource.com/ebc2/ "")
2. On the left navigation panel, choose ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-icon-reports.svg/jcr:content/renditions/original) **Reports \&gt; Downloadable Reports \&gt; Available Reports**.  
   The Available Reports page appears.
3. Click the **Create custom report**.  
   The Create Report Subscription page appears.  
   ![](/content/dam/new-documentation/documentation/en-us/olh/Invoicing/images/invoice-report-1.png/jcr:content/renditions/original)
4. In the Advanced Report Features section, click the Connection Method drop-down menu and choose **Invoicing**.  
   There is additional required information you must enter before you can generate a report.  
   ![](/content/dam/new-documentation/documentation/en-us/olh/Invoicing/images/invoice-report-2.png/jcr:content/renditions/original)
5. When done, click **Create**.  
   The Report Subscription Management page appears.  
   Click the **Custom Report Subscriptions** tab to view your new custom report that includes invoicing data.  
   ![](/content/dam/new-documentation/documentation/en-us/olh/Invoicing/images/invoice-report-3.png/jcr:content/renditions/original)

Create a Custom Text Field for an Invoice {#invoicing-mdf-textbox}
==================================================================

You can create a custom text field to display to your customers or merchants on your invoice checkout page. This text field enables users to enter information in the text field, or read a custom message. For example, you can give your customers the option to enter any specifications for their order in the text field. Follow these steps to create a custom text field.

1. Log in to the `Business Center`:

   * **Test:** [`https://businesscentertest.cybersource.com`](https://businesscentertest.cybersource.com/ebc2/ "")
   * **Production:** [`https://businesscenter.cybersource.com`](https://businesscenter.cybersource.com/ebc2/ "")
2. On the left navigation panel, choose ![](/content/dam/new-documentation/documentation/en-us/common/images/ebc/ebc-bttn-invoicing.svg/jcr:content/renditions/original) **Invoicing \&gt; Manage Invoices**.

3. Click the **Custom Fields** tab.  
   The Custom Fields options displays.

4. Click **Text field**.

5. Enter this information in the fields:

   |     Field Name      |                                       Description                                       |
   |---------------------|-----------------------------------------------------------------------------------------|
   | Label               | The title of the new custom text field.                                                 |
   | Min character limit | The minimum number of characters the customer or merchant must enter in the text field. |
   | Max character limit | The maximum number of characters the customer or merchant must enter in the text field. |
   | Default text        | The text that displays by default in the text field.                                    |
   [Text Field Information]

6. Check the **Customer visible** box to make the text field viewable by the customer.  
   You can check the **Customer Read Only** box to prevent the customer from entering text in the text field. Choose this option if you want to display a message to the customer.

7. Click **Add Field** when done.  
   ![](/content/dam/new-documentation/documentation/en-us/olh/Invoicing/images/invoice-mdf-text-field.png/jcr:content/renditions/original)

#### RESULT

The new custom text field is listed under the Custom Fields tab, and its corresponding drop-down menu appears in the invoice preview.  
![](/content/dam/new-documentation/documentation/en-us/olh/Invoicing/images/invoice-mdf-text-field-2.png/jcr:content/renditions/original)

Creating New Custom Report Subscriptions {#create-new-subscription}
===================================================================

A recurring report subscription is a template that describes the attributes of a report, including how often it runs and the period of time it spans. After your recurring report is generated, it is available for download on the [`Available Reports`](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/available_reports.md "") page. You can maintain up to 20 report subscriptions at any time.  
In addition to choosing from [available fields](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/app_fields.md ""), you can customize the following attributes of a recurring subscription:

* **Name**: a unique name for the report. The name cannot be changed after a report is created.
* **Report type**: a set of reports that can be customized. The report type cannot be changed after a report is created.
* **Format**: the format of a generated report (XML or CSV).
* **Frequency**: the frequency at which a report runs: daily, weekly, or monthly.
* **Start time**: the time of day at which a report runs.

The process for creating a report subscription is the same as for creating a one-time report. The steps listed below focus on creating recurring subscriptions.  
To create a report subscription:

1. On the left navigation pane, click the `Reports` icon.

2. Under Downloadable Reports, click `Report Subscription Management`. The `Report Subscription Management` page appears.

3. Click the Custom Report Subscriptions tab. The Custom Reports Subscriptions List appears.

4. Click Create Subscription. The Create Report Subscription page appears.

5. Under Account Setup, select whether to base the report on data from a specific merchant, or a group of merchants, and then choose an available value in the Merchants or Groups list.

   #### ADDITIONAL INFORMATION

   This option is only available for partners and account level users. To create a report that includes all merchants or groups, use the default value.

6. Under Basic Report Setup, enter the following:

   1. In the Report Name field, enter the name for your report that best reflects the data you want to capture. Each report must have a unique name containing up to 250 characters.
   2. In the Report Type field, select the type of report that most closely represents the data or process you want to include. The `Business Center` automatically includes the most commonly used fields in your report based on this selection. See the next step for more information on how to customize these values.
   3. In the File Format field, choose whether the `Business Center` creates the report in XLS or XML format.
   4. In the Frequency field, choose Recurring subscription to automatically generates daily, weekly, or monthly reports. You can also create a [One-time report](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/generate_one-time_report.md "").
7. To change any of the default fields included in your report, click the Arrow icon to expand the Advanced Report Features section, and then perform one or more of the following actions (available actions are based on the services you use):

   | In this field or tab |                                                                                                                                                                                              Do this                                                                                                                                                                                               |
   |----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
   | Credit Amounts       | Check the box if you want credits to appear as negative amounts (for example: -1390.00)                                                                                                                                                                                                                                                                                                            |
   | Naming Convention    | Select how you want the field names to appear in the report: * **SOAPI** displays most field names in camel case (for example: FirstName) * **SCMP** displays most field names with underscores (for example: first_name)                                                                                                                                                                          |
   | Application          | Select one or more types of applications you want to include in the report. Leave blank to include all types.                                                                                                                                                                                                                                                                                      |
   | Connection Method    | Select one or more connection methods used to perform the transaction that you want to include in the report. Leave blank to include all types. Available only for reports that include the Source field.                                                                                                                                                                                          |
   | Payment Channel      | Select one or more payment channels to include in the report. After you make a selection, an information alert lists the [payment report field(s)](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/payment_method_fields.md "") associated with the selected payment channels. Leave blank to include all types.                                         |
   | Field Selection      | One or more of the following: * Enter text matching a field name you want to find in the Search field. * Check the box for one or more fields or field types to include or remove from the report; check the Select All box to add or remove all fields. Click the \^ in a section to expand or collapse it. * In the Selected column, click the X to remove a field or field type from the report |
   | Field Ordering       | To change the field order, click the up and down arrows or select a number in the Order drop-down menu. You can add or remove fields by clicking the plus and minus buttons. This option is only available for CSV output.                                                                                                                                                                         |

8. When you are done, click Create. The Manage Report Subscription page appears, and the new subscription appears in the Custom Reports Subscriptions List.

Downloading Available Reports {#Id1897AE00GE9}
==============================================

The following types of downloadable reports are available in the `Business Center`, depending on your reporting history and usage:

* **Standard Reports**: contains reports based on pre-defined report subscriptions.
* **Custom Reports**: contains reports that the user has created or customized using a pre-defined report.
* **Classic Reports**: contains new reports that have been configured for you based on your legacy subscriptions.
* **Third-Party Reports**: contains any files from a third-party, typically your payment processor.
* **Legacy Reports**: contains an archive of your legacy reports.

A tab may be empty if there are no reports in that category to display.  
Refer to the "Classic Versus Legacy Reports" section in the [Reporting Migration Guide](https://developer.cybersource.com/library/documentation/dev_guides/reporting_and_reconciliation/Reporting_Migration.pdf "") for more information.  
To download available reports:

1. On the left navigation pane, click the `Reports` icon.{#Id1897AE00GE9_avail-reports-step1}
   {#Id1897AE00GE9_avail-reports-step1}
2. Under Downloadable Reports, click `Available Reports`. The `Available Reports` page appears.{#Id1897AE00GE9_avail-reports-step2}
   {#Id1897AE00GE9_avail-reports-step2}
3. Click the tab containing the report you want to download.{#Id1897AE00GE9_avail-reports-step3}
   {#Id1897AE00GE9_avail-reports-step3}
4. In the Download column, click the file format link. Only reports that have successfully finished generating and that contain data include links.{#Id1897AE00GE9_avail-reports-step4}
   {#Id1897AE00GE9_avail-reports-step4}
5. Follow your browser's instructions to open and save the file.{#Id1897AE00GE9_avail-reports-step5}
   {#Id1897AE00GE9_avail-reports-step5}

Generating Custom Reports {#Id189ADC004YK}
==========================================

The `Business Center` enables you to create your own reports based on the type of data you want to track (for example, transaction requests or invoice summaries). When you create a report subscription, the `Business Center` provides a set of fields for you to choose from; you can also add and remove additional fields based on your needs, and choose the order in which they appear and how they display in the report. You can also set how often you want to generate the report (or if you want to just run it once). Successfully generated reports appear in the [`Available Reports`](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/available_reports.md "") section.  
To create a custom report subscription, create a brand [new subscription](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/create.md ""), or [save an existing](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/save_existing_as_new.md "") standard or custom report as a new report.  
Refer to [Application Fields](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/app_fields.md "") for a complete list of fields and descriptions.

Saving Existing Reports as New Subscriptions {#Id1897D090IBI}
=============================================================

You can choose to save any existing custom report as a new one; this enables you to copy over all the existing values, and change as much as you need to create a new report with a new name.  
To create a new report or subscription based on an existing report:

1. On the left navigation pane, click the `Reports` icon.

2. Under Downloadable Reports, click `Report Subscription Management`. The `Report Subscription Management` page appears.

3. Click the Custom Report Subscriptions tab. The Custom Reports Subscriptions List appears.

4. Next to the report you want to copy, click the Save As ( ![](/content/dam/new-documentation/documentation/en-us/olh/Reports/images/saveas.png/jcr:content/renditions/original) ) icon. The Save New Subscription page appears.

5. Under Account Setup, select whether to base the report on data from a specific merchant, or a group of merchants, and then choose an available value in the Merchants or Groups list.

   #### ADDITIONAL INFORMATION

   To create a report that includes all merchants or groups, use the default value.

6. Under Basic Report Setup, enter a unique name for the report.

   #### ADDITIONAL INFORMATION

   All reports must have a unique name.

7. Use the steps in [Creating New Custom Report Subscriptions](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/create.md "") as a guideline for modifying report values.

   #### ADDITIONAL INFORMATION

   > IMPORTANT You must change at least value to save the new report.

8. When you are done, click Save As. The Manage Report Subscription page appears, and the new subscription appears in the Custom Reports Subscriptions List.

Generating One-Time Reports {#Id1897C050M4Y}
============================================

The `Business Center` enables you to create your own reports when your needs don't require an ongoing subscription. A one-time report might be useful when:

* You need information about transactions that happened before you set up your recurring subscription.
* You want to test a report before [setting up a recurring subscription](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/generate_custom_report.md "").
* You need a particular type of information only one time, so a recurring subscription is unnecessary.

When you need past information that spans more than 31 days, you can create multiple one-time reports. In order to protect system performance, each user is able to generate up to three one-time reports concurrently. Additional one-time reports can be scheduled after the first three reports complete.  
After your one-time report is generated, it is available for download on the [`Available Reports`](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/available_reports.md "") page. Depending on the size of the report, it might take longer than 6 hours to generate.  
The process for creating a report subscription is the same as for creating a one-time report. The steps listed below focus on creating a one-time report; to follow steps specifically for creating custom subscriptions, see [Creating New Custom Report Subscriptions](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/create.md "")  
To generate a one-time report:

1. On the left navigation pane, click the `Reports` icon.

2. Under Downloadable Reports, click `Available Reports`. The `Available Reports` page appears.

3. On the Custom Reports tab, click Create Report. The Create Report Subscription page appears.

4. Under Account Setup, select whether to base the report on data from a specific merchant, or a group of merchants, and then choose an available value in the Merchants or Groups list.

   #### ADDITIONAL INFORMATION

   This option is only available for partners and account level users. To create a report that includes all merchants or groups, use the default value.

5. Under Basic Report Setup, enter the following:

   1. In the Report Name field, enter the name for your report that best reflects the data you want to capture. Each report must have a unique name containing up to 250 characters.
   2. In the Report Type field, select the type of report that most closely represents the data or process you want to include. The `Business Center` automatically includes the most commonly used fields in your report based on this selection. See the next step for more information on how to customize these values
   3. In the File Format field, choose whether the `Business Center` creates the report in XLS or XML format.
   4. In the Frequency field, choose One-time report to create a single report covering the date range (and time zone) you choose. You can also select a [Recurring subscription](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/create.md ""). For information about supported time zones, see [Supported Time Zones](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/time-zones.md "").
6. To change any of the default fields included in your report, click the Arrow icon to expand the Advanced Report Features section, and then perform one or more of the following actions (available actions are based on the services you use):

   | In this field or tab |                                                                                                                                                                                              Do this                                                                                                                                                                                              |
   |----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
   | Credit Amounts       | Check the box if you want credits to appear as negative amounts (for example: -1390.00)                                                                                                                                                                                                                                                                                                           |
   | Naming Convention    | Select how you want the field names to appear in the report: * **SOAPI** displays most field names in camel case (for example: FirstName) * **SCMP** displays most field names with underscores (for example: first_name)                                                                                                                                                                         |
   | Application          | Select one or more types of applications you want to include in the report. Leave blank to include all types.                                                                                                                                                                                                                                                                                     |
   | Field Selection      | One or more of the following: * Enter text matching a field name you want to find in the Search field * Check the box for one or more fields or field types to include or remove from the report; check the Select All box to add or remove all fields. Click the \^ in a section to expand or collapse it. * In the Selected column, click the X to remove a field or field type from the report |
   | Field Ordering       | Click and hold the Handle icon to rearrange fields (in the Selected column on the Field Selection tab) into the order in which you want them to appear in the report. This option is only available for CSV output.                                                                                                                                                                               |

7. When you are done, click Create. The Available Reports page appears, and the new report appears in the Custom Reports List.

Application Fields {#Id18ABA0L0CY4}
===================================

Fields in this group prepend the field name with "Application:"

| Field Name | Description                                                          |
|------------|:---------------------------------------------------------------------|
| Name       | Name of application used.                                            |
| Rcode      | One-digit code indicating whether the entire request was successful. |
| Rflag      | One-word description of the result of the entire request.            |
| Rmsg       | Message that explains the \&lt;ics_flag\&gt; value.                  |
| ReasonCode | ---                                                                  |

Appendix: Application Types and ICS Services {#Id18ABA0O0QHS}
=============================================================

|                 Application Type                 | ICS Service                       |
|--------------------------------------------------|:----------------------------------|
| Advanced Fraud Screen                            | ics_score                         |
| Alt Pay Sale                                     | ics_ap_sale                       |
| Credit Card Authorization                        | ics_auth                          |
| Credit Card Auto Full Authorization Reversal     | ics_auto_full_auth_reversal       |
| Credit Card System Authorization                 | ics_auth_refresh                  |
| Decision Manager                                 | ics_decision                      |
| Credit Card Decline                              | ics_decline                       |
| Credit Card Credit                               | ics_credit                        |
| Credit Card Settlement                           | ics_bill                          |
| Electronic Check Authenticate                    | ics_ecp_authenticate              |
| Electronic Check Credit                          | ics_ecp_debit                     |
| Electronic License Issue                         | ics_elc_reissue                   |
| Electronic License Revocation                    | ics_elc_revoke                    |
| FH Notification                                  | ics_notify                        |
| Gift Certificate Creation                        | ics_create_isv                    |
| Gift Certificate History                         | ics_create_history                |
| Gift Certificate Increase                        | ics_add_value_to_isv              |
| Gift Certificate Information                     | ics_get_isv_info                  |
| Gift Certificate Modification                    | ics_modify_isv                    |
| Gift Certificate Policies                        | ics_get_isv_profiles              |
| Gift Certificate Redemption                      | ics_redeem_isv                    |
| IP Geolocation                                   | ics_ipgeo                         |
| Customer List Modification                       | ics_risk_update                   |
| Product Export Verification                      | ics_export                        |
| Shipping Address Verification                    | ics_dav                           |
| Software Download URL                            | ics_download                      |
| Tax Calculation                                  | ics_tax                           |
| V.me Authorization                               | ics_vme_auth                      |
| V.me Payment                                     | ics_vme_bill                      |
| V.me Credit                                      | ics_vme_credit                    |
| V.me Auth Reversal                               | ics_vme_auth_reversal             |
| Denied Parties Check                             | ics_dpc                           |
| Download                                         | ics_get                           |
| SmartCert Download                               | ics_grover                        |
| Bank Transfer                                    | ics_bankxfr                       |
| Certificate Generation                           | ics_certgen                       |
| Rate Check                                       | ics_fxrates                       |
| Hotlist Check                                    | ics_hotlist                       |
| IFS Setup                                        | ics_ifs_setup                     |
| IFS Update                                       | ics_ifs_update                    |
| Payer Authentication Enrollment                  | ics_pa_enroll                     |
| Payer Authentication Validation                  | ics_pa_validate                   |
| Voided Transactions                              | ics_void                          |
| Alt Pay Initiate                                 | ics_ap_initiate                   |
| Alt Pay Service Status                           | ics_ap_check_status               |
| Alt Pay Refund                                   | ics_ap_refund                     |
| Get Checkout Details                             | ics_ap_checkout_details           |
| Get Transaction Details                          | ics_ap_transaction_details        |
| Confirm Purchase                                 | ics_ap_confirm_purchase           |
| Alt Pay Authorization                            | ics_ap_auth                       |
| Alt Pay Authorization Reversal                   | ics_ap_auth_reversal              |
| Alt Pay Capture                                  | ics_ap_capture                    |
| Alt Pay Refund                                   | ics_ap_vme_refund                 |
| Alt Pay Session                                  | ics_ap_sessions                   |
| Alt Pay Order                                    | ics_ap_order                      |
| Alt Pay Billing Agreement                        | ics_ap_billing_agreement          |
| Alt Pay Cancel                                   | ics_ap_cancel                     |
| Alt Pay Options                                  | ics_ap_options                    |
| Service Fee Authorization                        | ics_sfee_auth                     |
| Service Fee Bill                                 | ics_sfee_bill                     |
| Service Fee Calculation                          | ics_service_fee_calculate         |
| Service Fee Electronic Check Debit               | ics_sfee_ecp_debit                |
| Service Fee Authorization Rversal                | ics_sfee_auth_reversal            |
| V.me Europe Authorization                        | ics_auth_vme_eu                   |
| V.me Europe Authorization Reversal               | ics_auth_reversal_vme_eu          |
| Decrypt `Visa Click to Pay` Data                 | ics_decrypt_visa_checkout_data    |
| Apple Pay Authorization                          | ics_auth_apple_pay                |
| Service Fee Authorization                        | ics_service_fee_auth              |
| Service Fee Authorization Reversal               | ics_service_fee_auth_reversal     |
| Service Fee Settlement                           | ics_service_fee_bill              |
| Service Fee Credit Card Credit                   | ics_service_fee_credit            |
| Service Fee eCheck Credit                        | ics_service_fee_ecp_credit        |
| Service Fee eCheck Debit                         | ics_service_fee_ecp_debit         |
| DCC Lookup                                       | ics_dcc                           |
| DCC Update                                       | ics_dcc_update                    |
| Direct Debit                                     | ics_direct_debit                  |
| Direct Debit Refund                              | ics_direct_debit_refund           |
| Direct Debit Mandate                             | ics_direct_debit_mandate          |
| Bank Transfer                                    | ics_bank_transfer                 |
| Bank Transfer Real Time                          | ics_bank_transfer_real_time       |
| Bank Transfer Refund                             | ics_bank_transfer_refund          |
| Subscription Creation                            | ics_pay_subscription_create       |
| Subscription Modification                        | ics_pay_subscription_update       |
| Subscription Delete                              | ics_pay_subscription_delete       |
| PayPal Payment Request                           | ics_paypal_payment                |
| PayPal Credit                                    | ics_paypal_credit                 |
| Direct Debit Validation                          | ics_direct_debit_validate         |
| PIN-less Debit                                   | ics_pinless_debit                 |
| PIN-less Debit Validation                        | ics_pinless_debit_validate        |
| PIN-less Debit Reversal                          | ics_pinless_debit_reversal        |
| PayPal Preapproved Payment                       | ics_paypal_preapproved_payment    |
| PayPal Button Create                             | ics_paypal_button_create          |
| PayPal Preapproved Update                        | ics_paypal_preapproved_update     |
| Subscription Payment Modification                | ics_pay_subscription_event_upd    |
| Subscription Payment Modification                | ics_pay_subscription_event_update |
| Subscription Retrieval                           | ics_pay_subscription_retrieve     |
| PayPal Express Checkout Do Payment               | ics_paypal_ec_do_payment          |
| PayPal Express Checkout Settlement               | ics_paypal_ec_do_capture          |
| PayPal Express Checkout Auth Reversal            | ics_paypal_auth_reversal          |
| PayPal Express Checkout Settlement               | ics_paypal_do_capture             |
| PayPal Express Checkout Set                      | ics_paypal_ec_set                 |
| PayPal Express Checkout Refund                   | ics_paypal_refund                 |
| PayPal Express Checkout Get Details              | ics_paypal_ec_get_details         |
| PayPal Express Checkout Order Setup              | ics_paypal_ec_order_setup         |
| PayPal Express Checkout Authorization            | ics_paypal_authorization          |
| PayPal Express Checkout Billing Agreement Create | ics_paypal_create_agreement       |
| PayPal Express Checkout Billing Agreement Update | ics_paypal_update_agreement       |
| PayPal Express Checkout Do Reference             | ics_paypal_do_ref_transaction     |
| PayPal Settlement                                | paypal_settlement                 |
| PayPal Get Transaction Details                   | ics_paypal_get_txn_details        |
| PayPal Transaction Search                        | ics_paypal_transaction_search     |
| PayPal Payment                                   | paypal_ipn                        |
| China Payment                                    | ics_china_payment                 |
| China Refund                                     | ics_china_refund                  |
| Boleto Payment                                   | ics_boleto_payment                |
| Case Management Action                           | ics_cm_action                     |
| Original Credit Transaction                      | ics_oct                           |
| Timeout OCT Reversal                             | ics_timeout_oct_reversal          |
| Apple Pay Authorization                          | ics_auth\|001                     |
| V.me Authorization                               | ics_ap_auth\|vme                  |
| V.me Authorization Reversal                      | ics_ap_auth_reversal\|vme         |
| V.me Payment                                     | ics_ap_capture\|vme               |
| V.me Refund                                      | ics_ap_refund\|vme                |
| V.me Europe Authorization                        | ics_auth\|vmeeu                   |
| V.me Europe Authorization Reversal               | ics_auth_reversal\|vmeeu          |
| Decision Manager Events                          | ics_dm_event                      |
| Timeout Auth Reversal                            | ics_timeout_auth_reversal         |
| PayPal Billing Agreement                         | paypal_mip_agreement_ipn          |
| Subscription Creation Duplicates                 | ics_pay_subscription_create_dup   |
| Acquirer Risk Controls                           | ics_arc                           |
| Android Pay Authorization                        | ics_auth\|006                     |
| Chase Pay Authorization                          | ics_auth\|007                     |
| Samsung Pay Authorization                        | ics_auth\|008                     |
| Recurring Payment                                | ics_recurring_payment             |
| Automatic Authorization Reversal                 | ics_auto_auth_reversal            |
| Get `Visa Click to Pay` Data                     | ics_get_visa_checkout_data        |
| Get Masterpass Data                              | ics_get_masterpass_data           |
| PIN Debit Purchase                               | ics_pin_debit_purchase            |
| PIN Debit Credit                                 | ics_pin_debit_credit              |
| PIN Debit Reversal                               | ics_pin_debit_reversal            |
| PIN Debit Timeout Reversal                       | ics_timeout_pin_debit_reversal    |

Payment Method Fields {#Id18ABF0S0PY4}
======================================

Fields in this group prepend the field name with "PaymentMethod:"

| Field Name                     | Description                                                                                                                                                          |
|:-------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| AccountSuffix                  | Last four digits of the customer's payment account number.                                                                                                           |
| PaymentMethod. BankAccountName | Bank's account name.                                                                                                                                                 |
| PaymentMethod.BankCode         | Bank's code. Used for some countries when you are not using the IBAN. Contact `Cybersource` customer support for required country-specific bank account information. |
| BoletoBarCodeNumber            | Numeric representation of the boleto barcode.                                                                                                                        |
| BoletoNumber                   | Boleto Bancário payment number.                                                                                                                                      |
| CardCategory                   | Type of card used.                                                                                                                                                   |
| CardCategoryCode               | Code for card type used.                                                                                                                                             |
| CardType                       | Type of card to authorize.                                                                                                                                           |
| CheckNumber                    | Check number.                                                                                                                                                        |
| ExpirationMonth                | Two-digit month in which the credit card expires.                                                                                                                    |
| ExpirationYear                 | Four-digit year in which the credit card expires.                                                                                                                    |
| IssueNumber                    | Number of times a Maestro (UK Domestic) card has been issued to the account holder.                                                                                  |
| MandateId                      | Identification reference for the direct debit mandate.                                                                                                               |
| MandateType                    | Type of mandate.                                                                                                                                                     |
| SignatureDate                  | Date of signature.                                                                                                                                                   |
| StartMonth                     | Month of the start of the Maestro (UK Domestic) card validity period.                                                                                                |
| StartYear                      | Year of the start of the Maestro (UK Domestic) card validity period.                                                                                                 |
| WalletType                     | Type of wallet.                                                                                                                                                      |

Supported Time Zones {#time-zones}
==================================

This table lists the supported values for specifying a time zone. When using the `Business Center`, select the applicable time zone from the values listed in the `Business Center` column. When sending an API request, set the field to a value listed in the API column.

| `Business Center`                                                    | API                     |
|:---------------------------------------------------------------------|:------------------------|
| Africa/Cairo - (GMT+02:00) Eastern European Time                     | `Africa/Cairo`          |
| Africa/Johannesburg - (GMT+02:00) South Africa Standard Time         | `Africa/Johannesburg`   |
| Africa/Tripoli - (GMT+02:00) Eastern European Time                   | `Africa/Tripoli`        |
| Africa/Tunis - (GMT+01:00) Central European Time                     | `Africa/Tunis`          |
| America/Anchorage - (GMT-09:00) Alaska Standard Time                 | `America/Anchorage`     |
| America/Bogota - (GMT-05:00) Colombia Time                           | `America/Bogota`        |
| America/Buenos_Aires - (GMT-03:00) Argentine Time                    | `America/Buenos_Aires`  |
| America/Chicago - (GMT-06:00) Central Standard Time                  | `America/Chicago`       |
| America/Denver - (GMT-07:00) Mountain Standard Time                  | `America/Denver`        |
| America/Edmonton - (GMT-07:00) Mountain Standard Time                | `America/Edmonton`      |
| America/Godthab - (GMT-03:00) Western Greenland Time                 | `America/Godthab`       |
| America/Halifax - (GMT-04:00) Atlantic Standard Time                 | `America/Halifax`       |
| America/Indianapolis - (GMT-05:00) Eastern Standard Time             | `America/Indianapolis`  |
| America/La_Paz - (GMT-04:00) Bolivia Time                            | `America/La_Paz`        |
| America/Los_Angeles - (GMT-08:00) Pacific Standard Time              | `America/Los_Angeles`   |
| America/Mexico_City - (GMT-06:00) Central Standard Time              | `America/Mexico_City`   |
| America/New_York - (GMT-05:00) Eastern Standard Time                 | `America/New_York`      |
| America/Noronha - (GMT-02:00) Fernando de Noronha Time               | `America/Noronha`       |
| America/Phoenix - (GMT-07:00) Mountain Standard Time                 | `America/Phoenix`       |
| America/Sao_Paulo - (GMT-03:00) Brasilia Time                        | `America/Sao_Paulo`     |
| America/St_Johns - (GMT-03:30) Newfoundland Standard Time            | `America/St_Johns`      |
| America/Vancouver - (GMT-08:00) Pacific Standard Time                | `America/Vancouver`     |
| America/Winnipeg - (GMT-06:00) Central Standard Time                 | `America/Winnipeg`      |
| Asia/Baku - (GMT+04:00) Azerbaijan Time                              | `Asia/Baku`             |
| Asia/Bangkok - (GMT+07:00) Indochina Time                            | `Asia/Bangkok`          |
| Asia/Calcutta - (GMT+05:30) India Standard Time                      | `Asia/Calcutta`         |
| Asia/Dacca - (GMT+06:00) Bangladesh Time                             | `Asia/Dacca`            |
| Asia/Dubai - (GMT+04:00) Gulf Standard Time                          | `Asia/Dubai`            |
| Asia/Hong_Kong - (GMT+08:00) Hong Kong Time                          | `Asia/Hong_Kong`        |
| Asia/Jakarta - (GMT+07:00) West Indonesia Time                       | `Asia/Jakarta`          |
| Asia/Jerusalem - (GMT+02:00) Israel Standard Time                    | `Asia/Jerusalem`        |
| Asia/Katmandu - (GMT+05:45) Nepal Time                               | `Asia/Katmandu`         |
| Asia/Kuala_Lumpur - (GMT+08:00) Malaysia Time                        | `Asia/Kuala_Lumpur`     |
| Asia/Macao - (GMT+08:00) China Standard Time                         | `Asia/Macao`            |
| Asia/Magadan - (GMT+11:00) Magadan Time                              | `Asia/Magadan`          |
| Asia/Manila - (GMT+08:00) Philippines Time                           | `Asia/Manila`           |
| Asia/Rangoon - (GMT +06:30) Myanmar Standard Time                    | `Asia/Rangoon`          |
| Asia/Riyadh - (GMT+03:00) Arabia Standard Time                       | `Asia/Riyadh`           |
| Asia/Saigon - (GMT+07:00) Indochina Time                             | `Asia/Saigon`           |
| Asia/Seoul - (GMT+09:00) Korea Standard Time                         | `Asia/Seoul`            |
| Asia/Shanghai - (GMT+08:00) China Standard Time                      | `Asia/Shanghai`         |
| Asia/Singapore - (GMT+08:00) Singapore Time                          | `Asia/Singapore`        |
| Asia/Taipei - (GMT+08:00) China Standard Time                        | `Asia/Taipei`           |
| Asia/Tbilisi - (GMT+04:00) Georgia Time                              | `Asia/Tbilisi`          |
| Asia/Tokyo - (GMT+09:00) Japan Standard Time                         | `Asia/Tokyo`            |
| Asia/Yakutsk - (GMT+09:00) Yakutsk Time                              | `Asia/Yakutsk`          |
| Atlantic/Cape_Verde - (GMT-01:00) Cape Verde Time                    | `Atlantic/Cape_Verde`   |
| Australia/Adelaide - (GMT+09:30) Australian Central Standard Time    | `Australia/Adelaide`    |
| Australia/Brisbane - (GMT+10:00) Australian Eastern Standard Time    | `Australia/Brisbane`    |
| Australia/Broken_Hill - (GMT+09:30) Australian Central Standard Time | `Australia/Broken_Hill` |
| Australia/Darwin - (GMT+09:30) Australian Central Standard Time      | `Australia/Darwin`      |
| Australia/Eucla - (GMT+08:45) Australian Western Standard Time       | `Australia/Eucla`       |
| Australia/Hobart - (GMT+10:00) Australian Eastern Standard Time      | `Australia/Hobart`      |
| Australia/Lindeman - (GMT+10:00) Australian Eastern Standard Time    | `Australia/Lindeman`    |
| Australia/Lord_Howe - (GMT+10:30) Lord Howe Standard Time            | `Australia/Lord_Howe`   |
| Australia/Melbourne - (GMT+10:00) Australian Eastern Standard Time   | `Australia/Melbourne`   |
| Australia/Perth - (GMT+08:00) Australian Western Standard Time       | `Australia/Perth`       |
| Australia/Sydney - (GMT+10:00) Australian Eastern Standard Time      | `Australia/Sydney`      |
| Europe/Amsterdam - (GMT+01:00) Central European Time                 | `Europe/Amsterdam`      |
| Europe/Athens - (GMT+02:00) Eastern European Time                    | `Europe/Athens`         |
| Europe/Belgrade - (GMT+01:00) Central European Time                  | `Europe/Belgrade`       |
| Europe/Berlin - (GMT+01:00) Central European Time                    | `Europe/Berlin`         |
| Europe/Brussels - (GMT+01:00) Central European Time                  | `Europe/Brussels`       |
| Europe/Bucharest - (GMT+02:00) Eastern European Time                 | `Europe/Bucharest`      |
| Europe/Budapest - (GMT+01:00) Central European Time                  | `Europe/Budapest`       |
| Europe/Copenhagen - (GMT+01:00) Central European Time                | `Europe/Copenhagen`     |
| Europe/Dublin - (GMT+00:00) Greenwich Mean Time                      | `Europe/Dublin`         |
| Europe/Helsinki - (GMT+02:00) Eastern European Time                  | `Europe/Helsinki`       |
| Europe/Istanbul - (GMT+02:00) Eastern European Time                  | `Europe/Istanbul`       |
| Europe/Lisbon - (GMT+00:00) Western European Time                    | `Europe/Lisbon`         |
| Europe/London - (GMT+00:00) Greenwich Mean Time                      | `Europe/London`         |
| Europe/Madrid - (GMT+01:00) Central European Time                    | `Europe/Madrid`         |
| Europe/Malta - (GMT+01:00) Central European Time                     | `Europe/Malta`          |
| Europe/Minsk - (GMT+03:00) Moscow Standard Time                      | `Europe/Minsk`          |
| Europe/Monaco - (GMT+01:00) Central European Time                    | `Europe/Monaco`         |
| Europe/Moscow - (GMT+03:00) Moscow Standard Time                     | `Europe/Moscow`         |
| Europe/Oslo - (GMT+01:00) Central European Time                      | `Europe/Oslo`           |
| Europe/Paris - (GMT+01:00) Central European Time                     | `Europe/Paris`          |
| Europe/Prague - (GMT+01:00) Central European Time                    | `Europe/Prague`         |
| Europe/Riga - (GMT+02:00) Eastern European Time                      | `Europe/Riga`           |
| Europe/Rome - (GMT+01:00) Central European Time                      | `Europe/Rome`           |
| Europe/Stockholm - (GMT+01:00) Central European Time                 | `Europe/Stockholm`      |
| Europe/Vienna - (GMT+01:00) Central European Time                    | `Europe/Vienna`         |
| Europe/Warsaw - (GMT+01:00) Central European Time                    | `Europe/Warsaw`         |
| Europe/Zurich - (GMT+01:00) Central European Time                    | `Europe/Zurich`         |
| GMT - (GMT+00:00) Greenwich Mean Time                                | `GMT`                   |
| Pacific/Auckland - (GMT+12:00) New Zealand Standard Time             | `Pacific/Auckland`      |
| Pacific/Honolulu - (GMT-10:00) Hawaii Standard Time                  | `Pacific/Honolulu`      |
| Pacific/Norfolk - (GMT+11:00) Norfolk Time                           | `Pacific/Norfolk`       |
| Pacific/Pago_Pago - (GMT-11:00) Samoa Standard Time                  | `Pacific/Pago_Pag`      |
[Time Zones]

Creating New Custom Report Subscriptions {#create}
==================================================

A recurring report subscription is a template that describes the attributes of a report, including how often it runs and the period of time it spans. After your recurring report is generated, it is available for download on the [`Available Reports`](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/available_reports.md "") page. You can maintain up to 20 report subscriptions at any time.  
In addition to choosing from [available fields](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/app_fields.md ""), you can customize the following attributes of a recurring subscription:

* **Name**: a unique name for the report. The name cannot be changed after a report is created.
* **Report type**: a set of reports that can be customized. The report type cannot be changed after a report is created.
* **Format**: the format of a generated report (XML or CSV).
* **Frequency**: the frequency at which a report runs: daily, weekly, or monthly.
* **Start time**: the time of day at which a report runs.

The process for creating a report subscription is the same as for creating a one-time report. The steps listed below focus on creating recurring subscriptions.  
To create a report subscription:

1. On the left navigation pane, click the `Reports` icon.

2. Under Downloadable Reports, click `Report Subscription Management`. The `Report Subscription Management` page appears.

3. Click the Custom Report Subscriptions tab. The Custom Reports Subscriptions List appears.

4. Click Create Subscription. The Create Report Subscription page appears.

5. Under Account Setup, select whether to base the report on data from a specific merchant, or a group of merchants, and then choose an available value in the Merchants or Groups list.

   #### ADDITIONAL INFORMATION

   This option is only available for partners and account level users. To create a report that includes all merchants or groups, use the default value.

6. Under Basic Report Setup, enter the following:

   1. In the Report Name field, enter the name for your report that best reflects the data you want to capture. Each report must have a unique name containing up to 250 characters.
   2. In the Report Type field, select the type of report that most closely represents the data or process you want to include. The `Business Center` automatically includes the most commonly used fields in your report based on this selection. See the next step for more information on how to customize these values.
   3. In the File Format field, choose whether the `Business Center` creates the report in XLS or XML format.
   4. In the Frequency field, choose Recurring subscription to automatically generates daily, weekly, or monthly reports. You can also create a [One-time report](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/generate_one-time_report.md "").
7. To change any of the default fields included in your report, click the Arrow ( ![](/content/dam/new-documentation/documentation/en-us/olh/Reports/images/arrow.png/jcr:content/renditions/original) ) icon to expand the Advanced Report Features section, and then perform one or more of the following actions (available actions are based on the services you use):

   1. In the Credit Amounts field, check the box if you want credits to appear as negative amounts (for example: -1390.00)
   2. In the Naming Convention field, select how you want the field names to appear in the report: **SOAPI** displays most field names in camel case (for example: FirstName); **SCMP** displays most field names with underscores (for example: first_name).
   3. In the Application field, select one or more [types of applications](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/invoicing/developer/all/rest/invoicing/app_types_services.md "") you want to include in the report. Leave blank to include all types.
   4. In the Field Selection field, enter text matching a field name you want to find in the Search field, check the box for one or more fields or field types to include or remove from the report; check the Select All box to add or remove all fields. (Click the **\^** in a section to expand or collapse it.); and/or in the Selected column, click the **X** to remove a field or field type from the report
   5. In the Field Ordering field, click and hold the Handle icon to rearrange fields (in the Selected column on the Field Selection tab) into the order in which you want them to appear in the report
8. When you are done, click Create. The Manage Report Subscription page appears, and the new subscription appears in the Custom Reports Subscriptions List.

