Testen der Kontobestätigung beim API-Onboarding

In diesem Dokument wird davon ausgegangen, dass Sie mit dem API-Onboarding vertraut sind und wissen, wie Sie Konten aktualisieren und die Identitätsprüfung durchführen.

Testen Sie Ihre Verifizierungsabläufe, damit sie die Änderungen am Kontostatus handhaben können (z. B. wenn Sie Zahlungen aktivieren oder deaktivieren). Kontostatus ändern sich in der Regel, nachdem die Anforderungen erfüllt sind oder wenn Verarbeitungs- oder Zeitschwellenwerte erreicht werden. In den nachfolgenden Abschnitten werden diese Änderungen beschrieben, und es wird erläutert, wie Sie Ihre Verifizierungsabläufe testen können.

Ursprüngliche Anforderungen testen

Erstellen Sie zunächst ein neues verbundenes Konto im Testmodus, fügen Sie ein Bankkonto hinzu und weisen Sie nach, dass der/die Kontoinhaber/in den Stripe-Rahmenvertrag akzeptiert hat. Stripe verlangt, dass das verbundene Konto den Rahmenvertrag von Stripe explizit akzeptiert, bevor Auszahlungen getätigt werden. In diesem Beispiel ist der business_type auf company festgelegt, um ein komplexeres Szenario zu veranschaulichen. Das external_account nutzt ein mit Token versehenes Stripe-Testkonto als Erinnerung, um zu vermeiden, dass sensible Informationen in den API-Aufrufen offengelegt werden.

Sie können ein verbundenes Konto entweder mit den Controller-Eigenschaften oder durch Festlegen des Kontotyps erstellen. In beiden Fällen müssen Sie das Land festlegen und die Funktionen card_payments und transfers anfordern.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d country=US \
  -d "controller[losses][payments]"=application \
  -d "controller[fees][payer]"=application \
  -d "controller[stripe_dashboard][type]"=none \
  -d "controller[requirement_collection]"=application \
  -d business_type=company \
  -d "capabilities[card_payments][requested]"=true \
  -d "capabilities[transfers][requested]"=true \
  -d external_account=btok_us \
  -d "tos_acceptance[date]"=1547923073 \
  -d "tos_acceptance[ip]"="172.18.80.19"

An dieser Stelle wird das Konto erstellt, Zahlungen und Auszahlungen sind jedoch weiterhin deaktiviert. Überprüfen Sie in der Antwort das Array requirements.currently_due, um zu bestimmen, welche Informationen erfasst werden müssen:

{
  "id": 
"{{CONNECTED_ACCOUNT_ID}}",
  "object": "account",
  "requirements": {
    "currently_due": [
      "business_profile.mcc",
      "business_profile.url",
      "company.address.city",
      "company.address.line1",
      "company.address.postal_code",
      "company.address.state",
      "company.name",
      "company.phone",
      "company.tax_id",
      "relationship.representative",
      "relationship.owner"
    ],
    ...
  },
  ...
}

Verwenden Sie dann die in der Antwort zurückgegebene id des externen Kontos, um das Konto mit den zusätzlichen erforderlichen Kontoangaben zu aktualisieren:

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "business_profile[mcc]"=5045 \
  --data-urlencode "business_profile[url]"="https://bestcookieco.com" \
  -d "company[address][city]"=Schenectady \
  -d "company[address][line1]"="123 State St" \
  -d "company[address][postal_code]"=12345 \
  -d "company[address][state]"=NY \
  -d "company[tax_id]"=000000000 \
  -d "company[name]"="The Best Cookie Co" \
  -d "company[phone]"=8888675309

Nach erfolgreicher Aktualisierung der Unternehmensdetails zeigt die Überprüfung von requirements.currently_due, dass die relationship-Anforderungen weiterhin erforderlich sind:

{
  "id": 
"{{CONNECTED_ACCOUNT_ID}}",
  "object": "account",
  "requirements": {
    "currently_due": [
      "relationship.representative",
      "relationship.owner",
    ],
    ...
  },
  ...
}

