# Standardzahlungsmethoden im Dashboard verwalten

Aktualisieren Sie Ihre API, um Zahlungsmethoden standardmäßig im Dashboard zu verwalten.

Am 16. August 2023 [aktualisierte Stripe das Auswahlverfahren](http://stripe.com/blog/dynamic-payment-methods) für Standard-Zahlungsmethoden, die für PaymentIntents und SetupIntents gelten, die mit den APIs [/v1/payment_intents](https://docs.stripe.com/api/payment_intents.md) und [/v1/setup_intents](https://docs.stripe.com/api/setup_intents.md) erstellt wurden.

In früheren Versionen der Stripe API hat Stripe standardmäßig Kartenzahlung sowohl für PaymentIntents als auch SetupIntents angewendet, wenn Sie keinen [payment_method_types](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-payment_method_types)-Parameter angegeben haben.

Künftig wendet Stripe berechtigte Zahlungsmethoden standardmäßig auf Ihre PaymentIntents und SetupIntents an, wenn Sie den Parameter `payment_method_types` in der Erstellungsanfrage nicht angeben. Diese Einstellungen können Sie über Ihr [Dashboard](https://dashboard.stripe.com/settings/payment_methods) verwalten.

### Zahlungsmethoden

Standardmäßig aktiviert Stripe Karten und andere gängige Zahlungsmethoden. Sie können einzelne Zahlungsmethoden im [Stripe Dashboard](https://dashboard.stripe.com/settings/payment_methods) aktivieren oder deaktivieren. In Checkout wertet Stripe die Währung und etwaige Einschränkungen aus und zeigt den Kundinnen/Kunden dann dynamisch die unterstützten Zahlungsmethoden an.

Um zu sehen, wie Ihre Zahlungsmethoden Kundinnen und Kunden angezeigt werden, geben Sie eine Transaktions-ID ein oder legen Sie einen Bestellbetrag und eine Währung im Dashboard fest.

Sie können Apple Pay und Google Pay in Ihren [Einstellungen für Zahlungsmethoden](https://dashboard.stripe.com/settings/payment_methods) aktivieren. Standardmäßig ist Apple Pay aktiviert und Google Pay deaktiviert. In einigen Fällen filtert Stripe die Optionen jedoch heraus, auch wenn sie aktiviert sind. Wir filtern Google Pay, wenn Sie [automatische Steuern aktivieren](https://docs.stripe.com/tax/checkout.md), ohne eine Versandadresse zu erfassen.

Die von Stripe gehosteten Checkout-Seiten benötigen keine Integrationsänderungen, um Apple Pay oder Google Pay zu aktivieren. Stripe verarbeitet diese Zahlungen genauso wie andere Kartenzahlungen.

## Aktualisieren Sie Ihre Zahlungsabläufe

Wählen Sie aus dem Upgrade-Pfad, der Ihrer aktuellen Stripe-Integration entspricht:

#### Elements

Wenn Sie das Card Element oder einzelne Elements für Zahlungsmethoden in Ihrer Integration verwenden, empfehlen wir die Migration zu [Payment Elements](https://docs.stripe.com/payments/payment-element/migration.md). Mit dieser einfachen, einheitlichen Integration können Sie mehr als 25 verschiedene Zahlungsmethoden akzeptieren.

### PaymentIntent erstellen

In dieser Version der API ist die Angabe des Parameters [automatic_payment_methods.enabled](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-automatic_payment_methods-enabled) optional. Wenn Sie den Parameter nicht angeben, nimmt Stripe den Wert `true` an, wodurch seine Funktionalität standardmäßig aktiviert wird.

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1099 \
  -d currency=usd
```

### Clientseitige Bestätigungen mit Stripe.js

Wenn Ihre Integration Stripe.js verwendet, um Zahlungen mit [confirmPayment](https://docs.stripe.com/js/payment_intents/confirm_payment) oder per [Zahlungsmethode](https://docs.stripe.com/js/payment_intents/payment_method) zu bestätigen, bleiben Ihre bestehenden Prozesse unverändert und erfordern keine weiteren Änderungen.

Wenn Sie Zahlungen bestätigen, empfehlen wir Ihnen, den Parameter [return_url](https://docs.stripe.com/api/payment_intents/confirm.md#confirm_payment_intent-return_url) anzugeben. Auf diese Weise können Sie Zahlungsmethoden akzeptieren, die [eine Weiterleitung erfordern](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#additional-api-supportability).

#### HTML + JS

```javascript
const form = document.getElementById('payment-form');

form.addEventListener('submit', async (event) => {
  event.preventDefault();
const {error} = await stripe.confirmPayment({
    //`Elements` instance that was used to create the Payment Element
    elements,
    confirmParams: {
      return_url: 'https://example.com/return_url',
    },
  });

  if (error) {
    // This point will only be reached if there is an immediate error when
    // confirming the payment. Show error to your customer (for example, payment
    // details incomplete)
    const messageContainer = document.querySelector('#error-message');
    messageContainer.textContent = error.message;
  } else {
    // Your customer will be redirected to your `return_url`. For some payment
    // methods like iDEAL, your customer will be redirected to an intermediate
    // site first to authorize the payment, then redirected to the `return_url`.
  }
});
```

#### React

```jsx
import React, {useState} from 'react';
import {useStripe, useElements, PaymentElement} from '@stripe/react-stripe-js';

const CheckoutForm = () => {
  const stripe = useStripe();
  const elements = useElements();

  const [errorMessage, setErrorMessage] = useState(null);

  const handleSubmit = async (event) => {
    // We don't want to let default form submission happen here,
    // which would refresh the page.
    event.preventDefault();

    if (!stripe || !elements) {
      // Stripe.js hasn't yet loaded.
      // Make sure to disable form submission until Stripe.js has loaded.
      return;
    }
const {error} = await stripe.confirmPayment({
      //`Elements` instance that was used to create the Payment Element
      elements,
      confirmParams: {
        return_url: 'https://example.com/return_url',
      },
    });


    if (error) {
      // This point will only be reached if there is an immediate error when
      // confirming the payment. Show error to your customer (for example, payment
      // details incomplete)
      setErrorMessage(error.message);
    } else {
      // Your customer will be redirected to your `return_url`. For some payment
      // methods like iDEAL, your customer will be redirected to an intermediate
      // site first to authorize the payment, then redirected to the `return_url`.
    }
  };

  return (
    <form onSubmit={handleSubmit}>
      <PaymentElement />
      <button disabled={!stripe}>Submit</button>
      {/* Show error message to your customers */}
      {errorMessage && <div>{errorMessage}</div>}
    </form>
  )
};

export default CheckoutForm;
```

### Serverseitige Bestätigung

Wenn Sie die serverseitige Bestätigung nutzen, müssen Sie den Parameter [return_url](https://docs.stripe.com/api/payment_intents/confirm.md#confirm_payment_intent-return_url) in Ihrer Integration verwenden.

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1099 \
  -d currency=usd \
  -d confirm=true \
  -d "payment_method={{PAYMENTMETHOD_ID}}" \
  --data-urlencode "return_url=https://example.com/return_url"
```

Alternativ können Sie den PaymentIntent oder SetupIntent mit dem Parameter [automatic_payment_methods.allow_redirects](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-automatic_payment_methods-allow_redirects) auf `never` erstellen. Dadurch wird die `return_url` Anforderung bei der Bestätigung deaktiviert. Sie können die Zahlungsmethoden immer noch über das [Dashboard](https://dashboard.stripe.com/settings/payment_methods) verwalten, aber die [Zahlungsmethoden, die eine Weiterleitung](https://docs.stripe.com/payments/bank-redirects.md#bank-redirects-api-support) erfordern, stehen nicht zur Verfügung.

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1099 \
  -d currency=usd \
  -d confirm=true \
  -d "payment_method={{PAYMENTMETHOD_ID}}" \
  -d "automatic_payment_methods[enabled]=true" \
  -d "automatic_payment_methods[allow_redirects]=never"
```

Abschließend können Sie den PaymentIntent oder den SetupIntent mit dem Parameter [payment_method_types](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-payment_method_types) erstellen. Dadurch wird außerdem die Anforderung der `return_url` bei der Bestätigung deaktiviert. Mit dieser Option können Sie Zahlungsmethoden nicht über das [Dashboard](https://dashboard.stripe.com/settings/payment_methods) verwalten.

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1099 \
  -d currency=usd \
  -d confirm=true \
  -d "payment_method={{PAYMENTMETHOD_ID}}" \
  -d "payment_method_types[]=card"
```

#### Checkout und Payment Links

Wenn Sie Checkout und Payment Links in Ihrer Integration nutzen, erfahren Sie im [Leitfaden zum Aktualisieren Ihrer API-Version](https://docs.stripe.com/upgrades.md#how-can-i-upgrade-my-api), wie Sie ein Upgrade durchführen, ohne Änderungen an Ihrem Integrationscode vorzunehmen.

#### API

Wenn Ihre Integration Zahlungen mit dem auf `true` festgelegten Parameter [off_session](https://docs.stripe.com/api/payment_intents/confirm.md#confirm_payment_intent-off_session) bestätigt, bleiben Ihre bestehenden Prozesse unverändert und es sind keine weiteren Änderungen erforderlich.

Andernfalls müssen Sie den Parameter [return_url](https://docs.stripe.com/api/payment_intents/confirm.md#confirm_payment_intent-return_url) in Ihrer Integration angeben.

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1099 \
  -d currency=usd \
  -d confirm=true \
  -d "payment_method={{PAYMENTMETHOD_ID}}" \
  --data-urlencode "return_url=https://example.com/return_url"
```

Alternativ können Sie den PaymentIntent oder SetupIntent mit dem auf `never` festgelegten Parameter [automatic_payment_methods.allow_redirects](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-automatic_payment_methods-allow_redirects) erstellen. Dadurch wird außerdem die Anforderung der `return_url` bei der Bestätigung deaktiviert. Zahlungsmethoden können Sie weiterhin über das [Dashboard](https://dashboard.stripe.com/settings/payment_methods) verwalten. Für Zahlungsmethoden, die Weiterleitungen erfordern, ist dies jedoch nicht möglich.

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1099 \
  -d currency=usd \
  -d confirm=true \
  -d "payment_method={{PAYMENTMETHOD_ID}}" \
  -d "automatic_payment_methods[enabled]=true" \
  -d "automatic_payment_methods[allow_redirects]=never"
```

Abschließend können Sie den PaymentIntent oder den SetupIntent mit dem Parameter [payment_method_types](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-payment_method_types) erstellen. Dadurch wird außerdem die Anforderung der `return_url` bei der Bestätigung deaktiviert. Mit dieser Option können Sie Zahlungsmethoden nicht über das [Dashboard](https://dashboard.stripe.com/settings/payment_methods) verwalten.

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1099 \
  -d currency=usd \
  -d confirm=true \
  -d "payment_method={{PAYMENTMETHOD_ID}}" \
  -d "payment_method_types[]=card"
```