--- title: Kreditkarten-Onboarding description: REST-API-Referenz zum Validieren einer Kreditkarte und Abfragen des Validierungsstatus in der Kreditkarten-Onboarding-Funktion von Verifizierung ohne physische Karte. canonical: https://developer.unico.io/de/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/credit-card-onboarding locale: de generated_by: markdown-export --- - [/de/](/de/) - Regionale Lösungen - [Verifizierung ohne physische Karte](/de/dual-api/developers/regional-solutions/card-not-present-verification) - [Integration](/de/dual-api/developers/regional-solutions/card-not-present-verification/integration/overview) - [APIs](/de/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis) - [API-Referenz](/de/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference) - Kreditkarten-Onboarding **Auf dieser Seite# Kreditkarten-Onboarding ### Bevor Sie beginnen​ Ihre API-Anfragen werden mit einem Zugriffstoken authentifiziert. Jede Anfrage, die kein gültiges Zugriffstoken enthält, gibt einen Fehler zurück. Erfahren Sie mehr unter [Authentifizierung](/de/developers/regional-solutions/card-not-present-verification/integration/authentication). Basis-URL **UAT**: `https://transactions.transactional.uat.unico.app/api/public/v1` **Produktion**: `https://transactions.transactional.unico.app/api/public/v1` WichtigDas Kreditkarten-Onboarding kann entweder durchgeführt werden, indem ein Selfie vom Endbenutzer angefordert und die vollständige Registrierung abgeschlossen wird, **oder** indem biometrische Erfassungen aus Prozessen wiederverwendet werden, die von anderen Produkten der Unico-IDCloud-Plattform ausgeführt wurden: Um von anderen IDCloud-Produkten generierte Prozesse wiederzuverwenden, geben Sie die Referenzprozess-ID in `additionalInfo.processID` an; Der verwendete Referenzprozess darf höchstens **1 Stunde** zuvor abgeschlossen worden sein. ### Kreditkarte validieren​ `POST /walletid/transaction` — validiert eine Kreditkarte. Header HeaderWert`Authorization``Bearer {token}` — ein gültiges Zugriffstoken. Body ``` { "identity": { "key": "cpf", "value": "12345678900" }, "orderNumber": "onboarding-98765", "company": "company-id", "redirectUrl": "https://yourapp.com/wallet/return", "card": { "binDigits": "12345678", "lastDigits": "1234", "expirationDate": "12/2028", "name": "John Doe" }, "value": 5000.00, "additionalInfo": { "externalUserID": "YOUR_EXTERNAL_USER_ID" }} ``` FeldTypErforderlichBeschreibung`identity`objectjaIdentitätsinformationen des Benutzers.`identity.key`stringjaArt des Identifikationsschlüssels des Benutzers.`identity.value`stringjaWert des Identifikationsschlüssels des Benutzers.`orderNumber`stringjaNummer im Zusammenhang mit dem Onboarding. Wird als Index im Portal und als Fremdschlüssel zwischen Ihrem System und Verifizierung ohne physische Karte verwendet.`company`stringjaID des für die Transaktion zuständigen Unternehmens, bereitgestellt von Unico.`redirectUrl`stringneinURL, zu der der Benutzer nach Abschluss der Transaktion weitergeleitet wird (eine HTTPS-URL für Web oder eine Schema-URL für native mobile Apps).`card`objectjaBei der Transaktion verwendete Karteninformationen.`card.binDigits`stringjaErste 8 Ziffern der Karte.`card.lastDigits`stringjaLetzte 4 Ziffern der Karte.`card.expirationDate`stringneinAblaufdatum der Karte.`card.name`stringjaName des Karteninhabers — stellen Sie sicher, dass er korrekt ist, um Kodierungsprobleme oder Genehmigungsprobleme zu vermeiden.`value`numberneinMaximal abgesicherter Wert.`additionalInfo`objectneinSenden Sie dieses Objekt mit `processID`, um biometrische Erfassungen von anderen Produkten der Unico-IDCloud-Plattform wiederzuverwenden, und/oder mit `externalUserID`, um die [Stille Verifizierung](/de/developers/regional-solutions/card-not-present-verification/integration/silent-verification) für diese Transaktion zu aktivieren.`additionalInfo.processID`stringneinReferenzprozess-ID der IDCloud-Plattform.`additionalInfo.externalUserID`stringneinDerselbe Bezeichner, der über die `externalUserId` des SDK beim Sammeln der Gerätemetadaten konfiguriert wurde. Nur erforderlich, um die stille Validierung auszulösen — ohne ihn wird die Transaktion normal erstellt, folgt aber immer dem Standard-visuellen Ablauf. GefahrDas Feld `orderNumber` muss mit der **eindeutigen** Bestellnummer dieses Kaufs im E-Commerce-System ausgefüllt werden — die Verwendung einer abweichenden Transaktions-ID ist falsch, und die Wiederverwendung von Werten kann `replicated transaction`-Fehler auslösen. 200 OK ``` { "id": "6ab1771e-dfab-4e47-8316-2452268e5481", "status": "processing", "link": "https://developers/regional-solutions/card-not-present-verification.unico.app/t/6ab1771e-dfab-4e47-8316-2452268e5481", "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."} ``` FeldBeschreibung`id`ID der erstellten Transaktion.`status`Aktueller Transaktionsstatus.`link`Link im Zusammenhang mit der Transaktion. Wird nur zurückgegeben, wenn `additionalInfo.processID` **nicht** angegeben wurde.`token`Signiertes Token zur Initialisierung des Web-SDK von Verifizierung ohne physische Karte. Wird nur zurückgegeben, wenn `additionalInfo.processID` **nicht** angegeben wurde. HinweisWenn `additionalInfo.externalUserID` gesendet wurde und die Transaktion still genehmigt wird, überspringt die Antwort ebenfalls den Erfassungslink:``` { "id": "6ab1771e-dfab-4e47-8316-2452268e5481", "status": "approved"} ``` Den vollständigen Ablauf, einschließlich SDK-Einrichtung und Timing-Anforderungen, finden Sie unter [Stille Verifizierung](/de/developers/regional-solutions/card-not-present-verification/integration/silent-verification). ### Validierungsstatus prüfen​ `GET /walletid/transactions/{transaction_id}` — prüft den aktuellen Status einer bestimmten Transaktion. Header HeaderWert`Authorization``Bearer {token}` — ein gültiges Zugriffstoken. 200 OK ``` { "status": "processing", "hasIdentityChanged": false} ``` FeldBeschreibung`status`Aktueller Status der Transaktion.`hasIdentityChanged`Optional. Gibt an, ob in der Transaktion ein Identitätswechsel stattgefunden hat. Alle möglichen Status finden Sie unter [Aufzählungen](/de/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/enumerated). Um die Leistung zu optimieren, implementieren Sie den Webhook, anstatt diesen Endpunkt abzufragen. Fehlerantworten finden Sie unter [Fehler — Kreditkarten-Onboarding](/de/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#credit-card-onboarding).Zuletzt aktualisiert am 8. Okt. 2026**