Verwenden Sie die Persons API, um ein Profil für die Person zu erstellen, die die Beziehung zum Konto repräsentiert. In diesem Beispiel erstellen wir ein Profil für Jenny Rosen und kennzeichnen sie als representative. In diesem Beispiel haben wir außerdem das optionale Attribut title ausgefüllt.

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/persons \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d first_name=Jenny \
  -d last_name=Rosen \
  -d "relationship[representative]"=true \
  -d "relationship[title]"=CEO

Wenn Sie eine Person erstellen, enthält die Antwort einen requirements-Hash. Dieser führt die erforderlichen Verifizierungsinformationen für die jeweilige Person auf.

{
  "id": 
"{{CONNECTED_ACCOUNT_ID}}",
  "object": "account",
  "requirements": {
    "currently_due": [
      "address.city",
      "address.line1",
      "address.postal_code",
      "address.state",
      "dob.day",
      "dob.month",
      "dob.year",
      "phone",
      "email",
      "relationship.executive",
      "ssn_last_4"
    ],
    ...
  },
  ...
}

Nachdem Sie eine Person für Ihr externes Konto erstellt haben, wird durch Überprüfen des Account-Objekts festgestellt, dass die erforderlichen Verifizierungsinformationen für die neu erstellte Person zur Liste requirements.currently_due hinzugefügt wurden:

{
  "id": 
"{{CONNECTED_ACCOUNT_ID}}",
  "object": "account",
  "requirements": {
    "currently_due": [
      "person.person_xxx.address.city",
      "person.person_xxx.address.line1",
      "person.person_xxx.address.postal_code",
      "person.person_xxx.address.state",
      "person.person_xxx.dob.day",
      "person.person_xxx.dob.month",
      "person.person_xxx.dob.year",
      "person.person_xxx.phone",
      "person.person_xxx.email",
      "person.person_xxx.relationship.executive",
      "person.person_xxx.ssn_last_4",
      "relationship.owner"
    ],
    ...
  },
  ...
}

