Verarbeitung von Verifizierungen mit Token

Bevor wir Gebühren und Auszahlungen für verbundene Konten aktivieren können, müssen Sie die Anforderungen von Know Your Customer (KYC) erfüllen. Dazu müssen Sie Stripe Identitätsnachweise für Ihre Konten vorlegen, die wir anschließend überprüfen. Sie können diese Aufgabe mit Konto-Tokens und Personen-Token durchführen. Tokens stellen sicher, dass personenbezogene Daten (PII) nicht auf Ihre Server gelangen, sodass Ihre Integration sicher funktionieren kann. Diese Token ermöglichen es Stripe außerdem, potenzielle Betrugsfälle gezielter zu erkennen.

Sie können Token nur für Folgendes verwenden:

• Angaben zur juristischen Person (Informationen über das Unternehmen oder die Einzelperson)
• Angaben zur Person
• Zustimmung zur Vereinbarung für verbundene Konten von Stripe angeben

Es ist nicht möglich, Token für andere Kontoinformationen zu verwenden, einschließlich:

• Konfigurationseinstellungen für das Konto (zum Beispiel Auszahlungspläne)
• Nicht vertrauliche Konto-Informationen (z. B. Support-URL, Support-Telefonnummer)
• Das Land des verbundenen Kontos

Sie erstellen Token mit Stripe.js, der API oder einer der mobilen Client-Bibliotheken. Der Vorgang ähnelt dem Tokenisieren von Zahlungsdetails oder externen Konten. Die Informationen Ihres verbundenen Kontos werden direkt an Stripe gesendet und gegen ein Token ausgetauscht, das Sie in create- und update-API-Aufrufen verwenden können.

Erstellen und Verwenden von Token

Token benötigen sowohl clientseitigen als auch serverseitigen Code:

1. Erstellen Sie das HTML-Formular, das die Eingabe der Nutzer/innen aufnimmt.
2. Fügen Sie JavaScript hinzu, das die Formulardaten an Stripe sendet, im Gegenzug ein Token enthält und dieses Token an Ihren Server sendet.
3. Verwenden Sie das Token in einem serverseitigen Stripe-API-Aufruf.

Das folgende Beispiel zeigt, wie Konto-Token und Personen-Token verwendet werden. Beide Typen sind erforderlich, wenn Angaben zu juristischen und natürlichen Personen für Unternehmen bereitgestellt werden. Wenn Sie nur Einzelpersonen onboarden, benötigen Sie keine Personen-Token. Erstellen Sie stattdessen Konto-Token und übergeben Sie den individual-Hash im Account-Objekt, um die erforderlichen Informationen bereitzustellen.

Erfassung von Konto- und Personendaten

Erstellen Sie Formularelemente, um die erforderlichen Informationen zu erfassen, wie beispielsweise Name, Adresse und alle weiteren Angaben, die im Land der Nutzerin/des Nutzers erforderlich sind.

<form class="my-form" action="/create-person" method="post">
  <input type="hidden" name="token-account" id="token-account">
  <input type="hidden" name="token-person" id="token-person">
  <label>
    <span>Business Name</span>
    <input class="inp-company-name">
  </label>
  <fieldset>
    <legend>Business Address</legend>
    <label>
      <span>Street Address Line 1</span>

Vorlegen der Stripe-Vereinbarung für verbundene Konten

Als Plattformbetreiber müssen Sie Ihren Nutzerinnen und Nutzern klar mitteilen, dass die Abwicklung von Zahlungen gemäß der Stripe-Vereinbarung für verbundene Konten erfolgt. Die Zustimmung zur Stripe-Vereinbarung für verbundene Konten ist Voraussetzung für die Verwendung eines Konto-Tokens zur Erstellung eines neuen verbundenen Kontos.

Wir empfehlen Ihnen, Sprachen wie die folgenden aufzunehmen, einschließlich Links zu unserer Vereinbarung und zu Ihren allgemeinen Geschäftsbedingungen.

<p>By clicking, you agree to <a href="#">our terms</a> and the <a href="https://stripe.com/connect-account/legal">Stripe Connected Account Agreement</a>.</p>

