Auf die neuesten flexiblen Zahlungsszenarien umstellen

Stripe now supports several flexible payment scenarios for non-card-present transactions. If you’ve already integrated the private beta version of any of these features, this guide provides details to upgrade to the general release. For new integrations, use the following guides for the features that interest you:

• Eine Autorisierung schrittweise erhöhen
• Mehr als den autorisierten Betrag erfassen
• Online-Kartenzahlung länger zurückhalten
• Eine Zahlung mehrmals erfassen

Wir haben die folgenden auf Feedback basierenden Verbesserungen an diesen Funktionen vorgenommen:

• Detaillierte Kontrolle über die Funktionen auf der Ebene des PaymentIntent.
• Klarere Erwartungen in Bezug auf die Verfügbarkeit und Nutzung von Funktionen nach einer Bestätigungsphase.

Für jede der flexiblen Zahlungsfunktionen gelten andere Anforderungen als für die Private Beta-Integration. Wählen Sie die Funktion aus, die Sie aktualisieren möchten, und lesen Sie den Hinweis oben bezüglich der Änderungen und Anforderungen, die für diese Funktion gelten.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]"=card \
  -d payment_method=pm_card_debit_incrementalAuthAuthorized \
  -d confirm=true \
  -d capture_method=manual \
  -d "expand[]"=latest_charge \
  -d "payment_method_options[card][request_incremental_authorization_support]"=true

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]"=card \
  -d payment_method=pm_card_debit_incrementalAuthAuthorized \
  -d confirm=true \
  -d capture_method=manual \
  -d "expand[]"=latest_charge \
  -d "payment_method_options[card][request_incremental_authorization]"=if_available

// PaymentIntent Response
{
  "id": "pi_ANipwO3zNfjeWODtRPIg",
  "object": "payment_intent",
  "amount": 1000,
  "amount_capturable": 1000,
  "amount_received": 0,
  ...
  // if latest_charge is expanded
  {
    "latest_charge": {
        "amount": 1000,
        "payment_method_details": {
          "card": {
            "incremental_authorization_supported": true // or false
          }
        }
        ...
      }
  }
}

// PaymentIntent Response
{
  "id": "pi_ANipwO3zNfjeWODtRPIg",
  "object": "payment_intent",
  "amount": 1000,
  "amount_capturable": 1000,
  "amount_received": 0,
  ...
  // if latest_charge is expanded
  {
    "latest_charge": {
        "amount": 1000,
        "payment_method_details": {
          "card": {
            "incremental_authorization": {
                "status": "available" // or "unavailable"
            }
          }
        }
        ...
      }
  }
}

curl https://api.stripe.com/v1/payment_intents/pi_ANipwO3zNfjeWODtRPIg/increment_authorization \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1500

Wählen Sie aus, wie Sie mehr als den ursprünglich autorisierten Betrag erfassen möchten

Zwei der flexiblen Zahlungsfunktionen ermöglichen es Ihnen, einen höheren als den ursprünglich autorisierten Betrag zu erfassen:

• Übererfassung bis zu einem bestimmten Limit (Mehr als den autorisierten Betrag einer Zahlung erfassen)
• Erhöhen Sie die bestehende Autorisierung und erfassen Sie dann den neu autorisierten Betrag (Autorisierung erhöhen)

Das folgende Beispiel zeigt, wie sich diese Funktionen in der allgemein verfügbaren Version ergänzen können.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]"=card \
  -d payment_method=pm_card_visa \
  -d confirm=true \
  -d capture_method=manual \
  -d "expand[]"=latest_charge \
  -d "payment_method_options[card][request_incremental_authorization]"=if_available \
  -d "payment_method_options[card][request_overcapture]"=if_available

// PaymentIntent Response
{
  "object": "payment_intent",
  "amount": 1000,
  ...
  // if latest_charge is expanded
  {
    "latest_charge": {
      "payment_method_details": {
        "card": {
          "incremental_authorization": {
              "status": "available" // or "unavailable"
          },
          "overcapture": {
              "status": "available", // or "unavailable"
              "maximum_capturable_amount": 1200
          }
        }
      }
      ...
    }
  }
}

Wenn beide Funktionen verfügbar sind, haben Sie nach derBestätigung des PaymentIntent bei den nächsten Schritten die Möglichkeit, einen höheren als den ursprünglich autorisierten Betrag zu erfassen:

1. Führen Sie eine Übererfassung durch, wenn der gewünschte Betrag kleiner oder gleich dem maximum_capturable_amount ist.
2. Führen Sie eine inkrementelle Autorisierung bis zum gewünschten Betrag durch und führen Sie dann die Erfassung durch.