Nicht erfasste Zahlungen prüfen

Standardmäßig erstellen Sie Stripe-Zahlungen in einem Schritt. Dadurch wird das Geld direkt, ohne weitere Maßnahmen Ihrerseits, an Ihr Bankkonto gesendet.

Stripe unterstützt jedoch auch zweistufige Zahlungen, bei denen eine Autorisierung und Erfassung stattfinden. Wenn diese Zahlungsart in Ihrer Integration verwendet wird, ist es wichtig zu verstehen, dass die Genehmigung einer Prüfung und die Erfassung einer Zahlung unterschiedliche Aktionen sind.

Nicht erfasste Zahlungen im Dashboard prüfen

Wenn Stripe eine nicht erfasste Zahlung zur Prüfung vorgelegt, wird im Dashboard zusätzlich zu den Schaltflächen zum Schließen der Prüfung durch Genehmigen oder Rückerstattung die Schaltfläche Erfassen angezeigt. Da die Rückerstattung nicht erfasster Zahlungen häufig als „Freigeben“ oder „Rückgängigmachen“ bezeichnet wird, ist für nicht erfasste Zahlungen außerdem die Schaltfläche Abbrechen statt der Schaltfläche Rückerstattung vorhanden.

Genehmigte Zahlungen mit der API automatisch erfassen

Über die API können Sie Ihre Integration so einrichten, dass:

• Zahlungen, die sich nicht im Status review befinden, sofort erfasst werden
• Zahlungen, die sich im Status review befinden, unerfasst bleiben müssen
• Die Zahlung sofort erfasst wird, wenn die Prüfung genehmigt wurde

Zahlungen, die nicht zur Prüfung vorgelegt wurden, sofort erfassen

Um eine nicht erfasste Zahlung zu erstellen, legen Sie das Erfassungsverhalten in der API-Anforderung entsprechend fest. Prüfen Sie danach das Attribut review des PaymentIntent. Wenn das Attribut leer ist, können Sie die Zahlung erfassen.

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

# Get the credit card details submitted by the form
# Create a PaymentIntent with manual capture
payment_intent = Stripe::PaymentIntent.create({
  amount: 1000,
  currency: 'usd',
  payment_method: '{{PAYMENT_METHOD_ID}}',
  description: 'Example charge',
  confirm: true,
  capture_method: 'manual',
})

# Check if the payment is in review. If not, capture it.
if !payment_intent.review
  payment_intent.capture
end

Zahlung erfassen, nachdem eine Prüfung genehmigt wurde

Standardmäßig bleiben Zahlungen im Status review im vorherigen Schritt unerfasst. In diesem Schritt verwenden Sie Webhooks, um diese Zahlungen nach der Genehmigung automatisch zu erfassen.

Konfigurieren Sie Ihre Webhooks so, dass sie das Ereignis review.closed überwachen. Die Ereignisdaten enthalten das Überprüfungs-Objekt, und das Attribut reason des Objekts gibt an, ob die Prüfung genehmigt wurde oder ob sie aus einem anderen Grund geschlossen wurde (da beispielsweise die Zahlung zurückerstattet wurde).

// Review object included in review.closed event webhook.
{
  "id": "prv_08voh1589O8KAxCGPcIQpmkz",
  "object": "review",
  "payment_intent": "pi_1D0CsEITpIrAk4QYdrWDnbRS",
  "created": 1474379631,
  "livemode": false,
  "open": false,
  "reason": "approved"
}

Die Zahlung kann erfasst werden, wenn das Attribut reason den Wert approved hat.

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

post "/my/webhook/url" do
  event_json = JSON.parse(request.body.read)
  event = Stripe::Event.retrieve(event_json["id"])

  if event.type == 'review.closed'
    review = event.object
    if review.reason == 'approved'
      pi = Stripe::PaymentIntent.retrieve(review.payment_intent)
      pi.capture
    end
  end

  status 200
end

Um genehmigte Zahlungen zu erfassen, muss der Prüfungsprozess innerhalb von 7 Tagen abgeschlossen werden. Andernfalls verfällt die Autorisierung wie bei jeder anderen nicht erfassten Zahlung automatisch und Sie können die Zahlung nicht mehr erfassen.