> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperline.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Reconciliation

> Learn how invoice reconciliation works in Hyperline

Hyperline natively supports reconciliation between banking transactions and invoices in multiple ways, depending on the payment method used by your customers.

## Payment Service Provider (PSP)

If you use a Payment Service Provider (PSP) with automated payment methods like cards or direct debit, invoices will automatically reconcile without manual intervention. As Hyperline orchestrates the payment initiation, it tracks payment status (money movement, chargebacks, etc.) in real-time and updates the invoice accordingly.

## Connected bank account

Hyperline **supports a wide range of bank connections in France, the UK, Germany, Belgium, Spain, and the US**, enabling you to link your business bank account with a single click. Once connected, your bank account details can be added to invoices, and Hyperline will **automatically suggest matching transactions for each invoice, facilitating easy reconciliation**.

<Steps>
  <Step title="Navigate to Settings > Payment page">
    Click on 'Connect bank account'.

    <Frame>
      <img src="https://mintcdn.com/hyperline/Nzs4KUH1kGLJdieT/images/invoices/transaction12.png?fit=max&auto=format&n=Nzs4KUH1kGLJdieT&q=85&s=ce5d53e1a5f84dbed355139f17f63a17" style={{ margin: "auto", borderRadius: "6px" }} width="1490" height="292" data-path="images/invoices/transaction12.png" />
    </Frame>
  </Step>

  <Step title="Link your bank">
    Click on the 'Link new bank' button and complete the authentication process.
  </Step>

  <Step title="Connect your bank account">
    Once linked, select the bank account you want to connect to Hyperline.

    <Frame>
      <img src="https://mintcdn.com/hyperline/Nzs4KUH1kGLJdieT/images/invoices/transaction13.png?fit=max&auto=format&n=Nzs4KUH1kGLJdieT&q=85&s=af1178d550330b21b307d50a1a058023" style={{ margin: "auto", borderRadius: "6px" }} width="1284" height="752" data-path="images/invoices/transaction13.png" />
    </Frame>
  </Step>

  <Step title="Reconcile">
    Hyperline will automatically match transactions or suggest one from your bank account for each unpaid invoice based on matching details.

    <Frame>
      <img src="https://mintcdn.com/hyperline/MApYXEeVMjSBTMHp/images/invoices/reconcile1.png?fit=max&auto=format&n=MApYXEeVMjSBTMHp&q=85&s=a87b087b8c2702a6232d126435637705" style={{ margin: "auto", borderRadius: "6px" }} width="1568" height="1108" data-path="images/invoices/reconcile1.png" />
    </Frame>
  </Step>
</Steps>

Additionally, you can access your bank statements and account balances, and reconcile invoices directly from the Transactions page.

### Reconciliation logic

Reconciliation targets invoices with status 'to\_pay' or 'partially\_paid', and is restricted to payment methods 'transfer' or 'external' (or no payment method set).

Hyperline automatically matches incoming bank transactions to outstanding invoices using a confidence-based scoring system. Each transaction is scored against unpaid invoices, and only matches above a minimum confidence threshold are suggested, ranked from most to least likely.

Matching signals (from strongest to weakest):

* Payment reference — If the transaction description contains the invoice's payment reference, it's an automatic match.
* Alphanumeric invoice number — Invoice numbers containing both letters and digits (e.g. INV-2024-042) found in the transaction description are also treated as certain matches.
* Known payer account + exact amount — When the paying bank account is already linked to the customer and the amount/currency match, confidence is very high.
* Invoice number, customer name, amount — These signals are scored individually and combined. An invoice number appearing as a distinct word carries more weight than a partial match. Customer name and exact amount each contribute additional confidence.

Only matches exceeding the confidence threshold are surfaced, sorted by likelihood so the best match appears first.

<Info>
  Transactions are fetched daily, meaning that a transaction arriving in the bank account on one day will be suggested for reconciliation the following day.
</Info>

### Viewing invoice status in transactions

When viewing your bank transactions, Hyperline displays invoice status indicators next to reconciled or suggested invoices. These visual indicators help you quickly identify the payment status of each invoice.

This makes it easier to understand the current state of each invoice directly from the transactions view without needing to navigate to the invoice detail page.

## Automated customer bank transfer

Hyperline offers a method to **automate bank transfer reconciliation** by assigning unique bank account details per customer and a distinct reference for every invoice. The account details remain constant for each customer, while the reference changes with each invoice.

The bank account details and reference are added to the invoice **when it is ready to be paid** and sent for payment.

<Frame caption="Navigate to Settings > Payment page">
  <img width="80%" src="https://mintcdn.com/hyperline/Nzs4KUH1kGLJdieT/images/invoices/transaction2.png?fit=max&auto=format&n=Nzs4KUH1kGLJdieT&q=85&s=0ff9fc8f1f2028d5d16de656f6d1a074" style={{ margin: "auto", borderRadius: "6px" }} data-path="images/invoices/transaction2.png" />
</Frame>

When a payment is received with the matching reference, Hyperline automatically reconciles the invoice and marks it as paid, eliminating the need for manual intervention. If a customer uses an incorrect or unrecognized reference, the funds are automatically returned to the customer's bank account.

