Bankkontoinhaberschaft mit Financial Connections verifizierenPrivate Vorschau
Verwenden Sie die Ownership Match API, um Übereinstimmungsergebnisse für Daten zur Inhaberschaft anzufordern.
Mit dem Ownership Match API können Sie überprüfen, ob Ihr/e Nutzer/in ein bestimmtes Bankkonto besitzt. Es berechnet Übereinstimmungspunkte, indem die Eigentumsdaten von Financial Connections mit den eingegebenen Eigentümerinformationen verglichen werden.
Bevor Sie loslegen
Sie müssen eine abgeschlossene Financial Connections-Registrierung haben, um im Live-Modus auf ownership zugreifen zu können. Rufen Sie Ihre Dashboard-Einstellungen auf, um den Status Ihrer Registrierung zu überprüfen oder den Registrierungsvorgang zu starten. Financial Connections-Testdaten sind immer verfügbar.
Um auf Ownership Match zuzugreifen, müssen Sie die API-Version und den Beta-Header in jeder API-Anfrage auf financial_ setzen.
Zugriff auf die Daten zur Kontoinhaberschaft abrufenServerseitig
Sie müssen ein Financial Connections-Konto erfassen, bevor Sie auf die Daten zur Inhaberschaft zugreifen können.
Geben Sie die Datenberechtigungen, auf die Sie Zugriff benötigen, mit dem Parameter permissions in der API an. Die Übereinstimmung mit der Inhaberschaft erfordert die Berechtigung ownership.
Ihre Nutzer/innen können die angeforderten Datenberechtigungen im Authentifizierungsvorgang einsehen.
Wir empfehlen die Verwendung von prefetch, um die Aktualisierung der Inhaberschaft zu veranlassen, sobald Ihr/e Nutzer/in sein/ihr Konto im Authentifizierungsablauf verbindet.
Sobald die Daten zur Inhaberschaft verfügbar sind, senden wir einen Financial Connections-Webhook.
Ownership Match API aufrufenServerseitig
Sie können Inhaberschaftsdaten mit einer der folgenden Methoden an die API übergeben:
- Erstellen Sie ein Kundenobjekt, mit zu dem Stripe Vergleiche anstellen kann
- Erfassen Sie ein Financial Connections-Konto mit einem/einer Kontoinhaber/in des Typs „Kundin/Kunde“
- Übermitteln Sie die Daten mit dem Parameter
owner_information
Die Inhaberschaftsübereinstimmung akzeptiert bis zu vier Eingabefelder, von denen eines aus der folgenden Liste stammen muss.
- Name
- E-Mail-Adresse
- Telefonnummer: Fügen Sie bei internationalen Zahlungen das Pluszeichen (
+) und den Ländercode ein. - Adresse: Alle Adressfelder außer Zeile 2 erforderlich
Notiz
Durch die Einbeziehung aller Inhaberschaftsfelder wird die Genauigkeit des Punktestands erhöht. Beispielsweise können Sie die Übereinstimmungsbewertung jedes Felds gewichten und in Ihrer Risikomodellierung verwenden.
Customer-Objekt erstellen Recommended
Wir empfehlen Ihnen, eine/n Kundin/Kunden zu erstellen, der/die Ihre/n Nutzer/in repräsentiert. Geben Sie alle Ihnen zur Verfügung stehenden Daten an, die Sie mit diesen abgleichen möchten.
Stripe lädt die Daten und gleicht sie ab, ohne dass Sie sensible Kundendaten verarbeiten müssen, wenn dies nicht unbedingt erforderlich ist.
Sie können über Stripe-Produkte sowohl ein Kunden- als auch ein Financial Connections-Konto erfassen, wie zum Beispiel ACH-Zahlungen in Checkout. Anschließend können Sie eine Übereinstimmung der Inhaberschaft anfordern und eine Risikoentscheidung basierend auf dem Ergebnis der Übereinstimmung treffen, ohne die Eigentumsdaten des Kunden/der Kundin einzusehen und möglicherweise eine Haftung für die PCI-Konformität auszulösen.
Dadurch wird eine Kundin/ein Kunde mit den Eigentumsdaten zurückgegeben, die die „übereinstimmende Inhaberschaft“ verwenden kann.
{ "id": "cus_NffrFeUfNV2Hib", "object": "customer", "created": 1651783000, "name": "Jenny Rosen", "address": { "line1": "354 Oyster Point Blvd", "line2": null, "city": "South San Francisco", "state": "CA", "postal_code": "94080", "country": "US" }, "email": "jennyrosen@example.com", "phone": "+1 212-555-5555", "livemode": false // ... }
Übergeben Sie die Kunden-id an die API, um sie mit dem Financial Connections-Konto abzugleichen.
Eröffnen Sie ein Financial Connections-Konto mit einem/einer Kontoinhaber/in vom Typ „Kunde/Kundin“
Sie können ein Financial Connections-Konto mit einer zugehörigen Kundin/einem zugehörigen Kunden erfassen, indem Sie customer auf die bestehende Kunden-ID setzen und die/den Kontoinhaber/in beim Erstellen einer Financial Connections-Sitzung auf customer festlegen.
Dadurch wird ein Financial Connections-Konto mit den erforderlichen ownership-Berechtigungen und einem zugehörigen Kunden/einer zugehörigen Kundin erstellt. Bei erfolgreichem Vorabruf oder Aktualisierung der Inhaberschaft wird das Konto zurückgegeben, einschließlich der zugehörigen Daten zur Financial Connections-Inhaberschaft, wenn ownership erweitert wird.
{ "id": "fca_1MwVK82eZvKYlo2Cjw8FMxXf", "object": "financial_connections.account", "created": 1651783222, "account_holder": { "customer": "cus_NffrFeUfNV2Hib", "type": "customer" }, "ownership": { "id": "fcaowns_1NtI9uBHO5VeT9SUSRe21lqt", "object": "financial_connections.account_ownership", "created": 1651784999, "owners": { "object": "list", "data": [ { "name": "Jennifer Rosen", "email": "jennyrosen@test.com", "phone": null, "ownership": "fcaowns_1NtI9uBHO5VeT9SUSRe21lqt", "raw_address": "354 Oyster Point Blvd South San Francisco, CA 94080 USA", "refreshed_at": 1651784999 } ], "has_more": false, "url": "/v1/financial_connections/accounts/fca_zbyrdjTrwcYZJZc6WBs6GPid/owners?ownership=fcaowns_1NtI9uBHO5VeT9SUSRe21lqt" } }, "ownership_refresh": { "status": "succeeded", "last_attempted_at": 1651784999, "next_refresh_available_at": 1651785000 }, "permissions": ["ownership", "payment_method"], "prefetch": ["ownership"] // ... }
Sie können die id des Financial Connections-Kontos ohne angegebenen Eingabe-type übergeben, um die Daten zur Financial Connections-Kontoinhaberschaft mit den Kundendaten der zugehörigen Kontoinhaber/innen abzugleichen.
Übermitteln Sie die Daten über den Parameter „Inhaberinformationen“
Wenn Sie sich dafür entscheiden, die Eigentumsdaten nicht über einen Kunden/eine Kundin zu erfassen, können Sie die von Nutzer/innen bereitgestellten Eigentumsdaten auch über den Parameter owner_ direkt an die API übergeben.
{ "owner_information": { "name": "Jenny Rosen", "email": "jennyrosen@example.com", "phone": "+1 212-555-5555", "address": { "line1": "354 Oyster Point Blvd", "line2": null, "city": "South San Francisco", "state": "CA", "postal_code": "94080", "country": "US" } } }
Übergeben Sie die Inhaberinformationen in der API, um sie mit dem Financial Connections-Konto abzugleichen.
Treffen Sie Entscheidungen auf der Grundlage der SpielergebnisseServerseitig
Die Ownership Match API gibt für jedes von Ihnen angegebene Eingabefeld einen Übereinstimmungswert von 0 bis 100 zurück. Sie können diesen Übereinstimmungswert in Ihre eigene Risikologik und Modellierung einspeisen, wie in den folgenden Beispielen gezeigt. Sie können beispielsweise Schwellenwerte für die Punktzahl festlegen, um mit einer Zahlung fortzufahren, oder um weitere Verifizierungen zu verlangen, wie z. B. das Hochladen von Identitätsnachweisen, bevor Sie fortfahren.
Abhängig von Ihrer Risikotoleranz und anderen Risikosignalen aus Ihren Kundendaten können Sie Ihre Logik dahingehend anpassen, dass eine genaue oder starke Übereinstimmung erforderlich ist, um mit einer Aktion fortzufahren, z. B. der Fortsetzung einer Zahlung oder dem Zulassen einer Auszahlung auf das Konto.
function makeRiskDecision(matchResult: Stripe.FinancialConnections.OwnershipMatch) { const nameScore = matchResult.results.name?.match_score? || 0; const addressScore = matchResult.results.address?.match_score? || 0; const emailScore = matchResult.results.email?.match_score? || 0; const phoneScore = matchResult.results.phone?.match_score? || 0; const overallScore = (nameScore + addressScore + emailScore + emailScore) / 4 if (overallScore >= 70) { proceedWithPayment(); } else if (overallScore >= 60) { stepUpVerification(); } else { cancelPayment(); } }
Beispiele für Punktestandinterpretationen
Name, E-Mail-Adresse, Anschrift
Beispiele für Übereinstimmungen im Vergleich zum Namen „Jenny Jane Rosen“, der E-Mail-Adresse „jennyrosen@example.com“ und der folgenden Adresse:
{ "line1": "354 Oyster Point Blvd", "line2": "Fl 1", "city": "South San Francisco", "state": "CA", "postal_code": "94080", "country": "US" }
| bewertung | Interpretation | Namensbeispiel | E-Mail-Beispiel | Adressbeispiel |
|---|---|---|---|---|
| 100 | Genaue Übereinstimmung | „Jenny Jane Rosen“ | „jennyrosen@example.com“ |
|
| 85-99 | Sehr starke Übereinstimmung, z. B. ein paar Zeichen daneben | „Jenny Jane Rosen“ | „jenny.rosen@example.com“ |
|
| 70-84 | Starke Übereinstimmung, z. B. Mehrheitsübereinstimmungen | „Jenny Rosen“ | „jennyrosen12345@example.com“ |
|
| 60-69 | Mögliche Übereinstimmungen, z. B. Teilübereinstimmungen oder Kurznamen | „Jennifer Rosen“ | „jennyrosen@test.com“ |
|
| 30-59 | Schwache Übereinstimmung, z. B. ein mögliches Haushaltsmitglied oder ähnliche Felder | „Mark Rosen“ | „marksmith@example.com“ |
|
| 0-29 | Keine oder unwahrscheinliche Übereinstimmung | „Mark Smith“ | „marksmith@test.com“ |
|
Telefon
Beispiel für Übereinstimmung mit der Telefonnummer „+1 212-555-5555“.
Notiz
Die Bewertungsbereiche für die Interpretation von Telefonbeispielen sind breiter, da es weniger granulare Variationen bei den Telefonnummern gibt.
| bewertung | Interpretation | Beispiele |
|---|---|---|
| 100 | Genaue Übereinstimmung | „+12125555555“, „(212) 555-5555“ |
| 70-99 | Mögliche Übereinstimmung, zum Beispiel eine abweichende Ziffer oder eine fehlende Zahl | „212 555 5559“ „212 555 555“ |
| 50-69 | Schwache Übereinstimmung, z. B. alle gleich, außer der Ortsvorwahl. | „347 555 5555“ |
| 20-49 | Unwahrscheinliche Übereinstimmung, z. B. nur dieselbe Vorwahl | „212 999 9999“ |
| 0-19 | Keine Übereinstimmung | „347 999 9999“ |
Beispielantwort
Die Ownership Match API gibt auch die übereinstimmenden Inhaberinformationen und die Inhaber-ID zurück, wie in der folgenden API-Beispielantwort gezeigt:
{ "id": "fcom_1NtI9uBHO5VeT9SUKLJU5suZ", "object": "financial_connections.ownership_match", "created": 1745858181, "financial_connections_account": "fca_1MwVK82eZvKYlo2Cjw8FMxXf", "type": "customer", "owner_information": { "name": "Jenny Rosen", "address": { "line1": "354 Oyster Point Blvd", "line2": null, "city": "South San Francisco", "state": "CA", "postal_code": "94080", "country": "US" }, "email": "jennyrosen@example.com", "phone": "+1 212-555-5555" }, "customer": "cus_NffrFeUfNV2Hib", "ownership": "fcaowns_1NtI9uBHO5VeT9SUSRe21lqt", "results": { "name": { "match_score": 85, "missing_data": false }, "address": { "match_score": 100, "missing_data": false }, "email": { "match_score": 65, "missing_data": false }, "phone": { "match_score": null, "missing_data": true } } }