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

# easyVerein

> Send open club invoices and membership fees from easyVerein to paywise for debt collection

# paywise for easyVerein

<div style={{width: '64px', height: '64px', background: '#ffffff', borderRadius: '10px', display: 'flex', alignItems: 'center', justifyContent: 'center', padding: '10px', boxSizing: 'border-box'}}>
  <img src="https://mintcdn.com/paywisegmbh/wAdTkukMeudh23V7/images/integrations/easyverein-icon.png?fit=max&auto=format&n=wAdTkukMeudh23V7&q=85&s=468b974d389edc80b9f6909c27bb24e2" alt="easyVerein" style={{width: '100%', height: '100%', objectFit: 'contain', display: 'block'}} noZoom width="128" height="128" data-path="images/integrations/easyverein-icon.png" />
</div>

The easyVerein integration hands your club's open receivables — membership fees,
invoices, donations — straight to paywise for collection. You store a dedicated API
key for paywise; your easyVerein credentials are never shared.

<Note>
  paywise reads from easyVerein and never writes back. Nothing in your club
  administration is changed, cancelled or marked as paid.
</Note>

## Before you start

* An easyVerein account in which you may create API keys.
* A paywise account.
* At least one open invoice in easyVerein.

<Note>
  easyVerein is a separate source for collection imports. It can remain connected
  alongside a bookkeeping or DATEV connection. When easyVerein is connected, the
  invoice picker uses easyVerein.
</Note>

### What paywise reads

| Data                    | Why paywise needs it                                       |
| ----------------------- | ---------------------------------------------------------- |
| Organisation identity   | Recognises which club the key belongs to                   |
| Member and contact data | The debtor's name and address                              |
| Invoice data and items  | The open receivables and their breakdown                   |
| Payment differences     | The amount actually outstanding                            |
| Bank details            | Matching incoming payments                                 |
| Invoice PDF             | The evidence, where easyVerein supplies it through the API |

The API key is used read-only.

## Creating the easyVerein API key

Inside paywise this guide is available at any time via **So erstellen Sie einen
API-Schlüssel** on the easyVerein page.

<Steps>
  <Step title="Open the API settings">
    Open
    [easyverein.com/app/settings/easyVereinApi/](https://easyverein.com/app/settings/easyVereinApi/)
    and go to **Einstellungen → easyVerein API**.
  </Step>

  <Step title="Use a dedicated admin group">
    Select or create a dedicated administrator group for paywise and grant only the
    permissions required.
  </Step>

  <Step title="Create a separate key">
    Create a **separate** API key for paywise. Do not use this key for any other
    purpose.
  </Step>

  <Step title="Copy and paste the key">
    Copy the newly generated key once and paste it directly into the field in
    paywise.
  </Step>
</Steps>

<Warning>
  Never send the API key by email or chat.
</Warning>

<Info>
  **Validity and renewal.** According to easyVerein's help, a new API key is valid for
  30 days and can be renewed from day 15. **paywise renews the stored key
  automatically** — you do not need to rotate it yourself.
</Info>

## 1. Connect easyVerein

<Steps>
  <Step title="Open the connection page">
    Go to [app.paywise.de/connect/easyverein/](https://app.paywise.de/connect/easyverein/).
  </Step>

  <Step title="Paste the key">
    Paste the key into the **easyVerein API-Schlüssel** field.
  </Step>

  <Step title="Accept the terms and verify">
    Tick **Ich akzeptiere die Nutzungsbedingungen** and choose **API-Schlüssel prüfen
    und verbinden** (*check API key and connect*).
  </Step>
</Steps>

Once connected, the page shows the connected club.

## 2. Submit invoices for collection

<Steps>
  <Step title="Open the invoice picker">
    On the easyVerein page in paywise, choose **Rechnungen einreichen**.
  </Step>

  <Step title="Pick the invoices">
    paywise lists your open invoices live from easyVerein — with invoice number,
    recipient, invoice date, amount and open amount.
  </Step>

  <Step title="Check the debtor data">
    Name and address come from the easyVerein member or contact record. An available
    invoice PDF is attached automatically. If the document is missing, paywise shows
    a warning; upload it manually before submitting. Also review the recipient data
    and complete anything missing.
  </Step>

  <Step title="Record your payment reminder">
    easyVerein does not expose reminders over its interface. Enter how and when you
    asked for payment — in writing or verbally, the date, and any payment deadline
    you set.

    This matters legally: for consumers — and club members usually are consumers — a
    reminder is normally required before default interest and collection costs can be
    claimed.
  </Step>

  <Step title="Send the order">
    Confirm how collection should start, answer the legal questions, accept the terms
    and choose **Auftrag absenden**.
  </Step>
</Steps>

### Invoices that cannot be submitted

paywise checks every invoice strictly and refuses in case of doubt rather than
creating a questionable claim:

* **Only certain invoice kinds** can be submitted: membership fee, revenue, balance
  and donation.
* **Drafts, templates, requests and receipts** are excluded.
* **Offers** are excluded — including when only an offer number or an offer validity
  date is set.
* **Cancelled invoices and cancellation documents** are excluded.
* **Fully paid and overpaid invoices** are excluded.
* **Already submitted** invoices are shown as *Eingereicht*.

<Note>
  **The membership application is not imported.** easyVerein does carry a
  "Mitgliedschaftsantrag" field on the member record, but its relation to a specific
  invoice is not established. paywise deliberately does not import that document — add
  it to the case manually if needed.
</Note>

## 3. Disconnect

On the easyVerein page, choose **Verbindung löschen** and confirm with **Löschen**.

The stored API key is removed and paywise stops reading invoices. Orders you already
submitted are unaffected. You can reconnect easyVerein at any time.

## Troubleshooting

<AccordionGroup>
  <Accordion title="„Der easyVerein API-Schlüssel konnte nicht geprüft werden“">
    Check that you pasted the complete key and that the administrator group in
    easyVerein holds the required read permissions.
  </Accordion>

  <Accordion title="„Verbindung erneuern: Ihr easyVerein API-Schlüssel ist nicht mehr gültig“">
    The key was deleted in easyVerein or expired past its renewal window. Create a
    new key and store it.
  </Accordion>

  <Accordion title="An invoice is missing from the list">
    Check the invoice kind and status: drafts, templates, offers, cancellations and
    paid or overpaid invoices are deliberately not offered.
  </Accordion>
</AccordionGroup>

## Questions

Write to [info@paywise.de](mailto:info@paywise.de).