Payment Method Configurations API

Legen Sie im Stripe-Dashboard auf der Seite Zahlungsmethoden für Ihre verbundenen Konten verwalten den Standard für einzelne Zahlungsmethoden fest, um die standardmäßig aktivierten Zahlungsmethoden zu bearbeiten.

Klicken Sie im Dashboard auf das Zahnradsymbol oben rechts, um die Seite mit den Produkteinstellungen zu öffnen. Klicken Sie im Abschnitt Zahlungen auf den Link Zahlungsarten.

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.

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

• Standardmäßig deaktivierte verbundene Konten können die Zahlungsmethode ein oder ausschalten. Standardmäßig ist sie ausgeschaltet.
• Blockiert deaktiviert die Zahlungsmethode für alle verbundenen Konten. Inhaber/innen verbundener Konten können sich nicht anmelden.
• Standardmäßig aktivierte verbundene Konten können die Zahlungsmethode ein- oder ausschalten. Standardmäßig ist sie eingeschaltet.

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

curl -G https://api.stripe.com/v1/payment_method_configurations \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d application=
{{CLIENT_APPLICATION_ID}}

{
  "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-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.

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 https://api.stripe.com/v1/payment_method_configurations/
{{PAYMENT_METHOD_CONFIGURATION_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "affirm[display_preference][preference]"=on

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

Zahlungsmethoden können Sie über das Dashboard 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.

Einige Zahlungsmethoden, wie Apple Pay und Link, sind nicht als separate Zahlungsmethodentypen für einen PaymentIntent enthalten und werden nur bei Angabe von 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.

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.