Mehrere Konfigurationen für Ihre Connect-Konten

Navigieren Sie im Stripe-Dashboard für Ihre verbundenen Konten zu den Einstellungen für Zahlungsmethoden. Hier können Sie Ihre übergeordneten Konfigurationen auf Plattformebene steuern. Ihre verbundenen Konten erhalten für jede übergeordnete Konfiguration eine untergeordnete Konfiguration, die Sie innerhalb der von Ihnen festgelegten Einschränkungen anpassen können.

Sie beginnen standardmäßig mit einer übergeordneten Konfiguration. Um eine zusätzliche Konfiguration zu erstellen, klicken Sie auf Neue Konfiguration hinzufügen und geben Sie einen Namen an.

So stellen Sie sicher, dass die zu aktivierende Konfiguration der Zahlungsmethoden im Dashboard aktiv ist:

1. Gehen Sie zu Ihren Einstellungen für Zahlungsmethoden.
2. Klicken Sie im Abschnitt Konfigurationen für Zahlungen auf eine Zahlungsmethode und dann auf das Überlaufmenü () > Konfiguration verwalten.
3. Aktivieren Sie unter Status der Konfiguration die Option Aktiv.
4. Klicken Sie auf Änderungen speichern, um Ihre Aktualisierungen zu übernehmen.

Sie können die Standardeinstellungen für jede Zahlungsmethode auf Ihre neue übergeordnete Konfiguration anwenden und steuern, welche Anpassungen Ihre verbundenen Konten vornehmen können. Wählen Sie über das Dropdown-Menü die gewünschte Einstellung aus:

• 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.

Verbundene Konten mit Zugriff auf das gesamte Stripe-Dashboard können Zahlungsmethoden aktivieren oder deaktivieren, wenn die Zahlungsmethode auf On by default oder Off by default festgelegt wurde. Ihren verbundenen Konten wird die neu erstellte untergeordnete Konfiguration in den Einstellungen für die Zahlungsmethoden angezeigt. Ihre verbundenen Konten können das Dropdown-Menü oben auf der Seite verwenden, um eine zu bearbeitende Konfiguration auszuwählen.

Wenn Sie möchten, dass Ihre verbundenen Konten ihre Einstellungen für Zahlungsmethoden über Ihr Plattform-Dashboard statt über das Stripe-Dashboard anpassen, oder wenn Sie verbundene Konten haben, die keinen Zugriff auf das Stripe-Dashboard haben, können Sie die Payment Method Configurations API integrieren.

Verwenden Sie die Payment Method Configurations API mit der ID des verbundenen Kontos und der ID der untergeordneten Konfiguration, um den aktuellen Status einer Zahlungsmethode für ein bestimmtes verbundenes Konto in dieser Konfiguration zu lesen.

curl https://api.stripe.com/v1/payment_method_configurations/
{{PAYMENT_METHOD_CONFIGURATION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
"

{
  "object": "list",
  "data": [
    {
      "id": 
"{{PAYMENT_METHOD_CONFIGURATION_ID}}",
      "object": "payment_method_configuration",
      "name": "My Custom Configuration",
      "active": true,
      "is_default": true,
      "livemode": false,
      "parent": 
"{{PAYMENT_METHOD_CONFIGURATION_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-Wert (active, inactive, pending, or unrequested) und dem display_preference-Wert.

  Sie können das Feld available verwenden, um festzulegen, ob eine Käuferin oder ein Käufer diese Zahlungsmethode beim Bezahlvorgang sieht. Wenn available true ist, ist die Funktion der Zahlungsmethode aktiv und display_preference ist eingeschaltet. Wenn available false ist, ist entweder die Funktion der Zahlungsmethode nicht aktiv oder der Wert display_preference ist ausgeschaltet, was bedeutet, dass Käufer/innen sie an der Kasse nicht sehen.

  Um Ihre Integration zu vereinfachen und weitere Funktionen zu nutzen, verwenden Sie bitte Zahlungsmethoden, die Sie über das Dashboard beim Bezahlvorgang verwalten. Dieses liest diesen Parameter automatisch und zeigt den Käuferinnen und Käufern die entsprechenden 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.

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 des Inhabers/der Inhaberin des verbundenen Kontos für diese Zahlungsmethode und wird verwendet, um zu bestimmen, ob die Käufer/innen die Zahlungsmethode sehen.

curl https://api.stripe.com/v1/payment_method_configurations/
{{PAYMENT_METHOD_CONFIGURATION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "affirm[display_preference][preference]"=on

{
  "id": 
"{{PAYMENT_METHOD_CONFIGURATION_ID}}",
  "object": "payment_method_configuration",
  "name": "My Custom Configuration",
  "active": true,
  "is_default": true,
  "livemode": false,
  "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
}

Wenn Ihre verbundenen Konten Zahlungsmethoden mit der API aktivieren, führt Stripe die intelligente Ermittlung der Zahlungsmethoden anhand des Käuferstandorts, des Bestellvolumens und anderer Faktoren durch, um die Zahlungsmethoden mit der höchsten Konversionsrate zuerst anzuzeigen.

Übergeben Sie die ID der übergeordneten Konfiguration beim Rendern Ihres Bezahlvorgangs, um Ihre neue Konfiguration zu verwenden. Stripe sucht automatisch die untergeordnete Konfiguration für das zugehörige verbundene Konto und verwendet dessen angepasste Einstellungen.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d mode=payment \
  -d "line_items[0][price]"=
"{{PRICE_ID}}" \
  -d "line_items[0][quantity]"=1 \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel" \
  -d currency=usd \
  -d payment_method_configuration=
"{{PAYMENT_METHOD_CONFIGURATION_ID}}"