# Destination Charges erstellen

Erstellen Sie Zahlungen auf Ihrem Plattformkonto, ziehen Sie Gebühren ein und übertragen Sie die verbleibenden Gelder sofort auf Ihre verbundenen Konten.

Erstellen Sie *Destination Charges*, wenn Kundinnen/Kunden mit Ihrer Plattform im Zusammenhang mit Produkten oder Dienstleistungen interagieren, die von Ihren verbundenen Konten zur Verfügung gestellt werden, und Sie sofort Gelder an Ihre verbundenen Konten überweisen. Mit diesem Zahlungstyp:

- Sie erstellen eine Abbuchung auf dem Konto Ihrer Plattform.
- Sie bestimmen, ob diese Gelder teilweise oder vollständig auf das verbundene Konto übertragen werden sollen.
- Ihr Kontoguthaben wird mit Stripe-Gebühren, Rückerstattungen und Rückbuchungen belastet.

Diese Art der Zahlung eignet sich am besten für Marktplätze wie Airbnb, einen Marktplatz für Unterkünfte, oder Lyft, eine Mitfahr-App.

Mit [einigen Ausnahmen](https://docs.stripe.com/connect/account-capabilities.md#transfers-cross-border) müssen Sie, wenn Ihre Plattform und ein verbundenes Konto nicht in derselben Region sind, das verbundene Konto als [Abwicklungshändler/in](https://docs.stripe.com/connect/destination-charges.md#settlement-merchant) angeben, indem Sie den Parameter `on_behalf_of` in [Payment Intent](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-on_behalf_of) oder `payment_intent_data.on_behalf_of` in [Checkout Session](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_intent_data-on_behalf_of) verwenden.

Wir empfehlen, Destination Charges für verbundene Konten zu verwenden, die keinen Zugriff auf das vollständige Stripe-Dashboard haben.
![](https://b.stripecdn.com/docs-statics-srv/assets/ios-overview.9e0d68d009dc005f73a6f5df69e00458.png)

Diese Integration vereint alle für die Zahlung erforderlichen Schritte, einschließlich der Erfassung der Zahlungsdaten und der Bestätigung der Zahlung, in einem einzigen Fenster, das über Ihrer App angezeigt wird.

> #### Support für die Accounts v2 API
> 
> Das Payment Sheet unterstützt *von Kund/innen konfigurierte Konten* nicht. Es unterstützt nur `Kund/innen`-Objekte.

## Stripe einrichten [Serverseitig] [Clientseitig]

Zunächst benötigen Sie ein Stripe-Konto. [Registrieren Sie sich jetzt](https://dashboard.stripe.com/register).

### Serverseitig

Für diese Integration sind Endpoints auf Ihrem Server erforderlich, die mit der Stripe-API kommunizieren können. Nutzen Sie die offiziellen Bibliotheken für den Zugriff auf die Stripe-API von Ihrem Server aus:

#### Ruby

```bash
# Available as a gem
sudo gem install stripe
```

```ruby
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'
```

### Clientseitig

Das [React Native SDK](https://github.com/stripe/stripe-react-native) ist Open Source und vollständig dokumentiert. Intern werden [native iOS](https://github.com/stripe/stripe-ios) und [Android](https://github.com/stripe/stripe-android) SDKs verwendet. Um das React Native SDK von Stripe zu installieren, führen Sie einen der folgenden Befehle im Verzeichnis Ihres Projekts aus (je nachdem, welchen Paket-Manager Sie verwenden):

#### yarn

```bash
yarn add @stripe/stripe-react-native
```

#### npm

```bash
npm install @stripe/stripe-react-native
```

Installieren Sie als Nächstes einige weitere erforderliche Abhängigkeiten:

- Für iOS wechseln Sie bitte in das Verzeichnis **ios** und führen Sie den Befehl `pod install` aus, um sicherzustellen, dass auch die erforderlichen nativen Abhängigkeiten installiert werden.
- Für Android müssen keine Abhängigkeiten mehr installiert werden.

> Wir empfehlen Ihnen, die [offizielle Anleitung zu TypeScript](https://reactnative.dev/docs/typescript#adding-typescript-to-an-existing-project) zu befolgen, um TypeScript zu unterstützen.

### Stripe Initialisierung

Um Stripe in Ihrer React Native-App zu initialisieren, umschließen Sie entweder Ihren Zahlungsbildschirm mit der Komponente `StripeProvider` oder verwenden Sie die Initialisierungsmethode `initStripe`. Nur der [veröffentlichbare API-Schlüssel](https://docs.stripe.com/keys.md#obtain-api-keys) in `publishableKey` ist erforderlich. Das folgende Beispiel zeigt, wie Stripe mithilfe der Komponente `StripeProvider` initialisiert wird.

```jsx
import { useState, useEffect } from 'react';
import { StripeProvider } from '@stripe/stripe-react-native';

function App() {
  const [publishableKey, setPublishableKey] = useState('');

  const fetchPublishableKey = async () => {
    const key = await fetchKey(); // fetch key from your server here
    setPublishableKey(key);
  };

  useEffect(() => {
    fetchPublishableKey();
  }, []);

  return (
    <StripeProvider
      publishableKey={publishableKey}
      merchantIdentifier="merchant.identifier" // required for Apple Pay
      urlScheme="your-app" // required for 3D Secure and bank redirects
    >
      {/* Your app code here */}
    </StripeProvider>
  );
}
```

> Verwenden Sie Ihre API-[Testschlüssel](https://docs.stripe.com/keys.md#obtain-api-keys) beim Testen und Entwickeln Ihrer App und Ihre [Live-Modus](https://docs.stripe.com/keys.md#test-live-modes)-Schlüssel beim Veröffentlichen Ihrer App.

## Endpoint hinzufügen [Serverseitig]

> #### Hinweis
> 
> Um das PaymentSheet vor dem Erstellen eines PaymentIntent anzuzeigen, finden Sie weitere Informationen unter [Erfassen von Zahlungsdetails vor dem Erstellen eines Intent](https://docs.stripe.com/payments/accept-a-payment-deferred.md?type=payment).

Diese Integration verwendet drei Stripe-API-Objekte:

1. [PaymentIntent](https://docs.stripe.com/api/payment_intents.md): Stripe verwendet diesen, um Ihre Absicht darzustellen, Zahlungen von Ihren Kundinnen/Kunden anzufordern, wobei Abbuchungsversuche und Zahlungsstatusänderungen im gesamten Vorgang dokumentiert werden.
2. (Optional) [Kunde/Kundin](https://docs.stripe.com/api/customers.md): Um eine Zahlungsmethode für zukünftige Zahlungen einzurichten, müssen Sie sie einer Kundin oder einem Kunden zuordnen. Erstellen Sie ein Objekt, das Ihre Kundin oder Ihren Kunden repräsentiert, wenn er/sie ein Konto bei Ihrem Unternehmen erstellt. Wenn Ihre Kundin oder Ihr Kunde eine Zahlung als Gast tätigt, können Sie vor der Zahlung ein `Customer`-Objekt erstellen und es später mit Ihrer eigenen internen Darstellung des Kundenkontos verknüpfen.
3. (Optional) [CustomerSession](https://docs.stripe.com/api/customer_sessions.md): Informationen zum Objekt, das Ihre Kundin oder Ihren Kunden repräsentiert, sind vertraulich und können nicht direkt aus einer App abgerufen werden. Eine `CustomerSession` gewährt dem SDK temporären, eingeschränkten Zugriff auf den `Customer` und bietet zusätzliche [Konfigurationsoptionen](https://docs.stripe.com/api/customer_sessions/create.md#create_customer_session-components).

> Wenn Sie niemals Karten für Kundinnen und Kunden speichern, können Sie das `Customer`-Objekt und das `CustomerSession`-Objekt in Ihrer Integration weglassen.

Aus Sicherheitsgründen kann Ihre App diese Objekte nicht erstellen. Fügen Sie stattdessen einen Endpoint auf Ihrem Server hinzu, der:

1. Ruft das `Customer`-Objekt ab oder erstellt ein neues.
2. Erstellt eine [CustomerSession](https://docs.stripe.com/api/customer_sessions.md) für den `Customer`.
3. Erstellt einen `PaymentIntent` mit dem [Betrag](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-amount), der [Währung](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-currency) und [der Kundin oder dem Kunden](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-customer).
4. Gibt das *Client-Geheimnis* (The client secret is a unique key returned from Stripe as part of a PaymentIntent. This key lets the client access important fields from the PaymentIntent (status, amount, currency) while hiding sensitive ones (metadata, customer)) des `PaymentIntent`, das `client_secret` der `CustomerSession`, die ID des `Customer` und Ihren [veröffentlichbaren Schlüssel](https://dashboard.stripe.com/apikeys) an Ihre App zurück.

Legen Sie für den `PaymentIntent` denselben `Customer` fest, den Sie für die `CustomerSession` festgelegt haben.

Die Zahlungsmethoden, die Kund/innen während des Bezahlvorgangs angezeigt werden, sind ebenfalls in der PaymentIntent enthalten. Sie können Stripe Zahlungsmethoden aus Ihren Dashboard-Einstellungen abrufen lassen oder sie manuell auflisten. Gleich welche Option Sie wählen, die in der PaymentIntent übergebene Währung filtert die Zahlungsmethoden, die dem/r Kund/in angezeigt werden. Wenn Sie beispielsweise `eur` für den PaymentIntent übergeben und OXXO im Dashboard aktiviert ist, wird dem/r Kund/in OXXO nicht angezeigt, da OXXO `eur`-Zahlungen nicht unterstützt.

Sofern Ihre Integration keine codebasierte Option zum Anbieten von Zahlungsmethoden erfordert, empfiehlt Stripe die automatisierte Option, da Stripe die Währung, Einschränkungen für Zahlungsmethoden und andere Parameter auswertet, um die Liste der unterstützten Zahlungsmethoden zu ermitteln. Zahlungsmethoden, die die Konversion steigern und die für die Währung und den Standort des/r Kund/in am relevantesten sind, erhalten Priorität.

#### Zahlungsmethoden über das Dashboard verwalten

Sie können Zahlungsmethoden über das [Dashboard](https://dashboard.stripe.com/settings/payment_methods) verwalten. Stripe erstellt den `PaymentIntent` mithilfe der von Ihnen konfigurierten zulässigen Zahlungsmethoden ausgehend von Faktoren wie dem Betrag, der Währung und dem Zahlungsablauf der Transaktion. Wenn Sie das Dashboard nicht nutzen oder die zulässigen Zahlungsmethoden manuell angeben möchten, können Sie den Parameter `allowed_payment_method_types` verwenden.

#### Curl

```bash
# Create a Customer (use an existing Customer ID if this is a returning customer)
curl https://api.stripe.com/v1/customers \
  -u <<YOUR_SECRET_KEY>>: \
  -X "POST" \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}"

# Create a CustomerSession for the Customer
curl https://api.stripe.com/v1/customer_sessions \
  -u <<YOUR_SECRET_KEY>>: \
  -X "POST" \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "components[mobile_payment_element][enabled]"=true \
  -d "components[mobile_payment_element][features][payment_method_save]"=enabled \
  -d "components[mobile_payment_element][features][payment_method_redisplay]"=enabled \
  -d "components[mobile_payment_element][features][payment_method_remove]"=enabled

# Create a PaymentIntent
curl https://api.stripe.com/v1/payment_intents \
  -u <<YOUR_SECRET_KEY>>: \
  -X "POST" \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "amount"=1099 \
  -d "currency"="eur" \

  -d "automatic_payment_methods[enabled]"=true \
  -d application_fee_amount="123" \
  -d "transfer_data[destination]"="{{CONNECTED_ACCOUNT_ID}}" \
```

#### Zahlungsmethoden manuell auflisten

#### Curl

```bash
# Create a Customer (use an existing Customer ID if this is a returning customer)
curl https://api.stripe.com/v1/customers \
  -u <<YOUR_SECRET_KEY>>: \
  -X "POST" \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}"

# Create a CustomerSession for the Customer
curl https://api.stripe.com/v1/customer_sessions \
  -u <<YOUR_SECRET_KEY>>: \
  -X "POST" \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "components[mobile_payment_element][enabled]"=true \
  -d "components[mobile_payment_element][features][payment_method_save]"=enabled \
  -d "components[mobile_payment_element][features][payment_method_redisplay]"=enabled \
  -d "components[mobile_payment_element][features][payment_method_remove]"=enabled

# Create a PaymentIntent
curl https://api.stripe.com/v1/payment_intents \
  -u <<YOUR_SECRET_KEY>>: \
  -X "POST" \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "amount"=1099 \
  -d "currency"="eur" \
  -d "allowed_payment_method_types[]"="bancontact" \
  -d "allowed_payment_method_types[]"="card" \
  -d "allowed_payment_method_types[]"="ideal" \
  -d "allowed_payment_method_types[]"="klarna" \
  -d "allowed_payment_method_types[]"="sepa_debit" \
  -d application_fee_amount="123" \
  -d "transfer_data[destination]"="{{CONNECTED_ACCOUNT_ID}}" \
```

> Jede Zahlungsmethode muss die im PaymentIntent übergebene Währung unterstützen, und Ihr Unternehmen muss in einem der Länder ansässig sein, die jede Zahlungsmethode unterstützt. Auf der Seite [Optionen für die Integration von Zahlungsmethoden](https://docs.stripe.com/payments/payment-methods/integration-options.md) finden Sie weitere Informationen zu den unterstützten Zahlungsmethoden.

## Zahlungsformular integrieren [Clientseitig]

Bevor das mobile Payment Element angezeigt wird, sollte Ihr Checkout-Seite folgendes anzeigen:

- Die gekauften Produkte und den Gesamtbetrag anzeigen
- Alle benötigten Versanddaten erfassen
- Fügen Sie eine Checkout-Schaltfläche ein, um die Nutzeroberfläche von Stripe anzuzeigen

Erstellen Sie im Bezahlvorgang Ihrer App eine Netzwerkanfrage an den im vorigen Schritt erstellten Backend-Endpoint und rufen Sie `initPaymentSheet` aus dem `useStripe`-Hook auf.

```javascript

export default function CheckoutScreen() {
  const { initPaymentSheet, presentPaymentSheet } = useStripe();
  const [loading, setLoading] = useState(false);

  const fetchPaymentSheetParams = async () => {
    const response = await fetch(`${API_URL}/payment-sheet`, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
      },
    });
    const { paymentIntent, ephemeralKey, customer } = await response.json();

    return {
      paymentIntent,
      ephemeralKey,
      customer,
    };
  };

  const initializePaymentSheet = async () => {
    const {
      paymentIntent,
      ephemeralKey,
      customer,
    } = await fetchPaymentSheetParams();

    const { error } = await initPaymentSheet({
      merchantDisplayName: "Example, Inc.",
      customerId: customer,
      customerEphemeralKeySecret: ephemeralKey,
      paymentIntentClientSecret: paymentIntent,
      // Set `allowsDelayedPaymentMethods` to true if your business can handle payment
      //methods that complete payment after a delay, like SEPA Debit and Sofort.
      allowsDelayedPaymentMethods: true,
      defaultBillingDetails: {
        name: 'Jane Doe',
      }
    });
    if (!error) {
      setLoading(true);
    }
  };

  const openPaymentSheet = async () => {
    // see below
  };

  useEffect(() => {
    initializePaymentSheet();
  }, []);

  return (
    <Screen>
      <Button
        variant="primary"
        disabled={!loading}
        title="Checkout"
        onPress={openPaymentSheet}
      />
    </Screen>
  );
}
```

Wenn Ihr/e Kund/in auf die Schaltfläche **Checkout** tippt, rufen Sie bitte `presentPaymentSheet()` auf, um das Formular anzuzeigen. Nachdem der/die Kund/in die Zahlung abgeschlossen hat, wird das Formular verworfen und das Promise mit einem optionalen `StripeError<PaymentSheetError>` aufgelöst.

```javascript
export default function CheckoutScreen() {
  // continued from above

  const openPaymentSheet = async () => {
    const { error } = await presentPaymentSheet();

    if (error) {
      Alert.alert(`Error code: ${error.code}`, error.message);
    } else {
      Alert.alert('Success', 'Your order is confirmed!');
    }
  };

  return (
    <Screen>
      <Button
        variant="primary"
        disabled={!loading}
        title="Checkout"
        onPress={openPaymentSheet}
      />
    </Screen>
  );
}
```

Wenn kein Fehler auftritt, informieren Sie den/die Kund/in, dass der Vorgang abgeschlossen ist (zum Beispiel durch die Anzeige einer Bestellbestätigung).

Wenn Sie `allowsDelayedPaymentMethods` auf true festlegen, werden Zahlungsmethoden mit [verzögerter Benachrichtigung](https://docs.stripe.com/payments/payment-methods.md#payment-notification) wie US-Bankkonten zugelassen. Für diese Zahlungsmethoden ist der endgültige Zahlungsstatus nicht bekannt, wenn das `PaymentSheet` abgeschlossen wird. Stattdessen ist sie erfolgreich oder schlägt fehl. Wenn Sie diese Art von Zahlungsmethoden unterstützen, informieren Sie den Kunden/die Kundin darüber, dass seine/ihre Bestellung bestätigt ist, und führen seine/ihre Bestellung erst aus (z. B. das Produkt versenden), wenn die Zahlung erfolgreich ist.

## Rückgabe-URL einrichten (nur für iOS) [Clientseitig]

Der Kunde/Die Kundin verlässt ggf. Ihre App, um sich zu authentifizieren (z.&nbsp;B. in Safari oder einer Banking-App). Damit sie nach der Authentifizierung automatisch zu Ihrer App zurückkehren können, [konfigurieren Sie ein benutzerdefiniertes URL-Schema](https://developer.apple.com/documentation/xcode/defining-a-custom-url-scheme-for-your-app) und richten Sie Ihren App-Delegate so ein, dass die URL an das SDK weitergeleitet wird. Stripe unterstützt keine [universellen Links](https://developer.apple.com/documentation/xcode/allowing-apps-and-websites-to-link-to-your-content).

#### SceneDelegate

#### Swift

```swift
// This method handles opening custom URL schemes (for example, "your-app://stripe-redirect")
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else {
        return
    }
    let stripeHandled = StripeAPI.handleURLCallback(with: url)
    if (!stripeHandled) {
        // This was not a Stripe url – handle the URL normally as you would
    }
}

```

#### AppDelegate

#### Swift

```swift
// This method handles opening custom URL schemes (for example, "your-app://stripe-redirect")
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
    let stripeHandled = StripeAPI.handleURLCallback(with: url)
    if (stripeHandled) {
        return true
    } else {
        // This was not a Stripe url – handle the URL normally as you would
    }
    return false
}
```

#### SwiftUI

#### Swift

```swift

@main
struct MyApp: App {
  var body: some Scene {
    WindowGroup {
      Text("Hello, world!")
        .onOpenURL { incomingURL in
          let stripeHandled = StripeAPI.handleURLCallback(with: incomingURL)
          if (!stripeHandled) {
            // This was not a Stripe url – handle the URL normally as you would
          }
        }
    }
  }
}
```

Legen Sie zusätzlich die [returnURL](https://stripe.dev/stripe-ios/stripe-paymentsheet/Classes/PaymentSheet/Configuration.html#/s:6Stripe12PaymentSheetC13ConfigurationV9returnURLSSSgvp) in Ihrem [PaymentSheet.Configuration](https://stripe.dev/stripe-ios/stripe-paymentsheet/Classes/PaymentSheet/Configuration.html)-Objekt auf die URL für Ihre App fest.

```swift
var configuration = PaymentSheet.Configuration()
configuration.returnURL = "your-app://stripe-redirect"
```

## Ereignisse nach Zahlung verarbeiten

Stripe sendet ein [payment_intent.succeeded](https://docs.stripe.com/api/events/types.md#event_types-payment_intent.succeeded)-Ereignis, wenn die Zahlung abgeschlossen ist. Verwenden Sie [Webhook-Tool im Dashboard](https://dashboard.stripe.com/webhooks) oder folgen Sie der [Webhook-Anleitung](https://docs.stripe.com/webhooks/quickstart.md), um diese Ereignisse zu empfangen und führen Sie Aktionen aus, wie beispielsweise das Senden einer Bestellbestätigung per E-Mail, das Protokollieren des Verkaufs in der Datenbank oder das Starten eines Versand-Workflows.

Überwachen Sie diese Ereignisse, statt auf einen Callback vom Client zu warten. Auf dem Client könnten die Kund/innen das Browserfenster schließen oder die App beenden, bevor der Callback erfolgt ist. Bösartige Clients könnten dann die Antwort manipulieren. Wenn Sie Ihre Integration so einrichten, dass sie asynchrone Ereignisse überwacht, können Sie [verschiedene Arten von Zahlungsmethoden](https://stripe.com/payments/payment-methods-guide) mit einer einzelnen Integration akzeptieren.

Neben der Abwicklung des `payment_intent.succeeded`-Ereignisses empfehlen wir die Abwicklung von diesen weiteren Ereignissen, wenn Sie Zahlungen mit dem Payment Element erfassen:

| Ereignis | Beschreibung | Aktion |
| --- | --- | --- |
| [payment_intent.succeeded](https://docs.stripe.com/api/events/types.md?lang=php#event_types-payment_intent.succeeded) | Wird gesendet, wenn Kundinnen und Kunden eine Zahlung erfolgreich abgeschlossen haben. | Senden Sie den Kund/innen eine Auftragsbestätigung und *wickeln* (Fulfillment is the process of providing the goods or services purchased by a customer, typically after payment is collected) Sie die Bestellung ab. |
| [payment_intent.processing](https://docs.stripe.com/api/events/types.md?lang=php#event_types-payment_intent.processing) | Wird gesendet, wenn eine/e Kund/in eine Zahlung erfolgreich veranlasst hat, die Zahlung aber noch nicht abgeschlossen ist. Dieses Ereignis wird am häufigsten gesendet, wenn der Kunde/die Kundin eine Bankabbuchung veranlasst. In Zukunft folgt darauf entweder ein `payment_intent.succeeded`- oder ein `payment_intent.payment_failed`-Ereignis. | Senden Sie eine Bestellbestätigung an die Kund/innen, in der angegeben ist, dass die Zahlung noch aussteht. Bei digitalen Waren können Sie die Bestellung abwickeln, bevor Sie darauf warten, dass die Zahlung erfolgt. |
| [payment_intent.payment_failed](https://docs.stripe.com/api/events/types.md?lang=php#event_types-payment_intent.payment_failed) | Wird gesendet, wenn ein Kunde/eine Kundin einen Zahlungsversuch durchführt, die Zahlung jedoch fehlschlägt. | Wenn eine Zahlung von `processing` zu `payment_failed` übergeht, bieten Sie der Kundin/dem Kunden einen weiteren Zahlungsversuch an. |

## Integration testen

#### Karten

| Kartennummer | Szenario | So führen Sie den Test durch |
| --- | --- | --- |
| 4242424242424242 | Die Kartenzahlung ist erfolgreich und es ist keine Authentifizierung erforderlich. | Füllen Sie das Kreditkartenformular aus und geben Sie die Kreditkartennummer mit beliebiger Gültigkeitsdauer, CVC und Postleitzahl an. |
| 4000002500003155 | Für die Kartenzahlung ist eine *Authentifizierung* (Strong Customer Authentication (SCA) is a regulatory requirement in effect as of September 14, 2019, that impacts many European online payments. It requires customers to use two-factor authentication like 3D Secure to verify their purchase) erforderlich. | Füllen Sie das Kreditkartenformular aus und geben Sie die Kreditkartennummer mit beliebiger Gültigkeitsdauer, CVC und Postleitzahl an. |
| 4000000000009995 | Die Karte wird mit einem Ablehnungscode wie `insufficient_funds` abgelehnt. | Füllen Sie das Kreditkartenformular aus und geben Sie die Kreditkartennummer mit beliebiger Gültigkeitsdauer, CVC und Postleitzahl an. |
| 6205500000000000004 | Die UnionPay-Karte hat eine variable Länge von 13 bis 19 Ziffern. | Füllen Sie das Kreditkartenformular aus und geben Sie die Kreditkartennummer mit beliebiger Gültigkeitsdauer, CVC und Postleitzahl an. |

#### Bankumleitungen

| Zahlungsmethode | Szenario | So führen Sie den Test durch |
| --- | --- | --- |
| Bancontact, iDEAL | Ihr/e Kund/in konnte sich auf der iDEAL-Weiterleitungsseite für eine auf Weiterleitung basierende Zahlungsmethode mit sofortiger Benachrichtigung nicht authentifizieren. | Wählen Sie eine beliebige, auf Weiterleitung basierende Zahlungsmethode aus, füllen Sie die erforderlichen Informationen aus und bestätigen Sie die Zahlung. Klicken Sie dann auf der Weiterleitungsseite auf **Testzahlung fehlgeschlagen**. |
| Bank-Login | Ihr Kunde/Ihre Kundin zahlt erfolgreich mit einer auf Weiterleitung basierenden Zahlungsmethode mit [verzögerter Benachrichtigung](https://docs.stripe.com/payments/payment-methods.md#payment-notification). | Wählen Sie die Zahlungsmethode aus, füllen Sie die erforderlichen Informationen aus und bestätigen Sie die Zahlung. Klicken Sie dann auf der Weiterleitungsseite auf **Testzahlung abschließen**. |
| Bank-Login | Ihr/e Kund/in konnte sich auf der iDEAL-Weiterleitungsseite für eine auf Weiterleitung basierende Zahlungsmethode mit verzögerter Benachrichtigung nicht authentifizieren. | Wählen Sie die Zahlungsmethode aus, füllen Sie die erforderlichen Informationen aus und bestätigen Sie die Zahlung. Klicken Sie dann auf der Weiterleitungsseite auf **Testzahlung fehlgeschlagen**. |
| BLIK | BLIK-Zahlungen können aus verschiedenen Gründen fehlschlagen. Es gibt sofortige Fehler (der Code ist abgelaufen oder ungültig), verzögerte Fehler (die Bank lehnt ab) oder Zeitüberschreitungen (der/die Kund/in hat nicht rechtzeitig reagiert). | Verwenden Sie E-Mail-Muster, um [die verschiedenen Fehler zu simulieren](https://docs.stripe.com/payments/blik/accept-a-payment.md#simulate-failures) |

#### Banklastschriften

| Zahlungsmethode | Szenario | So führen Sie den Test durch |
| --- | --- | --- |
| SEPA-Lastschrift | Ihr/e Kund/in zahlt erfolgreich mit dem SEPA-Lastschriftverfahren. | Füllen Sie das Formular mit der Kontonummer `AT321904300235473204` aus. Die bestätigte PaymentIntent geht zunächst in den Status „wird verarbeitet“ und dann drei Minuten später in den Status „erfolgreich“ über. |
| SEPA-Lastschrift | Der Status der PaymentIntent Ihres/Ihrer Kund/in wechselt von `processing` zu `requires_payment_method`. | Füllen Sie das Formular mit der Kontonummer `AT861904300235473202` aus. |

Hier finden Sie weitere Informationen zum [Testen](https://docs.stripe.com/testing.md) Ihrer Integration.

## Scannen von Karten aktivieren [Clientseitig]

> Die Aktivierung des Scannens von Karten ist für den iOS-App-Überprüfungsprozess von Apple erforderlich. Für den Android-App-Überprüfungsprozess ist das Scannen von Karten nicht erforderlich, wir empfehlen jedoch, es zu aktivieren.

### iOS

Um die Unterstützung für das Scannen von Karten für iOS zu aktivieren, setzen Sie `NSCameraUsageDescription` (**Datenschutz&nbsp;– Beschreibung Kameranutzung**) in der `Info.plist` Ihrer Anwendung und geben einen Grund für den Zugriff auf die Kamera an (z.&nbsp;B. „Zum Scannen von Karten“).

### (Optional) Android

Um den Support für das Scannen von Karten zu aktivieren, [fordern Sie Produktionszugriff](https://developers.google.com/pay/api/android/guides/test-and-deploy/request-prod-access) auf die Google Pay API über die [Google Pay & Wallet Console](https://pay.google.com/business/console?utm_source=devsite&utm_medium=devsite&utm_campaign=devsite) an.

- Wenn Sie Google Pay aktiviert haben, ist die Funktion zum Scannen von Karten auf berechtigten Geräten automatisch auf unserer Nutzeroberfläche verfügbar. Weitere Informationen zu berechtigten Geräten finden Sie unter den [Einschränkungen der Google Pay API](https://developers.google.com/android/reference/com/google/android/gms/wallet/PaymentsClient#getPaymentCardRecognitionIntent%28com.google.android.gms.wallet.PaymentCardRecognitionIntentRequest%29)
- **Wichtig:** Die Funktion zum Scannen von Karten wird nur in Builds angezeigt, die mit demselben in der [Google Pay & Wallet Console](https://pay.google.com/business/console) registrierten Signaturschlüssel signiert sind. Test- oder Fehlerbehebungs-Builds mit verschiedenen Signaturschlüsseln (z. B. Builds, die über Firebase App Tester verteilt werden) zeigen die Option **Karte scannen** an. Um Karten in Pre-Release-Builds zu testen, müssen Sie entweder:
  - oder Ihre Test-Builds mit Ihrem Produktions-Signaturschlüssel signieren
  - Fingerabdruck Ihres Test-Signaturschlüssels zur Google Pay and Wallet-Konsole hinzufügen

Wenn Ihre App Google Pay nicht unterstützt, können Sie den Stripe-Kartenscanner verwenden.

> Der Stripe-Kartenscanner befindet sich in der öffentlichen Vorschau.

Um den Support für das Scannen von Karten zu aktivieren, fügen Sie dem `dependencies`-Block Ihrer Datei [app/build.gradle](https://developer.android.com/studio/build/dependencies) `stripecardscan` hinzu:

#### Groovy

```groovy
implementation 'com.stripe:stripecardscan:23.26.0'
```

## Optional: Apple Pay aktivieren

### Für eine Apple-Händler-ID registrieren

Beantragen Sie eine Apple-Händler-ID, indem Sie sich auf der Apple Developer-Website [für eine neue Kennung registrieren](https://developer.apple.com/account/resources/identifiers/add/merchant).

Tragen Sie eine Beschreibung und eine Kennung in das Formular ein. Die Beschreibung ist nur für Ihre internen Zwecke bestimmt und kann später geändert werden. Stripe empfiehlt, dass Sie den Namen Ihrer App als Kennung verwenden, zum Beispiel `merchant.com.{{YOUR_APP_NAME}}`.

### Neues Apple Pay-Zertifikat erstellen

Erstellen Sie ein Zertifikat für Ihre App, um Zahlungsdaten zu verschlüsseln.

Gehen Sie zu den [iOS-Zertifikateinstellungen](https://dashboard.stripe.com/settings/ios_certificates) im Dashboard, klicken Sie auf **Neue Anwendung hinzufügen** und befolgen Sie die Anleitung.

Laden Sie eine Certificate Signing Request (CSR)-Datei herunter, um ein sicheres Zertifikat von Apple zu erhalten, mit dem Sie Apple Pay verwenden können.

Eine CSR-Datei muss verwendet werden, um genau ein Zertifikat auszustellen. Wenn Sie Ihre Apple-Händler-ID wechseln, müssen Sie zu den [iOS-Zertifikateinstellungen](https://dashboard.stripe.com/settings/ios_certificates) im Dashboard gehen, um eine neue CSR und ein Zertifikat zu erhalten.

### Mit Xcode integrieren

Fügen Sie Ihrer App die **Apple Pay**-Funktion hinzu. Öffnen Sie in Xcode Ihre Projekteinstellungen, klicken Sie auf die Registerkarte **Signing & Capabilities** (Anmeldung und Funktionen) und fügen Sie die **Apple Pay**-Funktion hinzu. Möglicherweise werden Sie an dieser Stelle aufgefordert, sich bei Ihrem Entwicklerkonto anzumelden. Wählen Sie die zuvor erstellte Händler-ID aus. Ihre App sollte nun Apple Pay unterstützen.
![](https://b.stripecdn.com/docs-statics-srv/assets/xcode.a701d4c1922d19985e9c614a6f105bf1.png)

Apple Pay-Funktion in Xcode aktivieren

### Apple Pay hinzufügen

#### Einmalige Zahlung

Übergeben Sie beim Erstellen von `StripeProvider` Ihre Händler-ID:

```javascript
import { StripeProvider } from '@stripe/stripe-react-native';

function App() {
  return (
    <StripeProvider
      publishableKey="<<YOUR_PUBLISHABLE_KEY>>"
      merchantIdentifier="MERCHANT_ID"
    >
      {/* Your app code here */}
    </StripeProvider>
  );
}
```

Wenn Sie `initPaymentSheet` aufrufen, übergeben Sie Ihre [ApplePayParams](https://stripe.dev/stripe-react-native/api-reference/modules/PaymentSheet.html#ApplePayParams):

```javascript
await initPaymentSheet({
  // ...
  applePay: {
    merchantCountryCode: 'US',
  },
});
```

#### Wiederkehrende Zahlungen

Wenn Sie `initPaymentSheet` aufrufen, übergeben Sie einen [ApplePayParams](https://stripe.dev/stripe-react-native/api-reference/modules/PaymentSheet.html#ApplePayParams), wobei der `merchantCountryCode` auf den Ländercode Ihres Unternehmens gesetzt ist.

Gemäß [den Apple-Richtlinien](https://developer.apple.com/design/human-interface-guidelines/apple-pay#Supporting-subscriptions) für wiederkehrende Zahlungen müssen Sie auch `cardItems` festlegen, die einen [RecurringCartSummaryItem](https://stripe.dev/stripe-react-native/api-reference/modules/ApplePay.html#RecurringCartSummaryItem) mit dem Betrag enthalten, den Sie zu Zahlungen beabsichtigen (z.&nbsp;B. „59,95&nbsp;USD pro Monat“).

Sie können auch [Händler-Token](https://developer.apple.com/apple-pay/merchant-tokens/) übernehmen, indem Sie die den `type` der `request` auf `PaymentRequestType.Recurring` festlegen.

Weitere Informationen zur Verwendung wiederkehrender Zahlungen mit Apple Pay finden Sie in der [PassKit-Dokumentation von Apple](https://developer.apple.com/documentation/passkit/pkpaymentrequest).

#### iOS (React Native)

```javascript
const initializePaymentSheet = async () => {
  const recurringSummaryItem = {
    label: 'My Subscription',
    amount: '59.99',
    paymentType: 'Recurring',
    intervalCount: 1,
    intervalUnit: 'month',
    // Payment starts today
    startDate: new Date().getTime() / 1000,

    // Payment ends in one year
    endDate: new Date().getTime() / 1000 + 60 * 60 * 24 * 365,
  };

  const {error} = await initPaymentSheet({
    // ...
    applePay: {
      merchantCountryCode: 'US',
      cartItems: [recurringSummaryItem],
      request: {
        type: PaymentRequestType.Recurring,
        description: 'Recurring',
        managementUrl: 'https://my-backend.example.com/customer-portal',
        billing: recurringSummaryItem,
        billingAgreement:
          "You'll be billed $59.99 every month for the next 12 months. To cancel at any time, go to Account and click 'Cancel Membership.'",
      },
    },
  });
};
```

### Sendungsverfolgung

Um für iOS&nbsp;16 und neuere Versionen Informationen zur [Sendungsverfolgung](https://developer.apple.com/design/human-interface-guidelines/technologies/wallet/designing-order-tracking) hinzuzufügen, konfigurieren Sie eine Callback-Funktion für `setOrderTracking`. Stripe ruft Ihre Implementierung auf, nachdem die Zahlung durchgeführt wurde, aber bevor iOS das Apple&nbsp;Pay-Formular schließt.

Rufen Sie in Ihrer Implementierung der Callback-Funktion `setOrderTracking` die Bestelldetails für die abgeschlossene Bestellung von Ihrem Server ab. Übergeben Sie die Details an die angegebene `completion`-Funktion.

Weitere Informationen zur Sendungsverfolgung finden Sie in der [Apple-Dokumentation zu Wallet-Bestellungen](https://developer.apple.com/documentation/walletorders).

#### iOS (React Native)

```javascript
await initPaymentSheet({
  // ...
  applePay: {
    // ...
    setOrderTracking: async complete => {
      const apiEndpoint =
        Platform.OS === 'ios'
          ? 'http://localhost:4242'
          : 'http://10.0.2.2:4567';
      const response = await fetch(
        `${apiEndpoint}/retrieve-order?orderId=${orderId}`,
        {
          method: 'GET',
          headers: {
            'Content-Type': 'application/json',
          },
        },
      );
      if (response.status === 200) {
        const orderDetails = await response.json();
        // orderDetails should include orderIdentifier, orderTypeIdentifier,
        // authenticationToken and webServiceUrl
        complete(orderDetails);
      }
    },
  },
});
```

## Optional: Google Pay aktivieren

### Integration einrichten

Um Google Pay zu verwenden, aktivieren Sie zuerst die Google Pay API, indem Sie dem Tag `<application>` Ihrer Datei **AndroidManifest.xml** Folgendes hinzufügen:

```xml
<application>
  ...
  <meta-data
    android:name="com.google.android.gms.wallet.api.enabled"
    android:value="true" />
</application>
```

Weitere Informationen finden Sie in der [Google Pay API](https://developers.google.com/pay/api/android/guides/setup) für Android.

### Google Pay hinzufügen

Setzen Sie bei der Initialisierung von `PaymentSheet` `merchantCountryCode` auf den Ländercode Ihres Unternehmens und setzen Sie `googlePay` auf „true“.

Sie können die Testumgebung auch verwenden, indem Sie den Parameter `testEnv` übergeben. Sie können Google Pay nur auf einem physischen Android-Gerät testen. Folgen Sie der [React Native-Dokumentation](https://reactnative.dev/docs/running-on-device), um Ihre Anwendung auf einem physischen Gerät zu testen.

```javascript
const { error, paymentOption } = await initPaymentSheet({
  // ...
  googlePay: {
    merchantCountryCode: 'US',
    testEnv: true, // use test environment
  },
});
```

## Optional: Formular anpassen

Alle Anpassungen werden mithilfe von `initPaymentSheet` konfiguriert.

### Erscheinungsbild

Passen Sie mit der [Appearance API](https://docs.stripe.com/elements/appearance-api/mobile.md?platform=react-native) Farben, Schriftarten und mehr an das Erscheinungsbild Ihrer App an.

### Anzeigename des Händlers

Geben Sie einen kundenorientierten Unternehmensnamen an, indem Sie `merchantDisplayName` festlegen. Standardmäßig handelt es sich dabei um den Namen Ihrer App.

```javascript
await initPaymentSheet({
  // ...
  merchantDisplayName: 'Example Inc.',
});
```

### Dunkelmodus

Standardmäßig passt `PaymentSheet` sich automatisch an die systemweiten Erscheinungsbildeinstellungen des/der Nutzer/in an (heller und dunkler Modus). Dies können Sie ändern, indem Sie die Eigenschaft `style` in iOS auf den Modus `alwaysLight` oder `alwaysDark` setzen.

```javascript
await initPaymentSheet({
  // ...
  style: 'alwaysDark',
});
```

Wählen Sie auf einem Android-Gerät den Hell- oder Dunkelmodus für Ihre App aus:

```
// force dark
AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_YES)
// force light
AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_NO)
```

## Optional: Zahlung in Ihrer Nutzeroberfläche abschließen

Sie können das Zahlungsformular anzeigen, um nur die Details einer Zahlungsmethode zu erfassen, und später eine `confirm`-Methode aufrufen, um die Zahlung in der Nutzeroberfläche Ihrer App abzuschließen. Dies ist nützlich, wenn Sie eine nutzerspezifische Kaufschaltfläche haben oder zusätzliche Schritte erfordern, nachdem die Zahlungsdetails erfasst wurden.
![](https://b.stripecdn.com/docs-statics-srv/assets/react-native-multi-step.84d8a0a44b1baa596bda491322b6d9fd.png)

> Eine Beispiel-Integration ist [in unserem GitHub verfügbar](https://github.com/stripe/stripe-react-native/blob/master/example/src/screens/PaymentsUICustomScreen.tsx).

1. Rufen Sie zunächst `initPaymentSheet` auf und übergeben Sie `customFlow: true`. `initPaymentSheet` wird mit einer anfänglichen Zahlungsoption aufgelöst, die ein Bild und ein Label enthält, die die Zahlungsmethode des/der Kund/in darstellen. Aktualisieren Sie Ihre Nutzeroberfläche mit diesen Details.

```javascript
const {
  initPaymentSheet,
  presentPaymentSheet,
  confirmPaymentSheetPayment,
} = useStripe()

const { error, paymentOption } = await initPaymentSheet({
  customerId: customer,
  customerEphemeralKeySecret: ephemeralKey,
  paymentIntentClientSecret: paymentIntent,
  customFlow: true,
  merchantDisplayName: 'Example Inc.',
});
// Update your UI with paymentOption
```

1. Verwenden Sie `presentPaymentSheet`, um Zahlungsdetails zu erfassen. Wenn der/die Kund/in fertig ist, schließt sich das Formular von selbst und löst das Versprechen auf. Aktualisieren Sie Ihre Nutzeroberfläche mit den Angaben zur ausgewählten Zahlungsmethode.

```javascript
const { error, paymentOption } = await presentPaymentSheet();
```

1. Verwenden Sie `confirmPaymentSheetPayment`, um die Zahlung zu bestätigen. Dies wird mit dem Ergebnis der Zahlung aufgelöst.

```javascript
const { error } = await confirmPaymentSheetPayment();

if (error) {
  Alert.alert(`Error code: ${error.code}`, error.message);
} else {
  Alert.alert(
    'Success',
    'Your order is confirmed!'
  );
}
```

Wenn Sie `allowsDelayedPaymentMethods` auf true festlegen, werden Zahlungsmethoden mit [verzögerter Benachrichtigung](https://docs.stripe.com/payments/payment-methods.md#payment-notification) wie US-Bankkonten zugelassen. Für diese Zahlungsmethoden ist der endgültige Zahlungsstatus nicht bekannt, wenn das `PaymentSheet` abgeschlossen wird. Stattdessen ist sie erfolgreich oder schlägt fehl. Wenn Sie diese Art von Zahlungsmethoden unterstützen, informieren Sie den Kunden/die Kundin darüber, dass seine/ihre Bestellung bestätigt ist, und führen seine/ihre Bestellung erst aus (z. B. das Produkt versenden), wenn die Zahlung erfolgreich ist.

## Gebühren einziehen

Anstatt den vollen Transaktionsbetrag auf ein verbundenes Konto zu überweisen, kann Ihre Plattform bei der Verarbeitung einer Zahlung beschließen, einen Teil des Transaktionsbetrags in Form von Gebühren zu erheben. Sie können die Preise für Gebühren auf zwei verschiedene Arten festlegen:

- Mit dem [Plattform-Preistool](https://docs.stripe.com/connect/platform-pricing-tools.md) können Sie Preisregeln für Plattformgebühren festlegen und testen. Diese No-Code-Funktion im Stripe-Dashboard ist derzeit nur für Plattformen verfügbar, die für die Zahlung von Stripe-Gebühren verantwortlich sind.

- Legen Sie intern Ihre Preisregeln fest und legen Sie Gebühren direkt in einem [PaymentIntent](https://docs.stripe.com/api/payment_intents/object.md) fest, entweder mit dem Parameter [application_fee_amount](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-application_fee_amount) oder [transfer_data[amount]](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-transfer_data-amount). Die mit dieser Methode festgelegten Gebühren überschreiben die im Plattform-Preistool angegebene Preislogik.

#### application_fee_amount

Wenn Zahlungen mit einem `application_fee_amount` erstellt werden, wird der vollständige Zahlungsbetrag sofort nach Erfassung der Zahlung von der Plattform auf das `transfer_data[destination]`-Konto übertragen. Der `application_fee_amount` (bis zum vollen Zahlungsbetrag) wird wieder an die Plattform zurück übertragen.

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1000 \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]=true" \
  -d application_fee_amount=123 \
  -d "transfer_data[destination]={{CONNECTEDACCOUNT_ID}}"
```

Nach Einzug der Plattformgebühren wird ein [Plattformgebühren](https://docs.stripe.com/api/application_fees/object.md)-Objekt erstellt. Sie können eine Liste der Plattformgebühren im [Dashboard](https://dashboard.stripe.com/connect/application_fees), mit den [Plattformgebühren](https://docs.stripe.com/api/application_fees/list.md) oder in [Sigma](https://docs.stripe.com/data/how-sigma-works.md) anzeigen. Sie können auch die Eigenschaft `Betrag` im Plattformgebühren-Objekt für die Aufstellung der Gebührenberichterstattung verwenden.

Wenn Sie einen `application_fee_amount` verwenden, muss Ihnen Folgendes bekannt sein:

- Der `application_fee_amount` ist auf den Gesamtbetrag der Transaktion begrenzt.
- Sollten Sie einen Betrag [einziehen](https://docs.stripe.com/api/payment_intents/capture.md), der unter dem genehmigten Betrag liegt, vergleichen wir den Wert von `application_fee_amount` nicht mit dem eingezogenen Betrag und geben auch keinen Fehler zurück. Stattdessen begrenzen wir die Anmeldegebühr auf den eingezogenen Betrag, sodass auf dem verbundenen Konto kein Betrag verbleibt, wenn Ihre Gebühr dem eingezogenen Betrag entspricht oder diesen übersteigt. Um Guthaben auf dem verbundenen Konto zu belassen, setzen Sie `application_fee_amount` auf einen Wert, der unter `amount_to_capture` liegt.
- Der `application_fee_amount` wird immer in der gleichen Währung wie die Transaktion berechnet.
- Die Plattformgebühr wird in derselben Währung wie die Abrechnungswährung des verbundenen Kontos *abgewickelt* (When funds are available in your Stripe balance). Bei grenzüberschreitenden Destination Charges kann dies [von der Abrechnungswährung Ihrer Plattform abweichen](https://docs.stripe.com/connect/currencies/fx-quotes-api.md#destination-charges-without-on-behalf-of).
- Ihre Plattform zahlt die Stripe-Gebühr, nachdem der `application_fee_amount` auf Ihr Konto überwiesen wurde.
- Es fallen keine zusätzlichen Stripe-Gebühren auf den Betrag an.
- Ihre Plattform kann die integrierte Berichterstattung zur Plattformgebühr verwenden, um die [erhobenen Gebühren](https://dashboard.stripe.com/connect/application_fees) abzugleichen.
- In von Stripe gehosteten Dashboards oder Komponenten wie der [Zahlungsdetails-Komponente](https://docs.stripe.com/connect/supported-embedded-components/payment-details.md) kann Ihr verbundenes Konto sowohl den Gesamtbetrag als auch den Betrag der Plattformgebühr einsehen.

### Geldbewegungen mit Destination Charges

Mit dem obigen Code wird der vollständige Zahlungsbetrag (10,00 USD) dem ausstehenden Guthaben des verbundenen Kontos hinzugefügt. Der `application_fee_amount`(1,23 USD) wird vom Zahlungsbetrag abgezogen und an Ihre Plattform überwiesen. Die Stripe-Gebühren (0,59 USD) vom Guthaben Ihres Plattformkontos abgezogen. Der Betrag der Plattformgebühr abzüglich der Stripe-Gebühren (1,23 USD – 0,59 USD = 0,64 USD) verbleibt auf dem Guthaben Ihres Plattformkontos.
![Geldbewegungen für Destination Charges](https://b.stripecdn.com/docs-statics-srv/assets/destination_charge_app_fee.c9ef81298155b38f986df02d0efa9167.png)

Der `application_fee_amount` wird gemäß dem normalen Überweisungsplan des Plattformkontos verfügbar, genau wie Gelder aus regulären Stripe-Zahlungen.

#### transfer_data[amount]

`transfer_data[amount]` ist eine positive Ganzzahl, die für den an das `transfer_data[destination]` zu überweisenden Zahlungsbetrag steht. Sie ziehen die Gebühren Ihrer Plattform vom Zahlungsbetrag ab und übergeben dann das Ergebnis dieser Berechnung als `transfer_data[amount]`.

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1000 \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]=true" \
  -d "transfer_data[amount]=877" \
  -d "transfer_data[destination]={{CONNECTEDACCOUNT_ID}}"
```

Bei Verwendung von `transfer_data[amount]` gilt Folgendes:

- Der Betrag ist auf den Gesamtbetrag der Transaktion begrenzt.
- Der Betrag wird immer in der gleichen Währung wie die Transaktion berechnet.
- Der Betrag wird in [derselben Währung wie die Abrechnungswährung Ihrer Plattform](https://docs.stripe.com/connect/currencies/fx-quotes-api.md#destination-charges-without-on-behalf-of) *abgewickelt* (When funds are available in your Stripe balance).
- In von Stripe gehosteten Dashboards oder Komponenten wie dem Stripe-Dashboard oder dem Express-Dashboard kann Ihr verbundenes Konto den Gesamtbetrag der Zahlung nicht anzeigen. Sie sehen nur den überwiesenen Betrag.
- Ihre Plattform zahlt die Stripe-Gebühren für die Zahlung getrennt.
- Es fallen keine zusätzlichen Stripe-Gebühren auf den Betrag an.
- Um nach der Erstellung einer Zahlung [Gebühren zu berechnen](https://docs.stripe.com/data/query-all-fees-data.md#fees-paid-by-connected-accounts), beispielsweise für Berichtszwecke, [rufen Sie den „PaymentIntent“ ab](https://docs.stripe.com/api/payment_intents/retrieve.md) und ziehen Sie den Wert von `transfer_data[amount]` vom `Betrag` im „PaymentIntent“ ab.

Erwägen Sie die Verwendung des [Plattformgebührenbetrags](https://docs.stripe.com/connect/destination-charges.md#application-fee) zur Vereinfachung der Berichterstattung, indem Sie explizit Plattformgebühren erstellen, die mit der Zahlung verknüpft sind.

### Geldbewegungen

Mit dem obigen Code wird der `amount` (10,00 USD) der Zahlung dem Saldo des Plattformkontos hinzugefügt. Der `transfer_data[amount]` (8,77 USD) wird vom Saldo des Plattformkontos abgezogen und zum ausstehenden Saldo des verbundenen Kontos hinzuaddiert. Der `amount` (10,00 USD) der Zahlung abzüglich des `transfer_data[amount]` (8,77 USD), abzüglich der Stripe-Gebühren (auf den `amount` der Zahlung) – es verbleibt ein Nettobetrag in Höhe von 0,64 USD im ausstehenden Saldo des Plattformkontos.
![](https://b.stripecdn.com/docs-statics-srv/assets/destination_charge_amount.46cd59f6496607d68020b546aa1af85f.png)

Der `transfer_data[amount]` wird gemäß dem normalen Überweisungsplan des verbundenen Kontos verfügbar, genauso wie Gelder aus regulären Stripe-Zahlungen.

In der Spalte mit der Zielplattformgebühr im Export der Saldenhistorie können Plattformen nachvollziehen, wie viel sie von den `transfer_data[amount]`-Zahlungen einbehalten.

## Abwicklungshändler angeben

Der Abwicklungshändler ist abhängig von den [Funktionen](https://docs.stripe.com/connect/account-capabilities.md), die für ein Konto eingerichtet sind, und davon, wie eine Zahlung erstellt wird. Der Abwicklungshändler bestimmt, wessen Informationen für die Durchführung der Zahlung verwendet werden. Dazu gehört die Zahlungsbeschreibung in der Abrechnung (entweder die der Plattform oder die des verbundenen Kontos), die auf dem Kreditkarten- oder Kontoauszug des Kunden/der Kundin für diese Zahlung angezeigt wird.

Durch die Angabe des Abwicklungshändlers können Sie genauer festlegen, für wen Zahlungen erstellt werden sollen. Einige Plattformen sind beispielsweise vorzugsweise der Abwicklungshändler, da Kundinnen/Kunden direkt mit ihrer Plattform interagieren (zum Beispiel On-Demand-Plattformen). Manche Plattformen verfügen jedoch über verbundene Konten, die stattdessen direkt mit Kundinnen/Kunden interagieren (zum Beispiel ein Ladengeschäft auf einer E-Commerce-Plattform). Bei diesen Szenarien ist es möglicherweise sinnvoller, wenn das verbundene Konto der Abwicklungshändler ist.

Sie können den Parameter `on_behalf_of` auf die ID eines verbundenen Kontos setzen, um dieses Konto zum Abwicklungshändler für die Zahlung zu machen. Bei Verwendung von `on_behalf_of`:

- Zahlungen werden im Land und in der *Abwicklungswährung* (The settlement currency is the currency your bank account uses) des verbundenen Kontos *abgewickelt* (When funds are available in your Stripe balance).
- Es wird die Gebührenstruktur für das Land des verbundenen Kontos verwendet.
- Die Zahlungsbeschreibung des verbundenen Kontos wird auf der Kreditkartenabrechnung des Kunden/der Kundin angezeigt.
- Wenn sich das verbundene Konto in einem anderen Land als die Plattform befindet, werden die Adresse und die Telefonnummer des verbundenen Kontos auf der Kreditkartenabrechnung des Kunden/der Kundin angezeigt.
- Wie viele Tage ein [ausstehendes Guthaben](https://docs.stripe.com/connect/account-balances.md) vor der Auszahlung zurückgehalten wird, hängt von der Einstellung [delay_days](https://docs.stripe.com/api/accounts/create.md#create_account-settings-payouts-schedule-delay_days) auf dem verbundenen Konto ab.

> #### Accounts&nbsp;v2&nbsp;API
> 
> Sie können die Accounts&nbsp;v2&nbsp;API nicht zur Verwaltung der Auszahlungseinstellungen verwenden. Bitte nutzen Sie die Accounts&nbsp;v1&nbsp;API.

Wenn `on_behalf_of` weggelassen wird, ist die Plattform das für die Zahlung verantwortliche Unternehmen.

> Der Parameter `on_behalf_of` wird nur für verbundene Konten mit Zahlungsfunktionen wie [card_payments](https://docs.stripe.com/connect/account-capabilities.md#card-payments) unterstützt. Konten, denen der [Empfänger-Rahmenvertrag](https://docs.stripe.com/connect/service-agreement-types.md#recipient) zugrunde liegt, können keine `card_payments` oder andere Zahlungsfunktionen anfordern.

## Finden Sie die Zahlung des verbundenen Kontos

Eine Destination Charge erstellt eine [Übertragung](https://docs.stripe.com/api/transfers/object.md) an das verbundene Konto, und die Übertragung erstellt eine separate Zahlung auf das verbundene Konto. Die ursprüngliche Zahlung spiegelt die Zielzahlung nicht wider. Verwenden Sie daher die Übertragung, um die Zahlung von Ihrer Plattform an das verbundene Konto zu finden.

Rufen Sie die Zahlung von Ihrer Plattform ab, indem Sie [transfer.destination_payment](https://docs.stripe.com/api/transfers/object.md#transfer_object-destination_payment) erweitern. Wenn Sie einen PaymentIntent abrufen, erweitern Sie [latest_charge.transfer.destination_payment](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-latest_charge).

```curl
curl -G https://api.stripe.com/v1/charges/{{CHARGE_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "expand[]=transfer.destination_payment"
```

Die Zahlung gehört zum verbundenen Konto. Um sie direkt abzurufen oder zu aktualisieren, setzen Sie den [Stripe-Account-Header](https://docs.stripe.com/connect/authentication.md) auf die ID des verbundenen Kontos. Wenn Sie Zahlungen auf verbundenen Konten abgleichen, speichern Sie die `destination_payment`-ID zusammen mit der Zahlungs-ID. Verwenden Sie keine ID-Präfixe, um eine Plattformzahlung von der Zahlung eines verbundenen Kontos zu unterscheiden.

## Rückerstattungen ausstellen

Wenn Sie die Payment Intents API verwenden, sollten Rückerstattungen für [die letzte erstellte Zahlung](https://docs.stripe.com/payments/payment-intents/verifying-status.md#identifying-charges) ausgestellt werden.

Im Plattformkonto erstellte Zahlungen können mit dem geheimen Schlüssel des Plattformkontos rückerstattet werden. Bei Rückerstattung einer Zahlung mit einem `transfer_data[destination]` bleiben die Gelder standardmäßig auf dem Zielkonto, auf das sie überwiesen wurden, sodass das Plattformkonto den negativen Saldo aus der Rückerstattung abdecken muss. Um die Gelder zur Abdeckung der Rückerstattung von dem verbundenen Konto zurückzuziehen, setzen Sie den Parameter `reverse_transfer` beim Erstellen der Rückerstattung auf `true`:

```curl
curl https://api.stripe.com/v1/refunds \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "charge={{CHARGE_ID}}" \
  -d reverse_transfer=true
```

Standardmäßig wird die gesamte Zahlung rückerstattet. Sie können jedoch auch eine Teilrückerstattung erstellen, indem Sie einen `amount`-Wert als positive Ganzzahl festlegen.

Wenn die Rückerstattung zur Folge hat, dass die gesamte Zahlung zurückerstattet wird, wird die gesamte Übertragung rückgängig gemacht. Andernfalls wird nur ein proportionaler Betrag der Übertragung rückgängig gemacht.

### Plattformgebühren zurückerstatten

Wenn eine Zahlung mit einer Plattformgebühr zurückerstattet wird, behält das Plattformkonto standardmäßig die Gelder aus der Plattformgebühr ein. Um die Plattformgebühr auf das verbundene Konto zurück zu übertragen, legen Sie den Parameter [refund_application_fee](https://docs.stripe.com/api/refunds/create.md#create_refund-refund_application_fee) auf `true` fest, wenn Sie die Rückerstattung erstellen:

```curl
curl https://api.stripe.com/v1/refunds \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "charge={{CHARGE_ID}}" \
  -d reverse_transfer=true \
  -d refund_application_fee=true
```

Wenn Sie die Plattformgebühr für eine Destination Charge erstatten, müssen Sie auch die Übertragung rückgängig machen. Wenn die Rückerstattung zur Folge hat, dass die gesamte Zahlung zurückerstattet wird, beinhaltet die Rückerstattung auch die gesamte Plattformgebühr. Andernfalls erstatten Sie nur einen proportionalen Betrag der Plattformgebühr zurück.

Alternativ können Sie den `refund_application_fee`-Wert **false** angeben und die Plattformgebühr separat [über die API](https://docs.stripe.com/api.md#create_fee_refund) zurückerstatten.

### Fehlgeschlagene Rückerstattungen

Wenn eine Rückerstattung fehlschlägt oder von Ihnen [storniert](https://docs.stripe.com/refunds.md#cancel-refund) wird, wird der Betrag der fehlgeschlagenen Rückerstattung dem Stripe-Guthaben gutgeschrieben. Erstellen Sie eine [Übertragung](https://docs.stripe.com/connect/separate-charges-and-transfers.md#create-transfer), um das Geld nach Bedarf auf das verbundene Konto zu überweisen.

## Umgang mit Zahlungsanfechtungen

Für Destination Charges, mit oder ohne `on_behalf_of`, belastet Stripe angefochtene Beträge und Gebühren von Ihrem Plattformkonto.

Richten Sie [einen Webhook](https://docs.stripe.com/webhooks.md) ein, um auf [Ereignisse zum Anlegen von Zahlungsanfechtungen](https://docs.stripe.com/api/events/types.md#event_types-charge.dispute.created) zu reagieren.

Sie können die Überweisung auf Ihr verknüpftes Konto über das [Dashboard](https://dashboard.stripe.com/test/transfers) rückgängig machen oder eine [Rückbuchung der Überweisung](https://docs.stripe.com/api/transfer_reversals/create.md) vornehmen, um die im Rahmen einer strittigen Rückbuchung zurückerstatteten Beträge zurückzuerhalten. Weist das verknüpfte Konto einen negativen Saldo auf, versucht Stripe, dessen externes Konto zu belasten, sofern [debit_negative_balances](https://docs.stripe.com/connect/account-balances.md#automatically-debit-connected-accounts) auf `true` gesetzt ist.

Passen Sie den Zeitpunkt Ihrer Rückabwicklung daran an, wie Sie die Zahlungsanfechtung regeln möchten:

- Wenn Sie den angefochtene Zahlung anerkennen, können Sie die Überweisung umgehend rückgängig machen.
- Sollten Sie die angefochtene Zahlung anfechten, warten Sie bitte das Ergebnis der Anfechtung ab, bevor Sie die Überweisung rückgängig machen.
  - Sollten Ihre Anfechtung erfolgreich sein, stornieren Sie die Überweisung bitte nicht.
  - Sollten Sie bei der Anfechtung kein Recht bekommen, machen Sie die Überweisung rückgängig.

Wenn Sie die Überweisung für eine strittige Zahlung, die Sie anfechten und bei der Sie Recht bekommen, rückgängig machen, kann die Rücküberweisung dieser Beträge auf ein verbundenes Konto unerwartete Folgen haben:

- Sollte Ihr Guthaben auf der Plattform nicht ausreichen, schlägt die Überweisung fehl. Beugen Sie Fehlern aufgrund unzureichenden Guthabens vor, [indem Sie Ihr Stripe-Guthaben aufladen](https://docs.stripe.com/get-started/account/add-funds.md).
- [Grenzüberschreitende Überweisungsbeschränkungen](https://docs.stripe.com/connect/account-capabilities.md#transfers-cross-border) könnten Sie daran hindern, eine Rückzahlung auf Ihr verknüpftes Konto vorzunehmen.

## Fehlgeschlagene asynchrone Zahlungen

Bei Destination Charges mit asynchronen Zahlungsmethoden (z. B. ACH-Lastschrift oder SEPA-Lastschrift) gibt es eine Verzögerung zwischen der Einleitung der Zahlung und der Bestätigung der Geldbeträge. Während dieser Zeit befinden sich sowohl die Zahlung als auch die Übertragung auf das ausstehende Guthaben des verbundenen Kontos in einem ausstehenden Zustand.

Schlägt die asynchrone Zahlung fehl, storniert Stripe die Übertragung automatisch. Es werden keine Geldmittel dauerhaft auf das verbundene Konto überwiesen.

## Übersprungene Übertragungen aufgrund von Konto Status

Bei Zahlungen mit asynchronen Zahlungsmethoden (z.&nbsp;B. ACH oder SEPA-Lastschrift) gibt es eine Verzögerung zwischen dem Zeitpunkt, an dem die Zahlung autorisiert wird, und dem Zeitpunkt, an dem das Geld verfügbar wird. Wenn das Zielkonto in dieser Zeit die erforderliche[Übertragungsfunktion](https://docs.stripe.com/connect/account-capabilities.md#supported-capabilities) verliert oder geschlossen ist, kann Stripe die Übertragung nicht wie ursprünglich gewünscht abschließen.

Wenn Stripe versucht, eine Übertragung zu erstellen, dies aber aufgrund eines Funktionsverlusts oder der Löschung des Kontos nicht möglich ist, überspringen wir die Erstellung der Übertragung und die Gelder verbleiben auf dem Guthaben Ihrer Plattform.

Um übersprungene Transfers zu erkennen, überwachen Sie das Webhook Ereignis `charge.updated`. Wenn der Wert von [transfer_data](https://docs.stripe.com/api/charges/object.md#charge_object-transfer_data) im Charge-Objekt `null` ist, deutet dies auf eine übersprungene Übertragung hin.

Wenn Sie eine übersprungene Übertragung feststellen, können Sie nach der Behebung des Problems eine Übertragung erstellen.

## In Connect eingebettete Komponenten

Destination Charges werden von den in [Connect eingebetteten Komponenten](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) unterstützt. Durch die Verwendung der in [Zahlungen eingebetteten Komponente](https://docs.stripe.com/connect/supported-embedded-components/payments.md) können Sie Ihren verbundenen Konten ermöglichen, Zahlungsdaten von Ihrer Website aus anzuzeigen. Für Destination Charges mit `on_behalf_of` können Sie die Funktion [destination_on_behalf_of_charge_management](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-payments-features-destination_on_behalf_of_charge_management) verwenden, mit der Ihre verbundenen Konten zusätzliche Details anzeigen, Rückerstattungen, Zahlungsanfechtungen verwalten und Zahlungen erfassen können.

Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production.

Die folgenden Komponenten zeigen Informationen zu den Destination Charges an:

- [Payments-Komponente](https://docs.stripe.com/connect/supported-embedded-components/payments.md): Zeigt alle Zahlungen und Zahlungsanfechtungen eines Kontos an.

- [Zahlungsdetails](https://docs.stripe.com/connect/supported-embedded-components/payment-details.md): Zeigt alle Zahlungen und Zahlungsanfechtungen eines Kontos an.

- [Komponente „Zahlungsanfechtungen“](https://docs.stripe.com/connect/supported-embedded-components/disputes-list.md): Zeigt alle Zahlungsanfechtungen eines Kontos an.

- [Komponente „Zahlungsanfechtungen für eine Zahlung“](https://docs.stripe.com/connect/supported-embedded-components/disputes-for-a-payment.md): Zeigt die Zahlungsanfechtungen für eine einzelne angegebene Zahlung an. Sie können damit Funktionen zum Management von Zahlungsanfechtungen in eine Seite Ihrer Zahlungs-Nutzeroberfläche integrieren.

## See also

- [Mit mehreren Währungen arbeiten](https://docs.stripe.com/connect/currencies.md)
- [Zahlungsbeschreibungen mit Connect](https://docs.stripe.com/connect/statement-descriptors.md)
