---
title: "Create invoice payment settings"
method: POST
path: "/payments/settings/invoices"
tags: ["Invoices"]
---

# Create invoice payment settings

`POST /payments/settings/invoices`

Create payment settings for invoices. Invoices with payment settings contain payment links. If payment details are on file with Stripe or other payment providers, then payments are automatically collected when you finalise and send an invoice. Invoice payment settings override billing schedule payment settings and customer payment settings.

## Headers

- `Authorization` string, required
- `Sequence-Version` '2024-07-30'

## Request body

- CreateInvoiceSettingsEndpointCreateInvoiceSettingsRequestModel
  - `invoiceId` string, required — Invoice ID.
  - `customerId` string, nullable — Customer ID.
  - `paymentProvider` 'STRIPE' | 'GOCARDLESS' | 'NONE', required

## Response `201`

Created

- CreateInvoiceSettingsEndpointProductCreateInvoiceSettingsResponseModel
  - `id` string, required — Unique payment provider id.
  - `sequenceAccountId` string, required — Sequence Account ID.
  - `invoiceId` string, required — Invoice ID.
  - `customerId` string, required — Customer ID.
  - `paymentProvider` 'STRIPE' | 'GOCARDLESS' | 'NONE', required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/sequencehq/apis/sequence.md) · [All operations](https://skmtc.net/sequencehq/apis/sequence/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sequencehq/sequence/versions/cae64b02699f/schema)