Mit der PayTR Direkt API können Sie die Kreditkarteninformationen der Benutzer während der Zahlung auf PayTR speichern und weiterhin Zahlungen entgegennehmen, ohne dass die Karteninformationen bei nachfolgenden Zahlungen erneut eingegeben werden müssen. In diesem Artikel wird der Prozess der "Neuen Kartenspeicherung" detailliert beschrieben.

Verwandter Leitfaden:

PayTR Direkt API Schritt 2: Abrufen der Zahlungsergebnisse mit der Benachrichtigungs-URL

Kartenspeicherungsprozess

Zahlungsformular: Während der Benutzer seine Zahlungsinformationen eingibt, wird ein Kontrollkästchen "Karte speichern" angezeigt.
POST-Daten:
- store_card=1 wird gesendet.
- Wenn bereits eine Karte registriert ist, werden auch die utoken-Informationen gesendet.
Nach Abschluss der Zahlung: PayTR generiert ein neues utoken oder die neue Karte wird mit dem bestehenden utoken zusammengeführt.
Benachrichtigungs-URL: Wenn die Zahlung erfolgreich ist, enthält die eingehende Benachrichtigung die utoken-Informationen. Diese sollten in Ihrem System gespeichert werden.

Daten, die für die Token-Generierung verwendet werden

merchant_id
user_ip
merchant_oid
email
payment_amount
payment_type ('card')
installment_count (0,2,3..)
currency
test_mode
non_3d

Zusätzlich sollten store_card und, falls vorhanden, utoken zum POST-Inhalt hinzugefügt werden.

POST REQUEST Parameter

Parameter	Erforderlich	Beschreibung
merchant_id	Ja	Händlernummer
paytr_token	Ja	Ausgangstoken
user_ip	Ja	IP-Adresse des Kunden
merchant_oid	Ja	Bestellnummer
email	Ja	E-Mail-Adresse des Kunden
payment_type	Ja	'card'
payment_amount	Ja	Zahlungsbetrag
installment_count	Ja	Anzahl der Raten
card_type	Nein	Kartentyp
currency	Nein	Währung
test_mode	Nein	Testmodus
non_3d	Ja	Ob 3D Secure verwendet wird
cc_owner	Ja	Karteninhaber
card_number	Ja	Kartennummer
expiry_month	Ja	Monat
expiry_year	Ja	Jahr
cvv	Ja	CVV-Code
merchant_ok_url	Ja	Erfolgreiche Zahlungsseite
merchant_fail_url	Ja	Fehlerhafte Zahlungsseite
user_name	Ja	Name des Kunden
user_address	Ja	Adresse des Kunden
user_phone	Ja	Telefonnummer des Kunden
user_basket	Ja	Warenkorb JSON
debug_on	Nein	Fehleranzeige
utoken	Nein	Wenn bereits eine Karte registriert ist
store_card	Ja	Kartenspeicherungsanfrage

Beispiel PHP Formularcode

<input type="checkbox" name="store_card" value="1"/> Karte speichern
<input type="hidden" name="utoken" value="<?php echo $utoken; ?>">

Wichtige Hinweise

Wenn Utoken nicht gesendet wird, wird ein neues Token erstellt und keine Verbindung zu alten Karten hergestellt.
Wenn der Parameter store_card nicht als 1 gesendet wird, wird keine Kartenspeicherung durchgeführt.
Dem Kunden wird erlaubt, bei nachfolgenden Zahlungen die Karte nur mit dem Utoken auszuwählen.

Ergebnis

Dank dieser Struktur können Sie die Karteninformationen der Benutzer sicher in der PayTR-Infrastruktur speichern, wodurch Sie sowohl eine PCI DSS-konforme Infrastruktur bereitstellen als auch den Zahlungsprozess beschleunigen.