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

# Manage Payments

> Add payments, retry failed payments, and manage payment fees

## Add Payment

When a customer pays an invoice, you can manually add the payment in Fynn to update the invoice status.
This is relevant, for example, when bank transfers have been made or payments have been recorded in an external system.

<Tabs>
  <Tab title="Using the Web App">
    <Steps>
      <Step title="Open Invoice">
        Navigate to the desired invoice in the invoice overview
      </Step>

      <Step title="Add Payment">
        Click on `Add Payment`
      </Step>

      <Step title="Enter Payment Details">
        Enter the payment details and confirm with `Save`.

        If the amount matches the invoice, the invoice is automatically set to `Paid`.
        If notification settings are enabled, the customer will be informed about the payment receipt and the updated invoice status.

        <Frame>
          <img src="https://mintcdn.com/fynnsubscriptionbilling/1WHsrw9xV98b8NDj/images/invoices/add-payment.png?fit=max&auto=format&n=1WHsrw9xV98b8NDj&q=85&s=b5a400827afa292d9d42200fd6298aff" alt="Add Payment" width="386" height="606" data-path="images/invoices/add-payment.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Using the API">
    Use the [Add Payment](/api-reference/invoice/add-invoice-payment) endpoint.

    ```bash theme={null}
    POST /invoices/{id}/payments
    ```
  </Tab>
</Tabs>

## Retry Payment

If a payment has failed, you can retry it. A new or existing payment method can be used.

After changing the payment method, the outstanding amount will automatically be collected via the new payment method.

<Tabs>
  <Tab title="Using the Web App">
    <Steps>
      <Step title="Open Invoice">
        Navigate to the desired invoice in the invoice overview
      </Step>

      <Step title="Retry Payment">
        Click on `Actions` > `Change Payment Method`.
        Select a new payment method and confirm with `Settle Outstanding Amount`.

        The new payment method will automatically be used for the outstanding payment.

        <Frame>
          <img src="https://mintcdn.com/fynnsubscriptionbilling/1WHsrw9xV98b8NDj/images/invoices/change-payment-method.png?fit=max&auto=format&n=1WHsrw9xV98b8NDj&q=85&s=6649e039ff7ddfda9d8ec1ab42393641" alt="Change Payment Method" width="446" height="358" data-path="images/invoices/change-payment-method.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Using the API">
    Use the [Retry Payment](/api-reference/invoice/set-invoice-payment-method) endpoint.

    ```bash theme={null}
    POST /invoices/{id}/payment-method
    ```
  </Tab>
</Tabs>

## Check how up-to-date your bank data is

Right above the table on the payments overview, you can see when your connected bank accounts were last synced — for example `2 hours ago, 14:32`. That way, you can tell at a glance whether the payments you're looking at reflect the current state of your bank before you reconcile invoices or reach out to customers.

The hint is visible to every team member with access to the payments overview. Even if you can't open the bank transactions yourself, you'll always know how fresh the underlying data is.

If you haven't connected any bank accounts yet, the line shows `No bank accounts connected` instead.

## Payment Provider Fees

Payments through integrated payment providers may incur fees. These are transparently displayed in the invoice detail view:

1. Open the invoice
2. Scroll to the "Payments" section
3. The fees are shown individually per payment