<Note>
  This feature is currently available only with Mollie. You can transfer payouts from your Mollie account to another bank account, just as you would with any other card or direct debit payments.
</Note>

## Manual customer bank transfer

If you enable manual bank transfers as a payment option (in the 'Settings > Payment' page), you will need to manually update invoice statuses to 'Paid' in Hyperline, as the platform cannot access your bank account information and transaction history.

After setting up a subscription for your customer, they can pay via their checkout page by selecting 'Bank transfer'.

<Frame>
  <img src="https://mintcdn.com/hyperline/Nzs4KUH1kGLJdieT/images/invoices/transaction3.png?fit=max&auto=format&n=Nzs4KUH1kGLJdieT&q=85&s=9b1df23b70dc476efe1a905142cc7b98" width="1438" height="711" data-path="images/invoices/transaction3.png" />
</Frame>

When the customer clicks on **Pay**, they will be presented with a link to download their invoice as a PDF document.

<Frame>
  <img src="https://mintcdn.com/hyperline/Nzs4KUH1kGLJdieT/images/invoices/transaction4.png?fit=max&auto=format&n=Nzs4KUH1kGLJdieT&q=85&s=8fcb90ef41afc2fe2db893147aa670a5" width="1441" height="697" data-path="images/invoices/transaction4.png" />
</Frame>

The invoice will then appear in the **Invoices** section with the status **To pay**.

You will need to manually mark it as **Paid** or **Partially paid** in Hyperline once payment is received.

<Frame>
  <img src="https://mintcdn.com/hyperline/Nzs4KUH1kGLJdieT/images/invoices/transaction5.png?fit=max&auto=format&n=Nzs4KUH1kGLJdieT&q=85&s=792f870c668aa16396853adf6a67e336" width="1240" height="712" data-path="images/invoices/transaction5.png" />
</Frame>

### Manually marking invoices as paid

<Note>
  Manually changing the status of invoices only applies to bank transfers and
  other offline transactions. For all other transactions (credit cards, direct
  debit, automated transfers) through a Payment Service Provider, **invoices
  will be automatically updated in Hyperline**.
</Note>

When creating a new subscription with bank transfers, the invoice status will automatically be marked as **To pay** until the first payment is received from the customer.

<Frame>
  <img src="https://mintcdn.com/hyperline/Nzs4KUH1kGLJdieT/images/invoices/transaction6.png?fit=max&auto=format&n=Nzs4KUH1kGLJdieT&q=85&s=3d56094366801da95620d970a126e68d" width="1240" height="712" data-path="images/invoices/transaction6.png" />
</Frame>

There are two ways to change an invoice status from **To pay** to **Paid** or **Partially paid**:

From the Invoices page, click the three-dots menu on the invoice row, then select **Mark as paid**.

<Frame>
  <img src="https://mintcdn.com/hyperline/Nzs4KUH1kGLJdieT/images/invoices/transaction7.png?fit=max&auto=format&n=Nzs4KUH1kGLJdieT&q=85&s=885e5e4125334dfd43f27d003791c508" width="1240" height="712" data-path="images/invoices/transaction7.png" />
</Frame>

Alternatively, from the invoice detail page, click on **Actions** and select **Mark as paid**.

<Frame>
  <img src="https://mintcdn.com/hyperline/Nzs4KUH1kGLJdieT/images/invoices/transaction8.png?fit=max&auto=format&n=Nzs4KUH1kGLJdieT&q=85&s=1d81811e1bb21f7117f31c702b1d5bb7" width="1240" height="712" data-path="images/invoices/transaction8.png" />
</Frame>

Select whether to mark the invoice as **Paid** or **Partially paid**, specify the amount paid, and click **Save**.

<Check>
  The **partially paid** status allows you to offer customers the flexibility to pay in
  multiple installments. You can update the invoice status after each payment is received until
  the total amount is paid.
</Check>

<Frame>
  <img src="https://mintcdn.com/hyperline/Nzs4KUH1kGLJdieT/images/invoices/transaction9.png?fit=max&auto=format&n=Nzs4KUH1kGLJdieT&q=85&s=fdb10d9925f4f437af0c00358bb3e5c7" width="1240" height="712" data-path="images/invoices/transaction9.png" />
</Frame>

The invoice status will update to either **Paid** or **Partially paid**, and the transaction status will be marked as **Settled**.

Below is an example of a partially paid invoice:

<Frame>
  <img src="https://mintcdn.com/hyperline/Nzs4KUH1kGLJdieT/images/invoices/transaction10.png?fit=max&auto=format&n=Nzs4KUH1kGLJdieT&q=85&s=acf2d6ede3dd9d93c67513607d9d2c29" width="1240" height="712" data-path="images/invoices/transaction10.png" />
</Frame>

And a fully paid invoice:

<Frame>
  <img src="https://mintcdn.com/hyperline/Nzs4KUH1kGLJdieT/images/invoices/transaction11.png?fit=max&auto=format&n=Nzs4KUH1kGLJdieT&q=85&s=8c66bbc6acacdf94f75c06f4deb3a41f" width="1240" height="712" data-path="images/invoices/transaction11.png" />
</Frame>
