Mark a supplier invoice as paid

OAuth scope: supplier_invoice.write

Marks a supplier invoice as paid for operational and accounting alignment. This is not proof that a payment was executed or settled through Qonto.

The resulting paid status and payment_date simply record that you consider the invoice settled, e.g. paid outside Qonto (wire from another bank, cash, etc.) or adjusted for internal bookkeeping.

Eligible statuses: to_review, to_approve, pending, awaiting_payment, to_pay, paid, and archived. Invoices in scheduled cannot use this endpoint (forbidden transition). On success, status is paid. Any other status returns 400 Bad Request (invalid transition).

Idempotency and retries: There is no separate idempotency key; the outcome depends on the invoice’s current status. If the invoice is already paid, another call still returns 200 without producing side effects. For other statuses, 400 could mean that the transition is not allowed, so refresh with GET before retrying.

POST /v2/supplier_invoices/{id}/mark_as_paid

Mark a supplier invoice as paid

cURL

curl --request POST \
  --url https://thirdparty.qonto.com/v2/supplier_invoices/{id}/mark_as_paid \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "supplier_invoice": {
    "payment_date": "2026-01-01"
  }
}
'

200

Example

{ "id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48", "is_einvoice": false, "has_discrepancies": false, "organization_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48", "file_name": "my-invoice.pdf", "status": "to_review", "source_type": "email", "created_at": "2022-03-04T17:58:30+02:00", "updated_at": "2022-03-04T17:58:30+02:00", "attachment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "display_attachment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "declined_note": "", "e_invoice_type": "zugferd", "has_duplicates": false, "invoice_number": "QONTO-JAN-2022", "supplier_name": "McDonald's", "vat_number": "IT12345678901", "tin": "1234567890", "description": "This is an invoice for Ronald!", "total_amount": { "value": "22.10", "currency": "EUR" }, "total_amount_excluding_taxes": { "value": "18.42", "currency": "EUR" }, "total_tax_amount": { "value": "3.68", "currency": "EUR" }, "taxes": [ { "tax_amount": { "value": "3.68", "currency": "EUR" }, "tax_rate": "0.20" } ], "issue_date": "2022-03-01", "due_date": "2022-03-01", "payment_date": "2022-03-01", "scheduled_date": "2022-03-01", "iban": "FR1420041010050500013M02606", "initiator_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "source": "email_forward", "is_attachment_invoice": true, "attachment_category": "INVOICE", "is_attachment_non_financial": true, "analyzed_at": "2022-03-04T17:58:30+02:00", "matched_transactions_ids": [ "4d5418bb-bd0d-4df4-865c-c07afab8bb48" ], "matched_transactions": [ { "subject_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48", "subject_type": "transfer", "transaction_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48" } ], "transfer_ids": [ "4d5418bb-bd0d-4df4-865c-c07afab8bb48" ], "request_transfer": { "id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48", "initiator_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48" }, "einvoicing_lifecycle_events": [ { "status_code": 200, "reason": "DOUBLE FACTURE", "reason_message": "I already received this invoice", "timestamp": "2024-12-04T11:05:16.4497Z" } ], "meta": { "integration_type": "amazon", "connector": "grover", "accounting_recorded_at": "2023-11-07T05:31:56Z", "accounting_recorded_source": "regate" }, "available_actions": { "delete": true, "archive": true, "unarchive": true, "pay": true, "reasons": { "pay": [ "is_credit_note" ], "delete": [ "invalid_status" ], "archive": [ "invalid_status" ], "unarchive": [ "invalid_status" ] } }, "approval_workflow": { "approver_ids": [ "3c90c3cc-0d44-4b50-8888-8dd25736052a" ], "supplier_invoice_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "verified_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "last_approved_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a" }, "payable_amount": { "value": "22.10", "currency": "EUR" }, "total_amount_credit_notes": { "value": "22.10", "currency": "EUR" }, "is_credit_note": false, "has_suggested_credit_notes": false, "related_invoices": [ { "id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48", "invoice_number": "QONTO-JAN-2022", "total_amount": { "value": "22.10", "currency": "EUR" }, "attachment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "file_name": "my-invoice.pdf" } ], "suggested_transactions": [ { "id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48", "score": "0.8" } ] }

