Empfänger/in für globale Auszahlungen mit der API erstellenÖffentliche Vorschau

Erstellen Sie einen Ablauf zur Datenerfassung für Ihre Empfänger/innen, um Details zu Empfänger/innen und Auszahlungen zu erfassen, und übergeben Sie diese Informationen dann über unsere APIs an Stripe.

Überlegungen

Ihr Unternehmen ist für alle Interaktionen mit Ihren Empfänger/innen und für die Erfassung aller notwendigen Informationen zur Verifizierung verantwortlich. Stripe aktualisiert die Anforderungen an den/die Empfänger/in, wenn sich Gesetze und Vorschriften weltweit ändern.

Überlegen Sie beim Erstellen einer Integration für Auszahlungen, wie Sie Folgendes handhaben:

• Regelmäßige Überprüfung von Änderungen der rechtlichen und regulatorischen Anforderungen.
• Aktualisierung Ihrer Anwendungslogik als Reaktion auf diese Änderungen.

Planen Sie, die Onboarding-Anforderungen regelmäßig zu prüfen und zu aktualisieren, um fehlgeschlagene Auszahlungen zu vermeiden.

Empfänger/in erstellen

Wenn Sie ein Formular verwenden, um Empfängerdaten für Auszahlungen zu erfassen, verwenden Sie die Accounts v2 API, um eine/n Empfänger/in zu erstellen. Sie müssen die folgenden Parameter angeben, um die Konto-ID zu erstellen:

Sie müssen Ihre gewünschten Auszahlungsmethoden mit der Accounts v2 API angeben, da einige Methoden zusätzliche Informationen über Ihre/n Empfänger/in erfordern, bevor wir sie aktivieren können. capabilitiesDie Methoden, die Sie mit dem Parameter capabilities aktivieren, bestimmen die Informationen, die Sie für Ihre Empfänger/innen erfassen müssen. Beispielsweise erfordert configuration.recipient.capabilities.bank_accounts.local für eine/n US-Empfänger/in, dass Sie eine Kontonummer und eine Routingnummer angeben.

Für eine/n Empfänger/in können mehrere Auszahlungsmethoden aktiviert sein. Nicht alle Auszahlungsmethoden sind für Empfänger/innen in allen Ländern verfügbar. Siehe die vollständige Liste der verfügbaren Auszahlungsmethoden nach Land.

Nachdem Sie diese Felder hinzugefügt und Auszahlungsmethoden angefordert haben, ermittelt Stripe die zusätzlichen Informationen, die in der API-Antwort erforderlich sind und übermittelt werden müssen, damit der/die Empfänger/in für den Empfang von Auszahlungen bereit ist. Um diese Anforderungen zu erhalten, fügen Sie requirements, configuration.recipient und identity im include-Array ein. Andernfalls gibt Stripe unabhängig vom tatsächlichen Wert eine Null-Antwort zurück.

Wenn Sie ein Konto erstellen, abrufen oder aktualisieren, werden bestimmte Felder in der Antwort nur ausgefüllt, wenn Sie sie im Parameter include angeben. Für alle diese Felder, die Sie nicht angeben, enthält die Antwort sie unabhängig von ihrem tatsächlichen Wert als Null.

curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: {{STRIPE_API_VERSION}}" \
  --json '{
    "contact_email": "jenny.rosen@example.com",
    "display_name": "Jenny Rosen",
    "identity": {
        "country": "us",
        "entity_type": "individual"
    },
    "configuration": {
        "recipient": {
            "capabilities": {
                "bank_accounts": {
                    "local": {
                        "requested": true
                    }
                }
            }
        }
    },
    "include": [
        "identity",
        "configuration.recipient",
        "requirements"
    ]
  }'

Erforderliche Felder zur Aktivierung eines Empfängers/einer Empfängerin bestimmen

Verwenden Sie die Antwort von der Accounts v2 API, um die requirements.entries zu prüfen und die spezifischen Felder zu bestimmen, die Sie an Stripe übermitteln müssen. Alle entries mit dem Feld restricts_capabilities sind erforderlich, damit der/die Empfänger/in Auszahlungen annehmen kann.

