# Creates an invoice

<span class="api-endpoint">POST {{<a href="#urlbases">baseURL</a>}}/pay-int-api/invoices</span>
This endpoint creates an invoice.

Endpoint: POST /pay-int-api/invoices
Version: V1
Security: Bearer

## Header parameters:

  - `x-api-version` (string)

## Request fields (application/json):

  - `dueDate` (string)
    Specifies the date-time (in an ISO 8601 date-time UTC format) the invoice is due.

Examples:2026-02-19T20:24:52.934Z
    Example: 2026-02-19T20:24:52.934Z

  - `cardPaymentProcessorId` (string)
    Specifies an identifier for the credit card payment processor handling a card transaction.

Example: 78723ff2-d47e-460b-b838-d602bdf0e1bc
    Example: 78723ff2-d47e-460b-b838-d602bdf0e1bc

  - `achPaymentProcessorId` (string)
    Specifies an identifier for the automated clearing house (ACH) payment processor handling a transaction.

Example: 9925a0b0-eb18-4d74-8967-7e0cf6af0729
    Example: 9925a0b0-eb18-4d74-8967-7e0cf6af0729

  - `additionalNotes` (string)
    Specifies additional notes or comments.

Example: Extension permitted for 30 days.
    Example: Extension permitted for 30 days.

  - `shippingAmount` (number)
    Specifies the shipping amount (in USD).

Example: 129.99
    Example: 129.99

  - `taxPercentage` (number)
    Specifies the tax percentage.
Example: 8.50 (as 8.50%)
    Example: 8.5

  - `feesPercentage` (number)
    Specifies the fees percentage.
Example: 10.25 (as 10.25%)
    Example: 10.25

  - `discountPercentage` (number)
    Specifies the discount percentage.
Example: 1.5 (as 1.5%)
    Example: 1.5

  - `merchantContactInfoId` (string)
    Indicates the merchant’s stored contact information record used on invoices and payment flows.
Example: bdf4b5c6-7d8e-4f9a-0b1c-2d3e4f5a6b92
    Example: bdf4b5c6-7d8e-4f9a-0b1c-2d3e4f5a6b92

  - `customerId` (string)
    Specifies the customer identifier.
This is used when saving the payment method.
If this value is provided, the payment method is saved to the specified customer.
If this value is not provided, a new customer record is created.
Example: fd9198a4-eb6f-4620-9603-4f4638289de5
    Example: fd9198a4-eb6f-4620-9603-4f4638289de5

  - `achAllowFasterProcessing` (boolean)

  - `customer` (object)

  - `customer.firstName` (string)
    Indicates the customer's first name.

Example: Alexandro
    Example: Alexandro

  - `customer.lastName` (string)
    Indicates the customer's last name.

Example: Peppared
    Example: Peppared

  - `customer.companyName` (string)
    Indicates the name of the customer's company or organization.

Example: Peppared Street Cafe
    Example: Peppared Street Cafe

  - `customer.email` (string)
    Indicates the customer's email.
Example: peppared@example.com
    Example: peppared@example.com

  - `customer.mobilePhoneNumber` (string)
    Indicates the customer's mobile phone number.
Example: +14155552309
    Example: +14155552309

  - `customer.isMobileNumberSmsNotificationsEnabled` (boolean)
    Indicates the customer's SMS notification is enabled.
If `true`, the customer's SMS notification is enabled.
If `false`, the customer's SMS notification is not enabled.
If missing or omitted, the information is not available.
Example: true

  - `customer.useBillingAsShippingAddress` (boolean)
    Indicates to use the billing address as the shipping address.
If `true`, use the billing address as the shipping address.
If `false`, do not use the billing address as the shipping address.
Instead, use the field `shippingAddress`.
Example: true
    Example: true

  - `customer.billingAddress` (object)

  - `customer.billingAddress.line1` (string)
    Indicates the street address.

Example: 21 E. Main Street
    Example: 21 E. Main Street

  - `customer.billingAddress.line2` (string)
    Indicates additional street address information.

Example: Apt. Block 6
    Example: Apt. Block 6

  - `customer.billingAddress.city` (string)
    Identifies the name of the city.

Example: Chicago
    Example: Chicago

  - `customer.billingAddress.zip` (string)
    Indicates the postal or ZIP code.
Examples:
60612
60612-0001
    Example: 60612

  - `customer.billingAddress.countryId` (integer)
    Specifies the Flute country identifier.
Example: 1
    Example: 1

  - `customer.billingAddress.stateId` (integer)
    Specifies the Flute US state or territory identifier code.
Example: 1
    Example: 1

  - `customer.billingAddress.stateName` (string)
    Indicates the full state name.
