# Payment Method Configurations API

Erfahren Sie, wie Sie die Configurations API verwenden, um Inhaber/innen von verbundenen Konten mehr Kontrolle über die von ihnen angebotenen Zahlungsmethoden zu geben.

Mit der Payment Method Configurations API können sich Inhaber/innen verbundener Konten über die Einstellungsseite für die Aktivierung und Deaktivierung bestimmter Zahlungsmethoden entscheiden. Sie können dann sehen, welche Zahlungsmethoden für verbundene Konten aktiviert sind, Zahlungsmethoden bewerben und Anzeigeeinstellungen für relevante Zahlungsarten festlegen.

Sie können entweder Ihre eigene Nutzeroberfläche für Zahlungsmethodeneinstellungen mit der API erstellen oder die eingebettete Komponente für die Einstellungen der Zahlungsmethode verwenden.

> Mit der **eingebetteten Komponente für Einstellungen der Zahlungsmethode** können verbundene Konten die Zahlungsmethoden konfigurieren, die sie beim Bezahlvorgang anbieten, ohne auf das Stripe-Dashboard zugreifen zu müssen. Erfahren Sie mehr über die [eingebettete Komponente für Einstellungen der Zahlungsmethode](https://docs.stripe.com/connect/supported-embedded-components/payment-method-settings.md). Sie werden benachrichtigt, sobald sie verfügbar ist.

## Standardzustand auf Plattformebene festlegen

Legen Sie im Stripe-Dashboard auf der Seite [**Zahlungsmethoden für Ihre verbundenen Konten verwalten**](https://dashboard.stripe.com/test/settings/payment_methods/connected_accounts) den Standard für einzelne Zahlungsmethoden fest, um die standardmäßig aktivierten Zahlungsmethoden zu bearbeiten.

Klicken Sie im [Dashboard](https://dashboard.stripe.com/login) auf das Zahnradsymbol oben rechts, um die Seite mit den **Produkteinstellungen** zu öffnen. Klicken Sie im Abschnitt **Zahlungen** auf den Link **Zahlungsarten**.
![Einstellungsoption im Dashboard](https://b.stripecdn.com/docs-statics-srv/assets/settings-api-dashboard.01bd465492acb49ada30fdda9e9f5d08.png)
![Zahlungsmethoden unter „Zahlungseinstellungen“](https://b.stripecdn.com/docs-statics-srv/assets/settings-api-payment-methods.7824d81ee28dd2775b73d556da33d82a.png)

Als Plattform können Sie bevorzugte Zahlungsmethoden für Ihre Plattform und für Ihre verbundenen Konten festlegen. Die Einstellungen für **Ihr Konto** gelten für Ihren direkten Zahlungsverkehr. Wenn Sie beispielsweise Ihren Nutzer/innen eine monatliche Gebühr für die Nutzung Ihrer Plattform über Ihre eigene Zahlungsseite berechnen, verwenden Sie die Einstellungen für **Ihr Konto**, um diese Zahlungen zu verwalten.

Mit den Einstellungen für **Ihre verbundenen Konten** können Sie die Zahlungsmethoden verwalten, die die verbundenen Konten auf Ihrer Plattform akzeptieren können.

Um den Standardstatus für alle verbundenen Konten auf Ihrer Plattform festzulegen, klicken Sie unter **Ihre verbundenen Konten** auf den Link **Einstellungen bearbeiten**.
![Einstellungen zur Zahlungsmethode für Ihr Konto und verbundene Konten](https://b.stripecdn.com/docs-statics-srv/assets/settings-api-connected-accounts.ba46dc06c0684b481667e91cf4e3fcfd.png)

Verwenden Sie für jede Zahlungsmethode das Dropdown-Menü, um die gewünschte Einstellung auszuwählen:

- **Standardmäßig aktiviert**: Die Zahlungsmethode ist standardmäßig aktiviert. Verbundene Konten können sie aktivieren und deaktivieren.
- **Standardmäßig deaktiviert**: Die Zahlungsmethode ist standardmäßig deaktiviert. Verbundene Konten können sie aktivieren und deaktivieren.
- **Blockiert** deaktiviert die Zahlungsmethode für alle verbundenen Konten. Verbundene Konten können sie nicht aktivieren, aber die Plattform kann dies für einzelne verbundene Konten außer Kraft setzen.

> Stripe aktiviert standardmäßig einige häufig verwendete Zahlungsmethoden wie Karten, Apple Pay und Google Pay.
![Einstellungen für jede Zahlungsmethode konfigurieren](https://b.stripecdn.com/docs-statics-srv/assets/settings-api-wallets.956b27fd0756e064d433aaa5999130fe.png)

## Verfügbarkeit und Anzeigeeinstellungen für verbundene Konten ermitteln

Verwenden Sie die Payment Method Configurations API mit der ID des verbundenen Kontos, um den aktuellen Status einer Zahlungsmethode für ein bestimmtes verbundenes Konto zu lesen. Wenn das verbundene Konto über mehr als eine Konfiguration verfügt, können Sie die Ergebnisse nach der `client_id` Ihrer Anwendung filtern, die sich in Ihren [Connect-Einstellungen](https://dashboard.stripe.com/settings/connect/onboarding-options/oauth) befindet.

> #### Mit mehreren Zahlungsmethodenkonfigurationen arbeiten
> 
> Wenn Sie zusätzliche Konfigurationen für Zahlungsmethoden für ein verbundenes Konto erstellt haben, können Sie die ursprüngliche Konfiguration anhand der Eigenschaft `is_default` erkennen. Stripe verwendet die Standardkonfiguration für Zahlungen, wenn Sie keine [Konfigurations-ID](https://docs.stripe.com/connect/multiple-payment-method-configurations.md#use-payment-method-configuration) in Ihren Bezahlvorgang eingeben. Weitere Informationen über `is_default` und andere Eigenschaften von Zahlungsmethodenkonfigurationen finden Sie in der [API-Dokumentation](https://docs.stripe.com/api/payment_method_configurations/object.md#payment_method_configuration_object-is_default).

```curl
curl -G https://api.stripe.com/v1/payment_method_configurations \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d "application={{CLIENTAPPLICATION_ID}}"
```

```json
{
  "object": "list",
  "data": [
    {
      "id": ""{{PAYMENT_METHOD_CONFIGURATION_ID}}"",
      "object": "payment_method_configuration",
      "name": "Default",
      "active": true,
      "is_default": true,
      "livemode": false,
      "application": ""{{CLIENT_APPLICATION_ID}}"",
      "acss_debit": {
        "available": false,
        "display_preference": {
          "overridable": true,
          "preference": "off",
          "value": "off"
        }
      },
      "affirm": {
        "available": false,
        "display_preference": {
          "overridable": true,
          "preference": "off",
          "value": "off"
        }
      },
      "afterpay_clearpay": {
        "available": false,
        "display_preference": {
          "overridable": true,
          "preference": "off",
          "value": "off"
        }
      },
      ... additional payment methods
    }
  ],
  "has_more": false,
  "url": "/v1/payment_method_configurations"
}
```

Bei erfolgreicher Durchführung werden in der Rückgabeliste jede Zahlungsmethode und zwei Parameter zur Verfügbarkeit und Anzeigeeinstellungen angezeigt.

- `available` ist die Kombination aus dem [capability](https://docs.stripe.com/api/capabilities/object.md)-Wert (`active`, `inactive`, `pending`, or `unrequested`) und dem `display_preference`-Wert.

  Mit dem Feld „Verfügbar“ bestimmen Sie, ob Käufer/innen bei der Bezahlung diese Zahlungsmethode sehen oder nicht. Ist „Verfügbar“ auf `true` festgelegt, so ist die Funktion der Zahlungsmethode aktiv und `display_preference` ist aktiviert. Ist „Verfügbar“ auf `false` festgelegt, so hat diese Zahlungsmethode entweder keine aktive Funktion oder der Wert `display_preference` ist deaktiviert, sodass Käuferinnen und Käufern diese Methode während des Bezahlvorgangs nicht angezeigt wird. Zur Verbesserung Ihrer Integration und zur Nutzung weiterer Funktionen verwenden Sie beim Bezahlvorgang dynamische Zahlungsmethoden. Diese lesen Parameter automatisch und zeigen Ihren Kundinnen und Kunden stets die richtigen Zahlungsmethoden an.

- `display_preference` hat drei Komponenten: `overridable`, `preference` und `value`.

  - `overridable` ist schreibgeschützt und gibt an, ob die Präferenz des verbundenen Kontos die obige Standardeinstellung außer Kraft setzen kann.
  - `preference` ist schreibbar und speichert die Präferenz des verbundenen Kontos.
  - `value` ist schreibgeschützt und spiegelt den effektiven `display_preference`-Wert wider.

> Nur Zahlungsmethoden, die für das Land des verbundenen Kontos relevant sind, werden in der API-Antwort angezeigt und können konfiguriert werden. [Länderunterstützung prüfen](https://docs.stripe.com/payments/payment-methods/integration-options.md).

## display_preference aktualisieren, wenn ein verbundenes Konto seine Einstellungen bearbeitet

Wenn der/die Inhaber/in eines verbundenen Kontos eine Zahlungsmethode aktiviert oder deaktiviert, können Sie das `preference`-Attribut `display_preference` aktualisieren. Dieses speichert die Präferenz der Inhaberin/des Inhabers des verbundenen Kontos für diese Zahlungsmethode und wird verwendet, um zu bestimmen, ob die Zahlungsmethode für Käufer/innen angezeigt wird.

```curl
curl https://api.stripe.com/v1/payment_method_configurations/{{PAYMENTMETHODCONFIGURATION_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "affirm[display_preference][preference]=on"
```

```json
{
  "id": ""{{PAYMENT_METHOD_CONFIGURATION_ID}}"",
  "object": "payment_method_configuration",
  "name": "Default",
  "active": true,
  "is_default": true,
  "livemode": false,
  "application": ""{{CLIENT_APPLICATION_ID}}"",
  "acss_debit": {
    "available": false,
    "display_preference": {
      "overridable": true,
      "preference": "off",
      "value": "off"
    }
  },
  "affirm": {
    "available": true,
    "display_preference": {
      "overridable": true,
      "preference": "on",
      "value": "on"
    }
  },
  "afterpay_clearpay": {
    "available": false,
    "display_preference": {
      "overridable": true,
      "preference": "off",
      "value": "off"
    }
  },
  ... additional payment methods
}
```

## Verfügbare Zahlungsmethoden im Bezahlvorgang anzeigen

Zahlungsmethoden können Sie über das [Dashboard](https://dashboard.stripe.com/settings/payment_methods) verwalten. Stripe handhabt die Rückgabe geeigneter Zahlungsmethoden basierend auf Faktoren wie Betrag, Währung und Zahlungsablauf der Transaktion. Dadurch werden Käuferinnen und Käufern in Ihrem Bezahlvorgang nur die Zahlungsmethoden angezeigt, bei denen `available` auf `true` festgelegt ist.

Wenn Sie die verfügbaren Zahlungsmethoden für ein verbundenes Konto vorab abrufen möchten, bevor Sie Ihre Bezahlseite rendern, rufen Sie die Payment Method Configurations API auf, um die Liste der Zahlungsmethoden abzurufen. Verwenden Sie solche, bei denen `available` auf `true` festgelegt ist.

## Zahlungsmethoden vom Typ „Karte“ unterstützen

Einige Zahlungsmethoden, wie Apple Pay und Link, sind nicht als separate Zahlungsmethodentypen für einen PaymentIntent enthalten und werden nur bei Angabe der `card` bestätigt. Mit der Payment Method Configurations API können die Inhaber/innen verbundener Konten bestimmte Zahlungsmethoden aktivieren und deaktivieren und so verhindern, dass sie auf der Nutzeroberfläche angezeigt werden.

## Vermarkten Sie Zahlungsmethoden für die Inhaber/innen verbundener Konten

Verwenden Sie gezielte Werbebotschaften, um die Inhaber/innen verbundener Konten dazu zu bewegen, sich für bestimmte Zahlungsmethoden zu entscheiden, für die sie geeignet sind, für die sie sich aber noch nicht angemeldet haben.

Rufen Sie die GET-Methode auf, um den Status der Konfiguration für die Zahlungsmethode abzurufen und zu bestimmen, wann eine Zahlungsmethode hochgestuft werden muss. Sie können anhand des Werts `display_preference` feststellen, ob ein/e Inhaber/in eines verbundenen Kontos bereits mit Ihrer Konfiguration interagiert hat. Wenn `display_preference`-`preference` `none` lautet, hat der/die Inhaber/in des verbundenen Kontos die Standardkonfiguration nicht geändert. Wenn der `preference`-Wert `on` oder `off` ist, hat der/die Inhaber/in des verbundenen Kontos mit der Konfiguration interagiert und Sie können wählen, ob die Werbebotschaft unterdrückt werden soll.

## See also

- [Integrationsleitfaden für Connect](https://docs.stripe.com/connect/charges.md)
- [Konfigurationen mehrerer Zahlungsmethoden](https://docs.stripe.com/connect/multiple-payment-method-configurations.md)
- [Funktionen für Zahlungsmethoden hinzufügen](https://docs.stripe.com/connect/payment-methods.md)