// Assumes you've already included Stripe.js!
const stripe = Stripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx');
const myForm = document.querySelector('.my-form');
myForm.addEventListener('submit', handleForm);

async function handleForm(event) {
  event.preventDefault();

  const accountResult = await stripe.createToken('account', {
    business_type: 'company',
    company: {
      name: document.querySelector('.inp-company-name').value,
      address: {
        line1: document.querySelector('.inp-company-street-address1').value,
        city: document.querySelector('.inp-company-city').value,
        state: document.querySelector('.inp-company-state').value,
        postal_code: document.querySelector('.inp-company-zip').value,
      },
    },
    tos_shown_and_accepted: true,
  });

  const personResult = await stripe.createToken('person', {
    person: {
      first_name: document.querySelector('.inp-person-first-name').value,
      last_name: document.querySelector('.inp-person-last-name').value,
      address: {
        line1: document.querySelector('.inp-person-street-address1').value,
        city: document.querySelector('.inp-person-city').value,
        state: document.querySelector('.inp-person-state').value,
        postal_code: document.querySelector('.inp-person-zip').value,
      },
    },
  });

  if (accountResult.token && personResult.token) {
    document.querySelector('#token-account').value = accountResult.token.id;
    document.querySelector('#token-person').value = personResult.token.id;
    myForm.submit();
  }
}

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "controller[stripe_dashboard][type]"=none \
  -d "controller[fees][payer]"=application \
  -d "controller[losses][payments]"=application \
  -d "controller[requirement_collection]"=application \
  -d country=US \
  -d "capabilities[card_payments][requested]"=true \
  -d "capabilities[transfers][requested]"=true \
  -d account_token=
{{ACCOUNT_TOKEN_ID}}

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/persons \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d first_name=Jane \
  -d last_name=Diaz \
  -d person_token=
{{PERSON_ID}}

Erstellen von Konto-Token mit den mobilen SDKs

Sie können auch einen Konto-Token über unsere Android- oder iOS-SDKs erstellen (mobil unterstützt nur Konto-Token). Dies reicht aus, um ein Einzelkonto zu erstellen. Für ein Unternehmenskonto müssen Sie jedoch Stripe.js verwenden, um den erforderlichen Personen-Token zu erstellen.

import UIKit
import StripePayments

let companyParams = STPConnectAccountCompanyParams()
companyParams.name = company.name
companyParams.address = STPConnectAccountAddress()
companyParams.address.line1 = company.address_line_1
companyParams.address.city = company.address_city
companyParams.address.state = company.address_state
companyParams.address.country = company.address_country
companyParams.address.postalCode = company.address_postal_code

guard let accountParams = STPConnectAccountParams(tosShownAndAccepted: true, company: companyParams) else {
  // The TOS was not accepted
  return
}

STPAPIClient.shared.createToken(withConnectAccount: accountParams) { (accountToken, error) in
    if let error = error {
        // display an error to your user
    }
    else {
        // use account token to create a Connect account server-side
    }
}

Datei-Upload bearbeiten

Wenn ein verbundenes Konto Stripe Stripe einen Scan eines Ausweisdokuments, zum Beispiel eines Reisepasses, zur Verfügung stellen muss, können Sie ein Konto-Token verwenden. Das JavaScript ist jedoch komplizierter, da die Datei als Teil einer XHR-Anfrage an Stripe gesendet werden muss. Bei diesem Ablauf führt JavaScript Folgendes durch:

1. Die Formularübermittlung wird unterbrochen.
2. Wenn eine Datei hochgeladen wurde, sendet es diese an Stripe und erhält im Gegenzug einen Datei-Token.
3. Die Datei-Token-ID dem generischen Objekt für die Token-Anforderung des Kontos hinzugefügt.
4. Die Methode stripe.createToken() wird aufgerufen, um ein Token anzufordern.
5. Die ID des ausgegebenen Konto-Tokens wird zur Verwendung an Ihren Server gesendet.

