> For the complete documentation index, see [llms.txt](https://one-loop.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://one-loop.gitbook.io/help/plattform/one-loop-plattform/dokumente-und-vertrage-erstellen-und-versenden/kartendaten-in-dokumenten-sicher-erfassen.md).

# Kartendaten in Dokumenten sicher erfassen

Ergänze ein Kartendatenfeld in Dokumenten, ordne es der richtigen unterzeichnenden Person zu und prüfe die Voraussetzungen vor dem Versand.

## Wofür das Feld gedacht ist

Mit dem Feld **Kartendaten** kann eine unterzeichnende Person ihre Kartendaten während des Ausfüllens eines Dokuments hinterlegen. Das Feld speichert eine Zahlungsmethode für spätere, unterstützte Zahlungsabläufe. Es löst beim Ausfüllen selbst keine unmittelbare Belastung aus.

Das ist hilfreich, wenn ein Vertrag zuerst unterschrieben wird und die hinterlegte Zahlungsmethode erst in einem späteren, dafür vorgesehenen Ablauf gebraucht wird. Wenn eine Zahlung unmittelbar nach der Unterschrift stattfinden soll, nutze stattdessen den passenden Ablauf mit Positionen und direkter Zahlungsaufforderung.

## Voraussetzungen vor dem Einrichten

Prüfe diese Punkte, bevor du ein Dokument versendest:

| Voraussetzung                                                 | Warum sie wichtig ist                                                                |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| Ein unterstützter Zahlungsanbieter ist im Standort verbunden. | Die Kartendaten können nur über einen aktiven Anbieter hinterlegt werden.            |
| Der Anbieter steht für Dokumente zur Verfügung.               | Eine allgemeine Verbindung reicht nicht, wenn sie im Dokumentablauf nicht aktiv ist. |
| Die richtige unterzeichnende Person ist angelegt.             | Das Feld muss eindeutig einer Person zugeordnet sein.                                |
| Der erforderliche Status ist festgelegt.                      | Als Pflichtfeld muss die Person die Daten vor dem Abschluss eingeben.                |

Wenn im Eigenschaftenbereich ein Hinweis wie **Zahlungsanbieter erforderlich** erscheint, verbinde oder prüfe den Anbieter und aktualisiere die Änderungen. Versende das Dokument erst, wenn der Hinweis verschwunden ist.

## Kartendatenfeld einfügen

1. Öffne **Zahlungen > Dokumente und Verträge**.
2. Öffne ein bestehendes Dokument oder eine Vorlage. Du kannst auch ein neues Dokument anlegen.
3. Wähle im Builder **Element hinzufügen**.
4. Ziehe unter den ausfüllbaren Feldern **Kartendaten** an die gewünschte Stelle.
5. Klicke das Feld an, um seine Eigenschaften zu öffnen.
6. Wähle bei **Auszufüllen von** die richtige unterzeichnende Person.
7. Aktiviere **Erforderlich**, wenn das Dokument ohne diese Angabe nicht abgeschlossen werden darf.
8. Passe bei Bedarf den Platzhaltertext an, zum Beispiel „Kartendaten hinterlegen“.
9. Speichere das Dokument oder die Vorlage.

## Was die unterzeichnende Person sieht

Die Person öffnet das Dokument und startet den Ausfüllvorgang. Beim Feld **Kartendaten** öffnet sich eine Eingabemaske für Kartennummer, Ablaufdatum, Sicherheitscode und Land. Nach dem erfolgreichen Abschluss sieht die Person eine Bestätigung, dass die Zahlungsmethode hinterlegt wurde.

Nach der Speicherung zeigt die Anwendung keine vollständige Kartennummer an. Sichtbar bleiben nur eingeschränkte Angaben wie Kartenart, letzte Ziffern und Ablaufdatum. Teile Screenshots oder Dokumente mit solchen Informationen nur mit Personen, die sie für ihre Aufgabe benötigen.

## Nicht mit einer direkten Zahlungsaufforderung verwechseln

| Ziel                                                                 | Passender Ablauf                                                                         |
| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| Zahlungsmethode für einen späteren, unterstützten Ablauf hinterlegen | Feld **Kartendaten** im Dokument verwenden.                                              |
| Unmittelbar nach Unterschrift eine Zahlung einholen                  | Den dafür vorgesehenen Dokumentablauf mit Positionen und Zahlungsaufforderung einsetzen. |

Ein Kartendatenfeld ist deshalb keine Zusage, dass unmittelbar eine Zahlung stattfindet. Kommuniziere im Dokument klar, wofür die Angaben verwendet werden und wer sie ausfüllen soll.

## Praxisbeispiel

Ein Beratungsunternehmen versendet einen Vertrag an eine neue Kundin. Im Dokument ist neben Unterschrift und Datum ein Kartendatenfeld eingefügt und der Kundin zugeordnet. Das Feld ist erforderlich, weil für spätere vereinbarte Abläufe eine Zahlungsmethode benötigt wird. Vor dem Versand prüft das Team die Vorschau mit einem Testdokument. Nach dem Test erscheint keine vollständige Kartennummer im Kontakt, sondern nur die eingeschränkten Karteninformationen.

## Ergebnis prüfen

1. Kontrolliere im Builder, ob das Feld der richtigen Person zugeordnet ist.
2. Prüfe, ob der Zahlungsanbieter als aktiv angezeigt wird.
3. Sende ein Testdokument an eine berechtigte Testperson.
4. Kontrolliere, ob die Eingabemaske erscheint und das Dokument bei Bedarf erst nach der Eingabe abgeschlossen werden kann.
5. Prüfe anschließend, dass nur eingeschränkte Karteninformationen angezeigt werden.

## Typische Probleme

### Der Hinweis zum Zahlungsanbieter bleibt sichtbar

Prüfe, ob ein unterstützter Anbieter im richtigen Standort verbunden und aktiv ist. Aktualisiere danach den Builder, damit die neue Einrichtung übernommen wird.

### Die falsche Person soll die Daten eingeben

Öffne die Eigenschaften des Feldes und ändere **Auszufüllen von**. Teste anschließend mit den tatsächlichen Empfängerrollen.

### Die Person wird unmittelbar belastet erwartet

Erkläre im Dokument und in der begleitenden Nachricht den Unterschied: Das Kartendatenfeld hinterlegt eine Zahlungsmethode; eine unmittelbare Zahlung braucht den vorgesehenen Zahlungsablauf.

### Das Feld fehlt im erhaltenen Dokument

Prüfe, ob die zuletzt gespeicherte Version verwendet wurde und ob die richtige unterzeichnende Person das Dokument öffnet.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://one-loop.gitbook.io/help/plattform/one-loop-plattform/dokumente-und-vertrage-erstellen-und-versenden/kartendaten-in-dokumenten-sicher-erfassen.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.