Autorisierung erhöhen

Verwenden Sie den Parameter request_incremental_authorization, um die PaymentIntents anzugeben, die Sie erhöhen möchten.

Mit den Parametern if_available oder never bestimmen Sie, wann die Erhöhung eines PaymentIntent beginnen soll:

• if_available: Der erstellte PaymentIntent lässt zukünftige Erhöhungen basierend auf der inkrementellen Verfügbarkeit des Autorisierungs-Supports zu.

• never: Der erstellte PaymentIntent lässt keine zukünftigen Erhöhungen zu.

Sie können inkrementelle Autorisierungen für nicht erfasste Zahlungen nur nach der PaymentIntent-Bestätigung durchführen. Um den Betrag einer Zahlung vor der Bestätigung anzupassen, verwenden Sie stattdessen die Aktualisierungsmethode.

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

In der PaymentIntent-Bestätigungsantwort enthält das Feld payment_method_details für die latest_charge den Eintrag available oder unavailable, je nach der Kundenzahlungsmethode und den oben genannten Verfügbarkeitskriterien. Dadurch wird bestimmt, ob ein PaymentIntent für eine inkrementelle Autorisierung infrage kommt oder nicht. (Wenn Sie in Ihrer PaymentIntent-Bestätigungsanfrage keine inkrementelle Autorisierung angefordert haben, ist diese unavailable.)

// 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"
            }
          }
        }
        ...
      }
  }

}

Um den autorisierten Betrag für einen PaymentIntent zu erhöhen, verwenden Sie den increment_authorization-Endpoint und geben Sie den aktualisierten Autorisierungsbetrag an, auf den erhöht werden soll. Dieser muss größer als der ursprünglich autorisierte Betrag sein. Dadurch wird versucht, einen höheren Betrag für die Karte Ihres Kunden/Ihrer Kundin zu autorisieren. Ein einzelner PaymentIntent kann diesen Endpoint mehrmals aufrufen, um den autorisierten Betrag weiter zu erhöhen.

Sie haben maximal 10 inkrementelle Autorisierungsversuche pro PaymentIntent.

curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/increment_authorization \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=1500

Wenn die inkrementelle Autorisierung erfolgreich war, wird das PaymentIntent-Objekt mit dem aktualisierten Betrag zurückgegeben. Schlägt die Autorisierung fehl, wird stattdessen der Fehler card_declined zurückgegeben. Das PaymentIntent-Objekt kann weiterhin für den zuvor autorisierten Betrag erfasst werden. Alle potenziellen Aktualisierungen anderer PaymentIntent-Felder (z. B. application_fee_amount, transfer_data, metadata, description, and statement_descriptor) werden nicht gespeichert, wenn die inkrementelle Autorisierung fehlschlägt.

Die inkrementelle Autorisierung hat eine Obergrenze von entweder 500 USD (oder dem entsprechenden Betrag in lokaler Währung) oder 500 % über dem zuvor autorisierten Betrag (je nachdem, welcher Betrag höher ist) für jedes einzelne Inkrement.

Unabhängig davon, ob Sie den autorisierten Betrag für einen PaymentIntent mit einer inkrementellen Autorisierung erhöhen oder nicht, müssen Sie die Gelder erfassen, bevor die ursprüngliche Autorisierung abläuft. Inkrementelle Autorisierungen verlängern die Gültigkeitsdauer nicht. Um den autorisierten Betrag für einen PaymentIntent mit vorherigen inkrementellen Autorisierungen zu erfassen, verwenden Sie wie gewohnt den capture-Endpoint.

curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

Wenn die inkrementelle Autorisierung erfolgreich war, wird das erfasste PaymentIntent-Objekt mit dem aktualisierten Betrag zurückgegeben. Schlägt die Autorisierung fehl, wird stattdessen ein card_declined-Fehler zurückgegeben. Der PaymentIntent wird nicht erfasst, kann aber weiterhin für den zuvor autorisierten Betrag erfasst werden. Alle potenziellen Aktualisierungen an anderen PaymentIntent-Feldern (z. B. application_fee_amount, transfer_data, metadata, description and statement_descriptor) werden nicht gespeichert, wenn die inkrementelle Autorisierung fehlschlägt.

Verwenden Sie die Stripe-Testkarte für die inkrementelle Autorisierung mit einer beliebigen Prüfziffer (CVC), Postleitzahl und zukünftigem Ablaufdatum, um beim Testen inkrementelle Autorisierungen auszulösen:

1. Erstellen Sie zunächst die PaymentIntent mit der Testkarte im obigen Schritt „PaymentIntent erstellen und bestätigen“.

1. Führen Sie die inkrementelle Autorisierung mit den im obigen Schritt zur Durchführung einer inkrementellen Autorisierung angegebenen Parametern durch und verwenden Sie die Testkarte, um die inkrementelle Autorisierung auszulösen.