# Retrieves a merchant's invoice settings

<a id="flute-v1-get-pay-int-api-merchants-merchantId-invoices-settings"></a>
<span class="api-endpoint">GET {{<a href="#urlbases">baseURL</a>}}/pay-int-api/merchants/{{merchantId}}/invoices/settings</span>
This endpoint retrieves the specified merchant's invoice settings.
These settings control how invoices behave for that merchant.
This includes:
* whether line item prices can be overwritten
* whether shipping fees, taxes, and discounts are enabled
* which payment methods are accepted
* how many days after issue an invoice becomes due

This is a read-only lookup, so no request body is needed.
It is intended for confirming a merchant's current configuration before attempting operations that depend on it.
For example, such as overriding a line item's unit price on an invoice.
<span class="api-seealso">See Also:</span><br>
To update a merchant's invoice settings, see <a href="/api-reference/invoices-settings/flute-v1-put-pay-int-api-merchants-merchantid-invoices-settings" style="text-decoration: underline;">PUT /pay-int-api/merchants/{merchantId}/invoices/settings</a>.<br>

Endpoint: GET /pay-int-api/merchants/{merchantId}/invoices/settings
Version: V1
Security: Bearer

## Path parameters:

  - `merchantId` (string, required)
    Specifies the identifier of the merchant.

## Header parameters:

  - `x-api-version` (string)
    Specifies the API version to use for the request.

Example: 1.0

## Response 200 fields (application/json):

  - `merchantId` (string)
    Indicates the identifier of the merchant.

Example: 46063d32-10fa-44cb-b118-20ddd085ce3f
    Example: 46063d32-10fa-44cb-b118-20ddd085ce3f

  - `dueDateAfterDays` (integer)
    Indicates the number of days after issuance that an invoice is due.

Example: 30
    Example: 30

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

  - `isDiscountEnabled` (boolean)
    Indicates the discount is enabled.
If `true`, the discount is enabled.
If `false`, the discount is not enabled.
Example: true
    Example: true

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

  - `isShippingFeeEnabled` (boolean)
    Indicates the shipping fee is enabled.
If `true`, the shipping fee is enabled.
If `false`, the shipping fee is not enabled.
Example: true
    Example: true

  - `shippingFeeAmount` (number)
    Indicates the shipping fee amount.

Example: 5.00
    Example: 5

  - `isFeesEnabled` (boolean)
    Specifies fees are enabled.
If `true`, fees are enabled.
If `false`, fees are not enabled.
Example: true
    Example: true

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

  - `notes` (string)
    Indicates default notes shown on an invoice.

Example: Thank you for your business.
    Example: Thank you for your business.

  - `paymentMethodTypeId` (integer)
    Indicates the payment method type identifier.
Value values:
| Id | Name |
|  --- | --- |
| 1 | Card (for credit card) |
| 2 | ElectronicCheck |

Example: 2
    Example: 2

  - `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

  - `allowStaffToSetDiscountAndLineItemDiscount` (boolean)
    Indicates staff members are allowed to set a discount and line item discount.
If `true`, staff can set a discount and a line item discount.
If `false`, staff cannot set a discount or a line item discount.
Example: true
    Example: true

  - `allowManuallyEnterLineItems` (boolean)
    For internal use only.

Do not use.

  - `isSmsNotificationAfterPaymentEnabled` (boolean)
    Indicates an SMS notification is sent to the customer after a successful payment.
If `true`, an SMS notification is sent after payment succeeds.
If `false`, no SMS notification is sent after payment succeeds.
Example: true
    Example: true

  - `isSmsNotificationAfterPaymentFailedEnabled` (boolean)
    Indicates an SMS notification is sent to the customer after a failed payment.
If `true`, an SMS notification is sent after payment fails.
If `false`, no SMS notification is sent after payment fails.
Example: true
    Example: true

  - `canOverWriteInvoiceLineItemPrice` (boolean)
    Indicates a line item's unit price can be overwritten on an invoice.
If `true`, a line item's `unitPrice` can be overwritten from its catalog price.
If `false`, a line item's `unitPrice` must match its catalog price and cannot be overwritten.
Example: true
    Example: true

  - `newZcpFeatureEnabled` (boolean)
    Indicates the new ZCP (zero cost processing) feature is enabled.
If `true`, the new ZCP feature is enabled.
If `false`, the new ZCP feature is not enabled.
Example: true
    Example: true

## Response 403 fields (application/json):

  - `details` (string)
    Indicates details about the error.
Example: Forbidden to access Id 'f6a7b8c9-d0e1-4f2a-3b4c-5d6e7f8a9b25' with type='(Service).DataAccess.Entities.(Model)Entity'
    Example: Forbidden to access Id 'f6a7b8c9-d0e1-4f2a-3b4c-5d6e7f8a9b25' with type='(Service).DataAccess.Entities.(Model)Entity'

  - `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: Exceptions.ForbiddenException
    Example: Exceptions.ForbiddenException

  - `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)
    Indicates details about the error.

Example: Entity with ID 'aa6cfcd0-0295-4a4c-b074-8c901f114fef' was not found.
    Example: Entity with ID 'aa6cfcd0-0295-4a4c-b074-8c901f114fef' was not found.

  - `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: FluteOpsDeveloper.MSG322
    Example: FluteOpsDeveloper.MSG322

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

Example: System.Collections.Generic.KeyNotFoundException
    Example: System.Collections.Generic.KeyNotFoundException

  - `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