Authorizations

OAuthSecretKey

Authorization · string · header · required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

X-Qonto-Staging-Token · string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Path Parameters

id · string<uuid> · required

The ID of the supplier invoice to mark as paid

Body

application/json

supplier_invoice · object · required

Show child attributes

Response

200

application/json

The supplier invoice

id · string<uuid> · required

Example:

"4d5418bb-bd0d-4df4-865c-c07afab8bb48"

is_einvoice · boolean · required

indicates if the invoice is an e-invoice, currently ONLY for the German organizations

Example:

false

has_discrepancies · boolean · required

Example:

false

organization_id · string<uuid> · required

Example:

"4d5418bb-bd0d-4df4-865c-c07afab8bb48"

file_name · string · required

Example:

"my-invoice.pdf"

status · Option 1 · string Option 2 · string Option 3 · string Option 4 · string Option 5 · string Option 6 · string Option 7 · string Option 8 · string Option 9 · string Option 10 · string · required

Initial status for invoices.

Allowed value: "to_review"

Example:

"to_review"

source_type · enum<string> · required

Available options: email, e_invoicing, direct_upload

Example:

"email"

created_at · string · required

Example:

"2022-03-04T17:58:30+02:00"

updated_at · string · required

Example:

"2022-03-04T17:58:30+02:00"

attachment_id · string<uuid> · required

display_attachment_id · string<uuid> · required

declined_note · string · default: "" · required

Note specified when invoice was archived

e_invoice_type · enum<string>

Available options: zugferd, xrechnung

Example:

"zugferd"

has_duplicates · boolean

Example:

false

invoice_number · string

Example:

"QONTO-JAN-2022"

supplier_name · string

Example:

"McDonald's"

vat_number · string | null

VAT number of the invoice issuer

Example:

"IT12345678901"

tin · string | null

Tax Identification Number (TIN) of the invoice issuer

Example:

"1234567890"

description · string

Example:

"This is an invoice for Ronald!"

total_amount · object

Show child attributes

total_amount_excluding_taxes · object

Show child attributes

total_tax_amount · object

Show child attributes

taxes · object[] | null

Individual tax entries on the invoice

Show child attributes

issue_date · string

Example:

"2022-03-01"

due_date · string

Example:

"2022-03-01"

payment_date · string

Example:

"2022-03-01"

scheduled_date · string

Example:

"2022-03-01"

iban · string

Example:

"FR1420041010050500013M02606"

initiator_id · string<uuid>

source · enum<string>

Available options: email_forward, e_invoicing, supplier_invoices, pay_by_invoice, integration, regate, generic_upload, pay_later

Example:

"email_forward"

is_attachment_invoice · boolean

attachment_category · enum<string>

The category of the attachment

Available options: INVOICE, EXPENSE_RECEIPT, CARD_RECEIPT, CREDIT_CARD_RECEIPT, CREDIT_NOTE, OTHER_FINANCIAL_DOCUMENT, OTHER_NON_FINANCIAL_DOCUMENT, UNKNOWN

Example:

"INVOICE"

is_attachment_non_financial · boolean

analyzed_at · string

Example:

"2022-03-04T17:58:30+02:00"

matched_transactions_ids · string<uuid>[] · deprecated

Deprecated: This field contains transfer IDs, not transaction IDs. Use matched_transactions instead.

matched_transactions · object[] | null

Array of payments (transfers/transactions) linked to this invoice

Show child attributes

transfer_ids · (string<uuid> | null)[]

IDs of the transfer payments associated with this invoice, if any

Example:

"4d5418bb-bd0d-4df4-865c-c07afab8bb48"

request_transfer · object

Show child attributes

einvoicing_lifecycle_events · object[]

Show child attributes

meta · object

Show child attributes

available_actions · object

Available actions for the invoice

Show child attributes

approval_workflow · object

Show child attributes

payable_amount · object

Show child attributes

total_amount_credit_notes · object

Show child attributes

is_credit_note · boolean

Example:

false

has_suggested_credit_notes · boolean

Example:

false

related_invoices · object[] | null

Show child attributes

suggested_transactions · object[] | null

suggested transactions for the invoice

Show child attributes