Test Stripe Terminal
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.
Am besten lässt sich eine erfolgreiche Terminal-Bereitstellung erreichen, wenn Sie alle Phasen Ihrer Integration testen. Wir stellen Test-Tools für jede Phase bereit:
- 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.
Beachten Sie, dass das simulierte Lesegerät keine Nutzeroberfläche bietet. Nachdem Sie sich in Ihrer App damit verbunden haben, können Sie sehen, dass sie 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 Kartenpräsentation 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_debit | Visa (Debit) | |
mastercard | Mastercard | |
mastercard_debit | Mastercard (Debit) | |
mastercard_prepaid | Mastercard (Prepaid) | |
amex | American Express | |
amex2 | American Express | |
discover | Discover | |
discover2 | Discover | |
diners | Diners Club | |
diners_14digits | Diners Club (14-stellige Kartennummer) | |
jcb | JCB | |
unionpay | UnionPay | |
interac | Interac | |
eftpos_au_debit | eftpos Australia | |
eftpos_au_visa_debit | EFTPOS Australien/Visa | |
eftpos_au_mastercard_debit | EFTPOS Australien/Mastercard |
Testkarten für bestimmte Erfolgsfälle
Testkartennummer | Testzahlungsmethode | Ergebnis |
---|---|---|
offline_pin_cvm | Simuliert eine Aufforderung an den/die Karteninhaber/in, eine Offline-PIN einzugeben. Für die resultierende Abbuchung ist cardholder_verification_method auf offline_pin gesetzt. | |
offline_pin_sca_retry | Simuliert einen durch SCA ausgelösten Wiederholungsvorgang, bei dem die anfängliche kontaktlose Zahlung eine/einer Karteninhaber/in fehlschlägt und das Lesegerät de/die Nutzer/in dann auffordert, die Karte einzuführen und seine/ihre Offline-PIN einzugeben. Für die resultierende Abbuchung ist cardholder_verification_method auf offline_pin gesetzt. | |
online_pin_cvm | Simuliert eine Aufforderung an eine/n Karteninhaber/in, eine Online-PIN einzugeben. Für die resultierende Abbuchung ist cardholder_verification_method auf online_pin gesetzt. | |
online_pin_sca_retry | Simuliert einen durch SCA ausgelösten Wiederholungsvorgang, bei dem die anfängliche kontaktlose Zahlung eine/einer Karteninhaber/in fehlschlägt und das Lesegerät den/die Nutzer/in dann auffordert, seine/ihre Online-PIN einzugeben. Für die endgültige Abbuchung ist cardholder_verification_method auf online_pin gesetzt. |
Testkarten für bestimmte Fehlerfälle
Testkartennummer | Testzahlungsmethode | Ergebnis |
---|---|---|
charge_declined | Die Abbuchung wird mit dem Code card_declined abgelehnt. | |
charge_declined_insufficient_funds | Die Abbuchung wird mit dem Code card_declined abgelehnt. Das decline_code-Attribut ist insufficient_funds . | |
charge_declined_lost_card | Die Abbuchung wird mit dem Code card_declined abgelehnt. Das decline_code-Attribut ist lost_card . | |
charge_declined_stolen_card | Die Abbuchung wird mit dem Code card_declined abgelehnt. Das decline_code-Attribut ist stolen_card . | |
charge_declined_expired_card | Die Abbuchung wird mit dem Code expired_card abgelehnt. | |
charge_declined_processing_error | Die Abbuchung wird mit dem Code processing_error abgelehnt. | |
refund_fail | Die Abbuchung ist erfolgreich, aber die Rückerstattung einer erfassten Zahlung schlägt asynchron mit dem failure_reason expired_or_canceled_card fehl. Beachten Sie Folgendes: Da die 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 charge.refund.updated . Dieser simulierte Fehler wird nur im JavaScript-SDK unterstützt. |
Notiz
Die Verwendung dieser Karten für das direkte Speichern ohne Belastung und SetupIntents ergibt eine setup_intent_authentication_failure Antwort.
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. Sie funktioniert nur mit vorzertifizierten Lesegeräten von Stripe und auch nur mit der Stripe API im Test-Modus. Wenn Sie Ihre physische Testkarte im Live-Modus 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_issuer abgelehnt. |
02 | Wenn Sie Lesegeräte mit einem der/dem Karteninhaber/in zugewandten Bildschirm verwenden, legen Sie die Testkarte ein (wenn Sie außerhalb der USA sind, können Sie auch per Auflegen bezahlen) und folgen den Aufforderungen auf dem Bildschirm, um die Transaktion abzuschließen. Wenn eine PIN erforderlich ist, geben Sie 1234 ein. Die Zahlung kann mit dem Code offline_pin_required abgelehnt werden, wenn für die Karte eine PIN erforderlich ist und das Lesegerät keinen Bildschirm für den/die Karteninhaber/in hat. |
03 | Wenn Sie Lesegeräte mit einem der/dem Karteninhaber/in zugewandten Bildschirm verwenden, legen Sie die Testkarte ein (wenn Sie außerhalb der USA sind, können Sie auch per Auflegen bezahlen) und folgen den Aufforderungen auf dem Bildschirm, um die Transaktion abzuschließen. Wenn eine PIN erforderlich ist, geben Sie eine beliebige 4-stellige PIN ein. Die Zahlung kann mit dem Code online_or_offline_pin_required abgelehnt werden, wenn für die Karte eine PIN erforderlich ist und das Lesegerät keinen Bildschirm für die/den Karteninhaber/in hat. |
05 | Die Zahlung wird mit dem Code generic_decline abgelehnt. |
55 | Die Zahlung wird mit dem Code incorrect_pin abgelehnt. |
60 | Zahlung wird mit dem Code online_or_offline_pin_required abgelehnt. |
65 | Die Zahlung wird mit dem Code withdrawal_count_limit_exceeded abgelehnt. |
75 | Die Zahlung wird mit dem Code pin_try_exceeded abgelehnt. |
Beispielsweise wird eine Zahlung mit einer physischen Testkarte über den Betrag in Höhe von 25,00 $ erfolgreich abgewickelt, während eine Zahlung in Höhe von 10,05 $ abgelehnt wird.
Interac-Testkarten Nur Kanada
Um Ihre Interac-Integration zu testen, können Sie die simulierte interac
-Testkarte oder eine physische Interac-Testkarte verwenden. Diese kann im Terminal-Hardware-Shop im Dashboard bestellt werden. Die physische Testkarten unter Stripe-Marke kann nicht als Interac-Karte verwendet werden.
Die Interac-Testkarte funktioniert bei Zahlungen mit interac_present
wie auch bei Rückerstattungen mit interac_present
. Sie können die gleichen Testbeträge verwenden, die Sie auch beim Testen von Zahlungen mit card_present
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 eftpos-Testkarte verwenden. Diese können Sie im Terminal-Hardware-Shop im Dashboard bestellen. Die physischen Testkarten unter Stripe-Marke können nicht als eftpos
-Karten verwendet werden.
Sie können die gleichen Testbeträge verwenden, die Sie auch beim Testen von Zahlungen mit card_present
verwenden. Sofern es nicht anders angegeben ist, verwenden Sie bei entsprechender Aufforderung die PIN 1234
.
Simulierte Kartenpräsentation
Nutzen Sie bei Verwenden der Server-gesteuerten Integration den Endpoint present_payment_method, um zu simulieren, dass ein/e Karteninhaber/in seine/ihre Karte am Lesegerät anlegt oder in das Lesegerät einführt.
{ "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_present | visa | |
card_present und interac_present | visa | |
interac_present | 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.