Mehrere Konfigurationen für Ihre Connect-Konten
Verwenden Sie diese Funktion, wenn Ihre Plattform dynamische Zahlungsmethoden verwendet und verschiedene Arten von Zahlungsmethoden für verschiedene Arten von Transaktionen oder verschiedene Rechnungsbeträge unterstützt. Dabei kann es sich beispielsweise um Abonnements oder einmalige Bezahlvorgänge handeln sowie um Rechnungen, die einen bestimmten Betrag überschreiten und mit „Jetzt kaufen, später bezahlen“ bezahlt werden können.
Neue Konfiguration für Zahlungsmethoden in Ihrem Dashboard erstellen
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.
Standardzustand auf Plattformebene festlegen
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: Die Zahlungsmethode wird für alle verbundenen Konten deaktiviert. Verbundene Konten können sie nicht aktivieren.
Anpassung durch Ihre verbundenen Konten gestatten
Verbundene Standard-Konten können das Dashboard aufrufen, um Zahlungsmethoden zu aktivieren oder zu 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.
{ "object": "list", "data": [ { "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" }"{{PAYMENT_METHOD_CONFIGURATION_ID}}"
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
, orunrequested
) und demdisplay_preference
-Wert.Mit dem Feld
available
bestimmen Sie, ob Käufer/innen bei der Bezahlung diese Zahlungsmethode sehen oder nicht. Istavailable
auftrue
festgelegt, so ist die Funktion der Zahlungsmethode aktiv, unddisplay_preference
ist aktiviert. Istavailable
auffalse
festgelegt, so hat die Zahlungsmethode entweder keine aktive Funktion oder der Wertdisplay_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
undvalue
.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 effektivendisplay_preference
-Wert wider.
Notiz
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.
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.
{ "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 }"{{PAYMENT_METHOD_CONFIGURATION_ID}}"
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.
Verfügbare Zahlungsmethoden im Bezahlvorgang anzeigen
Ü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.
Wenn Sie das Payment Element verwenden und vor dem Rendern des Payment Element einen PaymentIntent erstellen, können Sie die übergeordnete ID an Ihren PaymentIntent übergeben.
Wenn Sie das Payment Element mit dem Integrationspfad für die zurückgestellte Intent-Erstellung verwenden, können Sie die übergeordnete ID an die Sitzungsoptionen des Elements übergeben.
const options = { mode: 'payment', amount: 1099, currency: 'usd', payment_method_configuration:
}'{{PAYMENT_METHOD_CONFIGURATION_ID}}'
Wenn Sie eine Checkout Sitzung erstellen, können Sie die übergeordnete ID an Ihre Checkout-Sitzungsoptionen übergeben.
(Optional) – Apple Pay, Google Pay und Link
Einige Zahlungsmethoden, wie Apple Pay, Google Pay und Link, sind nicht als separate Zahlungsmethodentypen für einen PaymentIntent enthalten und werden nur bei Angabe der Karte 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.