Fügen Sie zunächst ein Dateielement zum Formular hinzu. Die hochgeladene Datei muss ein Farbbild sein (kleiner als 8.000 Pixel x 8.000 Pixel) im JPG-, PNG- oder PDF-Format und darf nicht größer als 10 MB sein.

<input type="file" id="id-file" name="id-file" accept=".jpeg,.jpg,.png">

Als Nächstes senden Sie in Ihrem JavaScript, das die Übermittlung des Formulars abwickelt, die hochgeladene Datei an Stripe. Dies muss vor der Erstellung des Konto-Tokens geschehen.

const data = new FormData();
data.append('file', document.querySelector('#id-file').files[0]);
data.append('purpose', 'identity_document');
const fileResult = await fetch('https://uploads.stripe.com/v1/files', {
  method: 'POST',
  headers: {'Authorization': 'Bearer 
pk_test_TYooMQauvdEDq54NiTphI7jx
'},
  body: data,
});
const fileData = await fileResult.json();

Schließlich fügen Sie die zurückgegebene Datei-ID als Wert verification.document.front in das generische Objekt ein, das an den Aufruf createToken() übergeben wird:

const result = await stripe.createToken('account', {
  person: {
    first_name: document.querySelector('.inp-first-name').value,
    last_name: document.querySelector('.inp-last-name').value,
    address: {
      line1: document.querySelector('.inp-street-address1').value,
      city: document.querySelector('.inp-city').value,
      state: document.querySelector('.inp-state').value,
      postal_code: document.querySelector('.inp-zip').value,
    },
    verification: {
        document: {
            front: fileData.id,
            },
        },
    },
  tos_shown_and_accepted: true,
});

Aktualisieren der Angaben zu juristischen und natürlichen Personen

Sie können Token verwenden, um die Angaben zu juristischen und natürlichen Personen eines bestehenden Kontos zu aktualisieren. Erstellen Sie die erforderlichen Token mit derselben Kombination aus HTML und JavaScript wie oben und führen Sie anschließend einen update account- oder update person-Aufruf durch, wobei Sie die neue Token-ID übergeben.

Sie müssen einen neuen Token erstellen und bereitstellen, wenn Sie Angaben zur juristischen Person aktualisieren, die zuvor mit einem Konto-Token festgelegt wurden.

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account_token=
{{ACCOUNT_TOKEN_ID}}

Bei Verwendung von Token für Aktualisierungen:

• Ein vorhandener Wert wird durch einen neuen Wert ersetzt.
• Wird kein neuer Wert angegeben, bleibt der bestehende Wert erhalten.
• Sie können einen vorhandenen Wert nicht deaktivieren.
• Der Parameter tos_shown_and_accepted wird ignoriert und kann weggelassen werden.
• Sie können ein Konto- oder Personen-Token für eine Aktualisierung verwenden, unabhängig davon, ob bei der Erstellung des Kontos oder der Person ursprünglich ein Token verwendet wurde oder nicht.
• Wenn das Konto oder die Person ursprünglich mit einem Konto-Token erstellt wurde, können Sie die Werte nur mit einem anderen Token aktualisieren.

Wenn beispielsweise ein Konto mit einem Token erstellt wird, das nur den Namen und das Geburtsdatum enthält, erstellen Sie einen weiteren Token, der nur die Adressinformationen enthält und führen dann einen Aufruf zur Aktualisierung des Kontos durch, um die Adressdaten zum Konto hinzuzufügen.

Entfernen von Angaben zu juristischen und natürlichen Personen

Um Angaben zu juristischen Personen oder Personen zu löschen oder einen Wert explizit als Null festzulegen, übergeben Sie eine leere Zeichenfolge in einem Aufruf zur Aktualisierung eines Kontos oder Aktualisierung einer Person. Verwenden Sie einen Aktualisierungsaufruf und kein Token, auch wenn Sie ursprünglich ein Token verwendet haben. Sie können leere Zeichenfolgen nur optionalen Attributen zuweisen (zum Beispiel der zweiten Zeile einer Adresse). Sie können sie keinen erforderlichen Attributen zuweisen.