Mark a supplier invoice as paid

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"
  }
}
'

import requests

url = "https://thirdparty.qonto.com/v2/supplier_invoices/{id}/mark_as_paid"

payload = { "supplier_invoice": { "payment_date": "2026-01-01" } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({supplier_invoice: {payment_date: '2026-01-01'}})
};

fetch('https://thirdparty.qonto.com/v2/supplier_invoices/{id}/mark_as_paid', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://thirdparty.qonto.com/v2/supplier_invoices/{id}/mark_as_paid",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'supplier_invoice' => [
        'payment_date' => '2026-01-01'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://thirdparty.qonto.com/v2/supplier_invoices/{id}/mark_as_paid"

	payload := strings.NewReader("{\n  \"supplier_invoice\": {\n    \"payment_date\": \"2026-01-01\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://thirdparty.qonto.com/v2/supplier_invoices/{id}/mark_as_paid")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"supplier_invoice\": {\n    \"payment_date\": \"2026-01-01\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://thirdparty.qonto.com/v2/supplier_invoices/{id}/mark_as_paid")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"supplier_invoice\": {\n    \"payment_date\": \"2026-01-01\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "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,
  "supplier_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
  "self_invoice_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
  "issuer_name": "McDonald's",
  "invoice_number": "QONTO-JAN-2022",
  "supplier_name": "McDonald's",
  "vat_number": "IT12345678901",
  "tin_number": "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": "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"
  },
  "supplier_snapshot": {
    "id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
    "name": "McDonald's",
    "iban": "FR1420041010050500013M02606",
    "tin": "1234567890",
    "vat_number": "IT12345678901",
    "email": "billing@example.com",
    "currency": "EUR",
    "status": "active"
  },
  "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"
    }
  ],
  "buyer": {
    "name": "Qonto SAS",
    "tin": "552100554",
    "vat_number": "FR89552100554",
    "address": {
      "street_address": "12 rue de Rivoli",
      "zip_code": "75001",
      "city": "Paris",
      "province_code": "IDF",
      "country_code": "FR"
    }
  },
  "seller": {
    "name": "ACME SAS",
    "tin": "123456789",
    "vat_number": "FR12345678901",
    "address": {
      "street_address": "12 rue de Rivoli",
      "zip_code": "75001",
      "city": "Paris",
      "province_code": "IDF",
      "country_code": "FR"
    }
  },
  "payment_means": [
    {
      "type": "transfer",
      "payee_name": "ACME SAS",
      "code": "30"
    }
  ]
}

POST

supplier_invoices

{id}

mark_as_paid

Mark a supplier invoice as paid

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"
  }
}
'

import requests

url = "https://thirdparty.qonto.com/v2/supplier_invoices/{id}/mark_as_paid"

payload = { "supplier_invoice": { "payment_date": "2026-01-01" } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({supplier_invoice: {payment_date: '2026-01-01'}})
};

fetch('https://thirdparty.qonto.com/v2/supplier_invoices/{id}/mark_as_paid', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://thirdparty.qonto.com/v2/supplier_invoices/{id}/mark_as_paid",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'supplier_invoice' => [
        'payment_date' => '2026-01-01'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://thirdparty.qonto.com/v2/supplier_invoices/{id}/mark_as_paid"

	payload := strings.NewReader("{\n  \"supplier_invoice\": {\n    \"payment_date\": \"2026-01-01\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://thirdparty.qonto.com/v2/supplier_invoices/{id}/mark_as_paid")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"supplier_invoice\": {\n    \"payment_date\": \"2026-01-01\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://thirdparty.qonto.com/v2/supplier_invoices/{id}/mark_as_paid")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"supplier_invoice\": {\n    \"payment_date\": \"2026-01-01\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "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,
  "supplier_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
  "self_invoice_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
  "issuer_name": "McDonald's",
  "invoice_number": "QONTO-JAN-2022",
  "supplier_name": "McDonald's",
  "vat_number": "IT12345678901",
  "tin_number": "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": "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"
  },
  "supplier_snapshot": {
    "id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
    "name": "McDonald's",
    "iban": "FR1420041010050500013M02606",
    "tin": "1234567890",
    "vat_number": "IT12345678901",
    "email": "billing@example.com",
    "currency": "EUR",
    "status": "active"
  },
  "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"
    }
  ],
  "buyer": {
    "name": "Qonto SAS",
    "tin": "552100554",
    "vat_number": "FR89552100554",
    "address": {
      "street_address": "12 rue de Rivoli",
      "zip_code": "75001",
      "city": "Paris",
      "province_code": "IDF",
      "country_code": "FR"
    }
  },
  "seller": {
    "name": "ACME SAS",
    "tin": "123456789",
    "vat_number": "FR12345678901",
    "address": {
      "street_address": "12 rue de Rivoli",
      "zip_code": "75001",
      "city": "Paris",
      "province_code": "IDF",
      "country_code": "FR"
    }
  },
  "payment_means": [
    {
      "type": "transfer",
      "payee_name": "ACME SAS",
      "code": "30"
    }
  ]
}

Authentication: API key OAuth 2.0
Scope: supplier_invoice.write 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. payment_date is optional. When you omit it, the current date is used. 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 and the payment_date you send matches the recorded one, 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. Because an omitted payment_date resolves to the current date, retrying a date-less call against an already paid invoice on a later day returns 422 (already_paid_with_different_payment_date). Send an explicit payment_date if you need retries to be safe across day boundaries.

Authorizations

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

string<uuid>

required

The ID of the supplier invoice to mark as paid

Body

application/json

supplier_invoice

object

required

Show child attributes

Response

The supplier invoice

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

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

supplier_id

string<uuid>

ID of the supplier linked to this invoice

Example:

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

self_invoice_id

string<uuid> | null

ID of the related self-invoice, when applicable

Example:

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

issuer_name

string | null

Name of the issuer as extracted from the invoice data

Example:

"McDonald's"

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_number

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

Total invoice amount excluding taxes. Populated for e-invoices (FR, IT, DE) and for invoices where OCR extracted the pretax total; null when the value is unknown.

Show child attributes

total_tax_amount

object | null

Sum of all taxes on the invoice. Populated for e-invoices (FR, IT, DE) and for invoices where OCR extracted the tax total; null when the value is unknown.

Show child attributes

taxes

object[] | null

Per-rate tax breakdown extracted from the invoice. Populated for e-invoices (FR, IT, DE) when the source document provides a rate-by-rate summary; null or empty otherwise.

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,

attachments_hub,

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

Introduction

Authentication

Organization & accounts

Transactions & statements

Transfers

Getting paid

Cards

Invoicing

Spend management

Cash flow

Webhooks

Partner endpoints

Mark a supplier invoice as paid

Authorizations

Headers

Path Parameters

Body

Response