# Standardzahlungsmethoden im Dashboard verwalten

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

Am 16.&nbsp;August&nbsp;2023 hat Stripe den [Auswahlprozess](https://stripe.com/blog/dynamic-payment-methods) für Standard-Zahlungsmethoden aktualisiert, die für 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) erstellte PaymentIntents und SetupIntents gelten.

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 den Kundinnen und Kunden angezeigt werden, geben Sie auf der Seite [Zahlungsmethoden überprüfen](https://dashboard.stripe.com/settings/payment_methods/review) im Dashboard eine Transaktions-ID ein oder legen Sie einen Bestellbetrag und eine Währung fest.

Der Bezahlvorgang unterstützt Apple Pay und Google Pay, ohne dass Änderungen an der Integration erforderlich sind. Erfahren Sie, wie Sie die [Wallets testen](https://docs.stripe.com/testing/wallets.md?ui=embedded-page) können.

## 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&nbsp;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 SetupIntent mit dem Parameter [allowed_payment_method_types](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-allowed_payment_method_types) erstellen. Dadurch wird auch das Anfordern 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 "allowed_payment_method_types[]=card"
```

#### Checkout und Payment Links

Falls Ihre Integration Checkout und Payment Links verwendet, lesen Sie bitte die Anleitung zum [Aktualisieren Ihrer API-Version](https://docs.stripe.com/upgrades.md), um das Upgrade durchzuführen, ohne Änderungen an Ihrem Integrationscode vornehmen zu müssen.

#### 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 SetupIntent mit dem Parameter [allowed_payment_method_types](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-allowed_payment_method_types) erstellen. Dadurch wird auch das Anfordern 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 "allowed_payment_method_types[]=card"
```
