Umstellung auf die neuesten flexiblen Zahlungsszenarien

Stripe unterstützt jetzt mehrere flexible Zahlungsszenarien für Transaktionen ohne Karte. Wenn Sie die private Beta-Version einer dieser Funktionen bereits integriert haben, finden Sie in diesem Leitfaden Details zum Upgrade auf die allgemeine Version. Informationen zu neuen Integrationen finden Sie in den folgenden Leitfäden für die Funktionen, die Sie interessieren:

• 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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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.