Teilautorisierung

Verwenden Sie Teilautorisierungen, um die Genehmigung für einen Teil des ursprünglich angeforderten Betrags für eine Kartentransaktion anzufordern, wenn das verfügbare Guthaben nicht ausreicht, um den vollen Betrag abzudecken. Auf diese Weise können Ihre Kundinnen und Kunden das verfügbare Guthaben auf ihrer Karte (z. B. einer Debitkarte) verwenden und dann eine alternative Zahlungsmethode zur Bezahlung des Restbetrags nutzen.

Bevor Sie loslegen

Entscheiden Sie zunächst, wie Sie mit dem Teil des ursprünglich angeforderten Betrags umgehen möchten, der nicht durch die Teilautorisierung abgedeckt ist. Sie können einen separaten PaymentIntent für eine andere Zahlungsart erstellen, den gesamten PaymentIntent stornieren oder nur den teilweise autorisierten Betrag erfassen. Stellen Sie sicher, dass Sie Ihren Kundinnen/Kunden klar und deutlich mitteilen, wie Sie mit der Transaktion fortfahren möchten und welche möglichen Auswirkungen dies auf sie haben könnte.

Verfügbarkeit

Teilautorisierungen unterliegen folgenden Einschränkungen:

• Sie können Teilautorisierungen nur für Online-Kartenzahlungen verwenden.
• Nur Visa, Mastercard, Discover und Amex unterstützen Teilautorisierungen.
• Der Aussteller und der Kartentyp bestimmen, ob sie unterstützt werden.
• Wenn ein Transaktionsbetrag teilweise autorisiert wurde, können Sie mit der Übererfassung aufgrund von Netzwerkeinschränkungen keine Beträge erfassen, die über dem autorisierten Betrag liegen.
• Wenn Sie Zahlungen im Auftrag Ihres Connect-Kontos mithilfe eines transfer_amount abwickeln, beschränkt Stripe diese auf den teilweise autorisierten Betrag, wenn der transfer_amount größer als der teilweise autorisierte Betrag ist.
• Stripe erzwingt einen Mindestzahlungsbetrag für teilweise autorisierte Zahlungen und lehnt jeden geringen PaymentIntent ab.

Manuelle Erfassung zum Erstellen und Bestätigen von PaymentIntents verwenden

Um eine Teilautorisierung für bestimmte PaymentIntents zu aktivieren, setzen Sie if_available auf den Parameter request_partial_authorization.

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

Teilautorisierungsstatus verifizieren

Überprüfen Sie das Feld payment_method_details im latest_charge in der Bestätigungsantwort des PaymentIntent, um festzustellen, ob die Netzwerke eine Teilautorisierung für die Zahlung angewendet haben:

• partial_authorization.status: Zeigt einen der folgenden Autorisierungsstatus an: partially_authorized, fully_authorized, declined oder not_requested.
• amount_requested: Bestätigt Ihren ursprünglich angegebenen Anforderungsbetrag.
• amount_authorized: Legt den autorisierten Betrag fest.

Die folgende Beispielantwort zeigt, dass die Transaktion teilweise für 70 USD autorisiert wurde, was weniger als die ursprünglich angeforderten 100 USD ist.

{
  "id": "pi_foo",
  "amount": 7000,
  "amount_capturable": 7000,
  "amount_received": 0,
  "capture_method": "manual",
  ...
  // if latest_charge is expanded
  "latest_charge": {
    "id": "ch_foo",
    "object": "charge",
    "amount": 7000,
    "captured": false,
    "payment_method_details": {
      "card": {
        "amount_authorized": 7000,
        "amount_requested": 10000,
        "partial_authorization": {
          "status": "partially_authorized",
        }
      }
    }
  },
  ...
  "status": "requires_capture"
}

Lehnt der/die Kartenaussteller/in die Autorisierung ab, gibt diese Antwort einen Fehler des Typs card_declined zurück.

Teilweise autorisierten PaymentIntent erfassen

Sie können einen autorisierten PaymentIntent bis zu dem Betrag (oder amount_capturable) erfassen, der in der Bestätigungsantwort zurückgegeben wird.

curl -X POST https://api.stripe.com/v1/payment_intents/pi_foo/capture \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Eine erfolgreiche Erfassung gibt das PaymentIntent-Objekt mit aktualisierten Feldern zurück:

{
  "id": "pi_foo",
  "amount": 7000,
  "amount_capturable": 0,
  "amount_received": 7000,
  "capture_method": "manual",
  "latest_charge": "ch_foo",
  ...
  "status": "succeeded",
}

Ihre Integration testen

Um beim Testen eine Teilautorisierung auszulösen, verwenden Sie die Stripe-Testkarte für die Teilautorisierung mit beliebiger Prüfziffer (CVC), Postleitzahl und zukünftigem Ablaufdatum. Legen Sie request_partial_authorization unbedingt auf if_available fest, um eine Teilautorisierung mit der Testkarte auszulösen.