{
 "id": "{{CONNECTED_ACCOUNT_ID}}",
 "object": "v2.core.account",
 "applied_configurations": [
   "recipient"
 ],
 "configuration": {
   "customer": null,
   "merchant": null,
   "recipient": {

Empfängerinformationen an Stripe senden

Nachdem Sie die zusätzlichen Felder bestimmt haben, die Sie einreichen müssen, verwenden Sie die Accounts v2 API, um die erforderlichen Informationen einzureichen. Verwenden Sie die id aus der obigen Antwort in der URI.

curl -X POST https://api.stripe.com/v2/core/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: {{STRIPE_API_VERSION}}" \
  --json '{
    "contact_email": "jenny.rosen@example.com",
    "display_name": "Jenny Rosen",
    "identity": {
        "country": "us",
        "entity_type": "individual",
        "individual": {
            "given_name": "Jenny",
            "surname": "Rosen",
            "address": {
                "city": "Brothers",
                "country": "US",
                "line1": "27 Fredrick Ave",
                "postal_code": "97712",
                "state": "OR"
            }
        }
    },
    "include": [
        "identity"
    ]
  }'

Bestätigen, dass der/die Empfänger/in aktiviert ist

Verwenden Sie die Accounts v2 API, um ein Konto abzurufen und den status der von Ihnen angeforderten Funktionen zu überprüfen. Der status muss active sein, damit Empfänger/innen Auszahlungen über die von Ihnen angegebene Auszahlungsmethode erhalten können.

curl -G https://api.stripe.com/v2/core/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: {{STRIPE_API_VERSION}}" \
  -d "include[0]"="configuration.recipient"

Auszahlungsmethoden für Ihre Empfänger/innen erstellen

Verwenden Sie die Schaltfläche OutboundSetupIntents v2 API, um Auszahlungsmethodendetails an Stripe zu senden und so eine Auszahlung an eine Empfängerin/einen Empfänger zu ermöglichen.

Der Stripe-Kontext-Header in dieser Anfrage muss die Konto-ID des Empfängers sein.

curl -X POST https://api.stripe.com/v2/money_management/outbound_setup_intents \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: {{STRIPE_API_VERSION}}" \
  -H "Stripe-Context: 
{{CONTEXT}}
" \
  --json '{
    "payout_method_data": {
        "type": "bank_account",
        "bank_account": {
            "country": "FR",
            "account_number": "FR76300060000112345678901234"
        }
    }
  }'

Um Auszahlungen per Überweisung zu senden, verwenden Sie die USBankAccount v2 API, um die fedwire_routing_number zur Auszahlungsmethode hinzuzufügen. Es fallen zusätzliche Gebühren an. Weitere Informationen finden Sie unter Preisgestaltung.

Sie können auch Debitkarten als Auszahlungsmethode verwenden. Ihre Empfänger/innen müssen ihre Debitkarteninformationen jedoch direkt an Stripe übermitteln. Wenn Sie Auszahlungen per Debitkarte aktivieren möchten, verwenden Sie die Account Links v2 API, um ein gemeinsam nutzbares Formular zu erstellen, mit dem Ihre Nutzer/innen ihre Debitkarten-Anmeldedaten übermitteln können.

Alle Auszahlungsmethoden für eine/n Empfänger/in anzeigen

Zeigen Sie alle erstellten Auszahlungsmethoden für eine/n Empfänger/in an. Rufen Sie die Payout Methods API v2 auf und geben Sie die Empfänger-ID an.

Der Stripe-Kontext-Header in dieser Anfrage muss die Konto-ID des Empfängers sein.

curl https://api.stripe.com/v2/money_management/payout_methods \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: {{STRIPE_API_VERSION}}" \
  -H "Stripe-Context: 
{{CONTEXT}}
"

Die Antwort enthält eine Liste der PayoutMethod-Objekte, die im Besitz eines Empfängers/einer Empfängerin sind. Verwenden Sie die PayoutMethod-IDs, um eine Auszahlung mit der OutboundPayments API vorzunehmen. Weitere Informationen finden Sie unter Geld senden.