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.

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.

  Mit dem Feld available bestimmen Sie, ob Käufer/innen bei der Bezahlung diese Zahlungsmethode sehen oder nicht. Ist available auf true festgelegt, so ist die Funktion der Zahlungsmethode aktiv, und display_preference ist aktiviert. Ist available auf false festgelegt, so hat die Zahlungsmethode entweder keine aktive Funktion oder der Wert display_preference ist deaktiviert, sodass Käuferinnen und Käufern diese Methode zum Zeitpunkt der Bezahlung nicht angezeigt wird. Zur Verbesserung Ihrer Integration und zur Nutzung weiterer Funktionen verwenden Sie beim Bezahlvorgang Zahlungsmethoden, die Sie im Dashboard verwalten. 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.

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}}