Test Stripe Terminal
Erfahren Sie, wie Sie Ihre Terminal-Integration testen können.
Notiz
Ein Großteil des Verfahrens zum Testen von Stripe Terminal entspricht dem Verfahren für das Testen von Online-Zahlungen per Stripe. Außerdem können Sie Stripe Terminal im Testmodus nicht mit mobilen Wallets (z. B. Apple Pay oder Google Pay) verwenden. Weitere Informationen finden Sie im allgemeinen Stripe-Testleitfaden.
Der beste Weg für eine erfolgreiche Terminal-Bereitstellung besteht darin, jeden Teil Ihrer Integration zu testen. Wir stellen Test-Tools für jede Phase zur Verfügung:
- Testen Sie Ihre Integration mit dem Lesegerät-Simulator, bevor Sie ein Lesegerät bestellen.
- Testen Sie die komplette Integration Ihrer Hardware mit einer physischen Testkarte.
Simuliertes Lesegerät
Stripe Terminal SDKs und die servergestützte Integration verfügen über ein integriertes simuliertes Kartenlesegerät, sodass Sie Ihre App entwickeln und testen können, ohne eine Verbindung zu physischer Hardware herstellen zu müssen. Mit dem simulierten Lesegerät können Sie alle Terminal-Abläufe in Ihrer App nachbilden, unabhängig davon, ob Ihre Integration abgeschlossen ist oder sich noch im Aufbau befindet.
Das simulierte Lesegerät bietet keine Nutzeroberfläche. Nachdem Sie in Ihrer App eine Verbindung damit hergestellt haben, können Sie sehen, dass es funktioniert, wenn Aufrufe des Stripe SDK oder der API erfolgreich sind.
Simulierte Lesegeräte für SDKs simulieren bei Bedarf automatisch die Kartenpräsentation. Aktualisieren Sie für die serverseitige Integration Ihre Integration auf Kartenwährung simulieren.
Simulierte Testkarten
Das simulierte Lesegerät kann so konfiguriert werden, dass es eine simulierte Testkarte verwendet, mit der verschiedene Abläufe innerhalb Ihrer Point-of-Sale-Anwendung getestet werden können.
Bevor Sie eine Zahlungsmethode erfassen, konfigurieren Sie das simulierte Lesegerät so, dass es mithilfe einer der folgenden Testkartennummern oder Testzahlungsmethoden bestimmte Antworten erzeugt.
Standard-Testkarten
Testkartennummer | Testzahlungsmethode | Marke |
---|---|---|
visa | Visa | |
visa_ | Visa (Debit) | |
mastercard | Mastercard | |
mastercard_ | Mastercard (Debit) | |
mastercard_ | Mastercard (Prepaid) | |
amex | American Express | |
amex2 | American Express | |
discover | Discover | |
discover2 | Discover | |
diners | Diners Club | |
diners_ | Diners Club (14-stellige Karte) | |
jcb | JCB | |
unionpay | UnionPay | |
interac | Interac | |
eftpos_ | eftpos Australia | |
eftpos_ | EFTPOS Australien/Visa | |
eftpos_ | EFTPOS Australien/Mastercard |
Testkarten für bestimmte Erfolgsfälle
Testkartennummer | Testzahlungsmethode | Ergebnis |
---|---|---|
offline_ | Simuliert eine Aufforderung an Karteninhaber/innen, eine Offline-PIN einzugeben. Für die resultierende Zahlung ist die cardholder_verification_method auf offline_ festgelegt. | |
offline_ | Kundenauthentifizierung](/strong-customer-authentication) ausgelösten Wiederholungsvorgang, bei dem die anfängliche kontaktlose Zahlung einer Karteninhaberin/eines Karteninhabers fehlschlägt und das Lesegerät diese/diesen dann auffordert, die Karte einzuführen und die zugehörige offline PIN. einzugeben. Für die resultierende Abbuchung ist cardholder_verification_method auf offline_ gesetzt. | |
online_ | Simuliert eine Aufforderung an Karteninhaber/innen, eine Online-PIN einzugeben. Für die resultierende Zahlung ist die cardholder_verification_method auf online_ festgelegt. | |
online_ | Simuliert einen durch die starke Kundenauthentifizierung ausgelösten Wiederholungsvorgang, bei dem die anfängliche kontaktlose Zahlung einer Karteninhaberin/eines Karteninhabers fehlschlägt und das Lesegerät diese/diesen dann auffordert, die zugehörige Online-PIN einzugeben. Für die endgültige Zahlung ist cardholder_verification_method auf online_ gesetzt. |
Testkarten für bestimmte Fehlerfälle
Notiz
Die Verwendung dieser Karten für das direkte Speichern ohne Belastung und SetupIntents gibt eine setup_intent_authentication_failure-Antwort zurück.
Testkartennummer | Testzahlungsmethode | Ergebnis |
---|---|---|
charge_ | Die Abbuchung wird mit dem Code card_ abgelehnt. | |
charge_ | Die Abbuchung wird mit dem Code card_ abgelehnt. Das decline_code-Attribut ist insufficient_ . | |
charge_ | Die Abbuchung wird mit dem Code card_ abgelehnt. Das decline_code-Attribut ist lost_ . | |
charge_ | Die Abbuchung wird mit dem Code card_ abgelehnt. Das decline_code-Attribut ist stolen_ . | |
charge_ | Die Abbuchung wird mit dem Code expired_ abgelehnt. | |
charge_ | Die Abbuchung wird mit dem Code processing_ abgelehnt. | |
refund_ | Die Abbuchung ist erfolgreich, aber die Rückerstattung einer erfassten Zahlung schlägt asynchron mit dem failure_ expired_ fehl. Da eine Rückerstattung asynchron fehlschlägt, scheint sie zunächst erfolgreich zu sein und weist den Status failed nur für nachfolgende Abrufe auf. Wir benachrichtigen Sie auch über fehlgeschlagene Rückerstattungen mit dem Webhook-Ereignis refund. . Dieser simulierte Fehler wird nur im JavaScript-SDK unterstützt. |
Simulierte Kartenpräsentation
Nutzen Sie bei Verwenden der servergestützten Integration den Endpoint present_payment_method, um zu simulieren, dass Karteninhaber/innen ihre Karte auf das Lesegerät auflegen oder in dieses einführen.
{ "id": "tmr_xxx", "object": "terminal.reader", "action": { "failure_code": null, "failure_message": null, "process_payment_intent": { "payment_intent": "pi_xxx" }, "status": "succeeded", "type": "process_payment_intent" }, … }
Wenn Sie keine Parameter angeben, wird für die simulierte Zahlung standardmäßig eine gültige Testkarte verwendet, die auf der Art der Zahlungsmethode des PaymentIntent basiert. Nachfolgend finden Sie die Standard-Testkarten für die Arten von Terminal-Zahlungsmethoden:
Art der Zahlungsmethode | Testkartennummer | Testzahlungsmethode |
---|---|---|
card_ | visa | |
card_ und interac_ | visa | |
interac_ | interac |
Mit den Standard-Testkarten können Sie zur Simulation von Fehlerszenarien auch Testbeträge verwenden.
Aktualisierungen für simulierte Lesegeräte
Während der Verbindung zu einem simulierten Bluetooth-Lesegerät können Sie eine Aktualisierung für ein simuliertes Lesegerät konfigurieren.
Physische Testkarten
Testen Sie Zahlungen mit Ihrem Lesegerät von Stripe Terminal mithilfe einer physischen Testkarte. Sie können Lesegeräte und physische Karten im Stripe-Dashboard unter der Registerkarte „Terminal“ kaufen.
Diese physische Testkarte unterstützt sowohl Zahlungen per Karteneingabe als auch kontaktlose Zahlungen. Es funktioniert nur mit von Stripe vorzertifizierten Lesegeräten und nur mit der Stripe API in einer Sandbox. Wenn Sie versuchen, Ihre physische Testkarte im Live-Modus zu verwenden, gibt die Stripe API einen Fehler zurück. Sofern es nicht anders angegeben ist, verwenden Sie bei entsprechender Aufforderung die PIN 1234
.
Beim Erstellen von Zahlungen mit einer physischen Testkarte sollten Sie Beträge verwenden, die auf die folgenden Werte enden, um bestimmte Antworten zu erzeugen:
Dezimal | Ergebnis |
---|---|
00 | Die Zahlung wird genehmigt. |
01 | Die Zahlung wird mit dem Code call_ abgelehnt. |
02 | Wenn Sie Lesegeräte mit einem Bildschirm verwenden, den die Karteninhaber/innen sehen, legen Sie die Testkarte ein (oder tippen Sie darauf, falls dies unterstützt wird). Wenn für die Karte eine PIN erforderlich ist, wird die Zahlung mit offline_ abgelehnt und es wird eine PIN-Eingabe angefordert, wenn das Lesegerät die Eingabe per Chip unterstützt. Geben Sie 1234 ein, um die Testzahlung abzuschließen. |
03 | Wenn Sie Lesegeräte mit einem Bildschirm verwenden, den die Karteninhaber/innen sehen, legen Sie die Testkarte ein (oder tippen Sie darauf, falls dies unterstützt wird). Wenn für die Karte eine PIN erforderlich ist, wird die Zahlung mit online_ abgelehnt und es wird eine PIN-Eingabe angefordert. Geben Sie eine beliebige 4-stellige PIN ein, um die Testzahlung abzuschließen. |
05 | Die Zahlung wird mit dem Code generic_ abgelehnt. |
55 | Die Zahlung wird mit dem Code incorrect_ abgelehnt. |
65 | Die Zahlung wird mit dem Code withdrawal_ abgelehnt. |
75 | Die Zahlung wird mit dem Code pin_ abgelehnt. |
Zum Beispiel ist eine Zahlung mit einer physischen Testkarte über den Betrag 25,00 USD erfolgreich; Eine Zahlung in Höhe von 10,05 USD wird abgelehnt.
Interac-Testkarten Nur Kanada
Um Ihre Interac-Integration zu testen, können Sie die simulierte interac
-Testkarte oder eine physische Interac-Testkarte verwenden. Sie können diese im Dashboard im Terminal-Hardware-Shop bestellen. Sie können den physischen Test der Marke Stripe nicht als Interac-Karte verwenden.
Die Interac-Testkarte funktioniert bei Zahlungen mit interac_
wie auch bei Rückerstattungen mit interac_
. Sie können die gleichen Testbeträge verwenden, die Sie auch beim Testen von Zahlungen mit card_
verwenden. Sofern es nicht anders angegeben ist, verwenden Sie bei entsprechender Aufforderung die PIN 1234
. Um eine abgelehnte Rückerstattung zu testen, erstellen Sie eine anteilige Rückerstattung mit einem Betrag, der mit einem der folgenden Dezimalwerte endet: 01
, 05
, 55
, 65
oder 75
.
Notiz
Die Interac-Testkarte unterstützt keine kontaktlosen Zahlungen.
eftpos-Testkarten Nur Australien
Um Ihre eftpos-Integration zu testen, können Sie die simulierte eftpos
-Testkarte oder eine physische eftops-Testkarte verwenden. Sie können diese im Dashboard im Terminal-Hardware-Shop bestellen. Sie können eine physische Testkarte unter Stripe-Marke nicht als eftpos
-Karte verwenden.
Sie können die gleichen Testbeträge verwenden, die Sie auch beim Testen von Zahlungen mit card_
verwenden. Sofern es nicht anders angegeben ist, verwenden Sie bei entsprechender Aufforderung die PIN 1234
.