Zahlungen per iDEAL akzeptieren
So akzeptieren Sie Zahlungen per iDEAL, einer gängigen Zahlungsmethode in Belgien.
Vorsicht
Wir empfehlen Ihnen, den Leitfaden Zahlung akzeptieren zu befolgen, es sei denn, Sie müssen eine manuelle serverseitige Bestätigung verwenden oder Ihre Integration erfordert die separate Angabe von Zahlungsmethoden. Wenn Sie Elements bereits integriert haben, lesen Sie den Migrationsleitfaden für Payment Element.
Wenn Ihre App iDEAL akzeptiert, wird für die Kundinnen/Kunden eine Webansicht angezeigt, sodass sie die Zahlung im Onlineportal ihrer Bank autorisieren können. Danach kehren sie zu Ihrer App zurück und Sie werden sofort benachrichtigt, ob die Zahlung erfolgreich war oder fehlgeschlagen ist.
Notiz
Um Zahlungen per iDEAL akzeptieren zu können, müssen Sie unseren Allgemeinen Geschäftsbedingungen für iDEAL zustimmen.
Stripe einrichtenServerseitigClientseitig
Zunächst benötigen Sie ein Stripe-Konto. Registrieren Sie sich jetzt.
Serverseitig
Diese Integration erfordert Endpoints auf Ihrem Server, die mit der Stripe-API kommunizieren können. Nutzen Sie die offiziellen Bibliotheken für den Zugriff auf die Stripe-API von Ihrem Server aus:
Clientseitig
Das Stripe iOS SDK ist Open Source, vollständig dokumentiert und kompatibel mit Apps, die iOS 13 oder höher unterstützen.
Notiz
Details zur aktuellen SDK-Version und zu vorherigen Versionen finden Sie auf der Seite Releases auf GitHub. Um bei Veröffentlichung einer neuen Version eine Benachrichtigung zu erhalten, achten Sie auf die Releases zum jeweiligen Repository.
Konfigurieren Sie das SDK mit Ihrem veröffentlichbaren Schlüssel von Stripe, um es beim Start der App auszuführen. Dadurch kann Ihre App Anfragen an die Stripe-API senden.
Notiz
Verwenden Sie Ihre Testschlüssel beim Testen und Entwickeln Ihrer App und Ihre Live-Modus-Schlüssel beim Veröffentlichen Ihrer App.
Erstellen Sie ein PaymentIntentServerseitigClientseitig
Ein PaymentIntent ist ein Objekt, das Ihre Absicht, eine Kundenzahlung einzuziehen, darstellt und den gesamten Zahlungsvorgang dokumentiert.
Serverseitig
Erstellen Sie zunächst einen PaymentIntent
auf Ihrem Server und geben Sie den einzuziehenden Betrag und die Währung eur
an (iDEAL unterstützt keine anderen Währungen). Für iDEAL gibt es keinen Mindestabbuchungsbetrag, sodass der Wert für amount
in der Zahlung durchaus so gering wie 1 sein kann. Falls Sie bereits über eine Integration verfügen, die die Payment Intents API verwendet, fügen Sie der Liste der Zahlungsmethoden für Ihre PaymentIntent
die Zahlungsmethode ideal
hinzu.
Statt das gesamte PaymentIntent-Objekt an Ihre App zu übergeben, müssen Sie nur das Client-Geheimnis übergeben. Das Client-Geheimnis des PaymentIntent ist ein eindeutiger Schlüssel, mit dem Sie die Zahlung bestätigen und Zahlungsdetails auf dem Client aktualisieren können, ohne dass eine Manipulation vertraulicher Daten, wie beispielsweise des Zahlungsbetrags, möglich ist.
Clientseitig
Fordern Sie auf dem Client einen PaymentIntent von Ihrem Server an und speichern Sie das zugehörige Client-Geheimnis.
Angaben zur Zahlungsmethode erfassenClientseitig
Erfassen Sie in Ihrer App den vollständige Namen der Kundin/des Kunden. Erstellen Sie ein STPPaymentIntentParams-Objekt mit diesem Detail.
Zahlung an Stripe sendenClientseitig
Rufen Sie das Client-Geheimnis von dem in Schritt 2 erstellten PaymentIntent ab und rufen Sie STPPaymentHandler confirmPayment auf. Dies entspricht einer Webansicht, sodass die Kundinnen/Kunden die Zahlung auf der Website oder in der App ihrer Bank durchführen können, wodurch der Completion-Block mit dem Ergebnis der Zahlung aufgerufen wird.
Integration testen
Verwenden Sie Ihre Test-API-Schlüssel, um den PaymentIntent zu bestätigen. Nach der Bestätigung werden Sie an eine Testseite mit Optionen zur Autorisierung oder Ablehnung der Zahlung weitergeleitet.
- Klicken Sie auf Authorize test payment (Testzahlung autorisieren), um den Fall zu testen, wenn die Zahlung erfolgreich durchgeführt wird. Die PaymentIntent wechselt von
requires_
zuaction succeeded
. - Klicken Sie auf Fail test payment (Testzahlung ablehnen), um den Fall zu testen, wenn der/die Kund/in nicht authentifiziert werden kann. Die PaymentIntent wechselt von
requires_
zuaction requires_
.payment_ method
Bankreferenz
Bankname | Value |
---|---|
ABN AMRO | abn_ |
ASN Bank | asn_ |
Bunq | bunq |
ING | ing |
Knab | knab |
N26 | n26 |
Nationale-Nederlanden | nn |
Rabobank | rabobank |
Revolut | revolut |
RegioBank | regiobank |
SNS Bank (De Volksbank) | sns_ |
Triodos Bank | triodos_ |
Van Lanschot | van_ |
Yoursafe | yoursafe |