Examples:
Texas
Washington
Illinois
    Example: Illinois

  - `lineItems` (array)

  - `lineItems.id` (string)
    Indicates the identifier of the item.

Example: d0f6d7e8-9f0a-4b1c-2d3e-4f5a6b7c8d14
    Example: d0f6d7e8-9f0a-4b1c-2d3e-4f5a6b7c8d14

  - `lineItems.lineItemId` (string)
    Indicates the identifier of the line item.

Example: 7c9e6679-7425-40de-944b-e07fc1f90ae7
    Example: 7c9e6679-7425-40de-944b-e07fc1f90ae7

  - `lineItems.unitTypeId` (integer)
    Indicates the identifier of the unit type.

This is a numeric identifier represents the unit of measure for the item.
Each supplier provides their own lookup value.
That value maps to a predefined unit type in their system.

Example: 1
    Example: 1

  - `lineItems.productName` (string)
    Indicates the name of the item.

Example: RollerMouse Wireless Mouse
    Example: RollerMouse Wireless Mouse

  - `lineItems.description` (string)
    Indicates a description of the item.

Example: RollerMouse Design Collection, Limited Edition Wireless Mouse
    Example: RollerMouse Design Collection, Limited Edition Wireless Mouse

  - `lineItems.sku` (string)
    Indicates the product identifier item.

Example: 24474771
    Example: 24474771

  - `lineItems.unitPrice` (number)
    Indicates the unit price of the item.

Example: 18.99
    Example: 18.99

  - `lineItems.quantity` (number)
    Indicates the quantity, or number, of the items

Example: 10
    Example: 10

  - `lineItems.discountPercentage` (number)
    Indicates the discount percentage.
Example: 1.5 (as 1.5%)
    Example: 1.5

  - `lineItems.totalAmount` (number)
    Specifies the transaction's total amount. 

This includes the base amount, tips, taxes, shipping, discounts, and other charges.

Example: 3219.45
    Example: 3219.45

  - `canPriceBeForceOverrided` (boolean)

## Response 200 fields (application/json):

  - `id` (string)
    Indicates the invoice identifier.

Example: cef5c6d7-8e9f-4a0b-1c2d-3e4f5a6b7c03
    Example: cef5c6d7-8e9f-4a0b-1c2d-3e4f5a6b7c03

## Response 400 fields (application/json):

  - `details` (string)
    Indicates details about the error.

Example: Validation failed: -- Email: 'Email' is not a valid email address. Severity: Error
    Example: Validation failed: -- Email: 'Email' is not a valid email address. Severity: Error

  - `statusCode` (integer)
    Specifies the HTTP response status code.
This is the HTTP status code returned by the attempted delivery.
The following is a list of HTTP response status codes that include but are not limited to:
| HTTP Status | Meaning |
|  --- | --- |
| 200 | Delivery succeeded |
| 400 | Bad request |
| 401 | Unauthorized |
| 404 | Endpoint not found |
| 429 | Rate limited |

Example: 401
    Example: 401

  - `source` (string)
    Indicates the source of the error.
Example: <Service>
    Example: <Service>

  - `exceptionType` (string)
    Indicates the error's exception type.

Example: FluentValidation.ValidationException
    Example: FluentValidation.ValidationException

  - `correlationId` (string)
    Indicates the correlation identifier.

Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef
    Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef

  - `entityId` (string)
    Indicates the entity identifier.
Example:
null

  - `errorCode` (string)
    Indicates the error code.
Example:
null

## Response 404 fields (application/json):

  - `details` (string)

  - `statusCode` (integer)
    Specifies the HTTP response status code.
This is the HTTP status code returned by the attempted delivery.
The following is a list of HTTP response status codes that include but are not limited to:
| HTTP Status | Meaning |
|  --- | --- |
| 200 | Delivery succeeded |
| 400 | Bad request |
| 401 | Unauthorized |
| 404 | Endpoint not found |
| 429 | Rate limited |

Example: 401
    Example: 401

  - `source` (string)

  - `exceptionType` (string)

  - `correlationId` (string)

  - `entityId` (string)

  - `errorCode` (string)

## Response 500 fields (application/json):

  - `details` (string)

  - `statusCode` (integer)
    Specifies the HTTP response status code.
This is the HTTP status code returned by the attempted delivery.
The following is a list of HTTP response status codes that include but are not limited to:
| HTTP Status | Meaning |
|  --- | --- |
| 200 | Delivery succeeded |
| 400 | Bad request |
| 401 | Unauthorized |
| 404 | Endpoint not found |
| 429 | Rate limited |

Example: 401
    Example: 401

  - `source` (string)

  - `exceptionType` (string)

  - `correlationId` (string)

  - `entityId` (string)

  - `errorCode` (string)