Verwenden Sie die API Aktualisieren einer Person, um die angeforderten Verifizierungsinformationen für Jenny Rosen bereitzustellen:

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/persons/
{{PERSON_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "address[city]"=Schenectady \
  -d "address[line1]"="123 State St" \
  -d "address[postal_code]"=12345 \
  -d "address[state]"=NY \
  -d "dob[day]"=10 \
  -d "dob[month]"=11 \
  -d "dob[year]"=1980 \
  -d ssn_last_4=0000 \
  -d phone=8888675309 \
  --data-urlencode email="jenny@bestcookieco.com" \
  -d "relationship[executive]"=true

Indem Sie relationship[executive]=true festlegen, versichern Sie gegenüber Stripe, dass es sich bei dem/der Vertreter/in um eine Person mit maßgeblicher Führungsrolle innerhalb der Organisation handelt. Unter für die USA erforderlichen Verifizierungsinformationen finden Sie weitere Informationen zu den Details zur Verifizierung von Unternehmensvertreter/innen für US-Unternehmen.

Nach der Angabe der Informationen zum representative muss noch der owner des Kontos ermittelt werden. In diesem Beispiel besitzt Kathleen Banks 80 % von The Best Cookie Co.

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/persons \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d first_name=Kathleen \
  -d last_name=Banks \
  --data-urlencode email="kathleen@bestcookieco.com" \
  -d "relationship[owner]"=true \
  -d "relationship[percent_ownership]"=80

In unserem Beispiel besitzt Kathleen Banks weniger als 100 % von The Best Cookie Co. Sie haben keine weiteren Inhaber/innen festgelegt, um die Inhaberschaft auf 100 % zu vervollständigen. Stripe benötigt daher von Ihnen eine Bestätigung, dass Sie alle erforderlichen Inhaber/innen angegeben haben.

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "company[owners_provided]"=true

Die erfolgreiche Einrichtung Ihres verbundenen Kontos in dieser Phase bedeutet, dass:

• Sie haben alle erforderlichen Informationen ausgefüllt (requirements.currently_due=null).
• Zahlungen für das Konto (charges_enabled=true) aktiviert werden.
• Sie einen account.updated Webhook von Stripe erhalten haben.

Testschwellen

Unabhängig davon, ob Sie Onboarding im Voraus oder inkrementelles Onboarding durchführen, kann Stripe bei Erreichen verschiedener Schwellenwerte weitere Informationen zu verbundenen Konten anfordern. Diese Schwellenwerte werden manchmal durch Überprüfungsfehler oder OFAC-Prüfungen ausgelöst. In anderen Fällen werden sie durch eine Verarbeitungs- oder Zeitkomponente ausgelöst. Beispielsweise können nach einer Zahlung von 1.500 USD oder 30 Tage nach Erstellung eines Kontos (je nachdem, was zuerst eintritt) weitere Informationen angefordert werden. Prüfen Sie das Array requirements.eventually_due und den Zeitstempel requirements.current_deadline, um herauszufinden, welche Informationen wann erforderlich sind.

In einigen Fällen, wenn Sie bis zu einem bestimmten Datum keine neuen Informationen erfassen, werden Zahlungen und payouts möglicherweise deaktiviert, bis Sie diese erfassen. Sie können diese Szenarien auslösen, um diese Schwellenwerte zu testen und dann die erforderlichen Informationen zu erfassen.

Auslöseschwellen

Sie können mit dem Verifizierungs-Token (tok_visa_triggerVerification) eine Zahlung erstellen, um einen allgemeinen Verifizierungsgrenzwert auszulösen. Dadurch werden weder Zahlungen noch Auszahlungen blockiert, jedoch wird die Anforderung zusätzlicher Informationen ausgelöst. Wenn Sie den Webhook account.updated beobachten, können Sie Folgendes prüfen:

• requirements.currently_due, um zu ermitteln, welche Informationen erforderlich sind.
• requirements.current_deadline, um herauszufinden, wann die Informationen benötigt werden.

Wenn die Informationen nicht bis zum current_deadline erfasst werden, können Zahlungen und Auszahlungen deaktiviert werden. Solche und ähnliche Szenarien können Sie in den nachfolgenden Abschnitten zum Blockieren von Zahlungen und Auszahlungen testen.

Sie können auch genauere Verifizierungsschwellen auslösen, zum Beispiel, wenn die Identität nicht übereinstimmt oder die OFAC-Schwelle erreicht wird. Es ist hilfreich, diese Schwellen zu testen, da sie häufig der Grund sind, wenn die Verifizierung fehlschlägt.

Blockierte Zahlungen testen

Sie können Zahlungen blockieren, indem Sie mit dem Token Zahlung blockieren (tok_visa_triggerChargeBlock) eine Testzahlung erstellen. Anschließend sollten Sie den Webhook account.updated erhalten, der Folgendes anzeigt:

• charges_enabled=false.
• Die erforderlichen Informationen im requirements.currently_due-Array.
• Ein leeres requirements.eventually_due-Array.

Sie können das Konto mit neuen Informationen aktualisieren. Dadurch wird ein weiterer Webhook ausgelöst, der signalisiert, dass Zahlungen aktiviert sind und dass die Zeilen requirements.currently_due and requirements.eventually_due leer sind.

Blockierte Auszahlungen testen

Sie können Auszahlungen blockieren, indem Sie mit dem Token Transfer blockieren (tok_visa_triggerTransferBlock) eine Test-Zahlung erstellen. Anschließend sollten Sie den Webhook account.updated erhalten, der Folgendes anzeigt:

• payouts_enabled=false.
• Die erforderlichen Informationen im requirements.currently_due-Array.
• Ein leeres requirements.eventually_due-Array.

Sie können das Konto mit neuen Informationen aktualisieren. Dadurch wird ein weiterer Webhook ausgelöst, der signalisiert, dass Auszahlungen aktiviert sind und dass die Zeilen requirements.currently_due and requirements.eventually_due leer sind.