Um die Nutzung der PayTR Link API abzuschließen und die Zahlungsabwicklung sicherzustellen, ist die Integration des Callback-Dienstes von entscheidender Bedeutung. In diesem Artikel erklären wir Schritt für Schritt, wie Sie eine erfolgreiche Zahlungsbenachrichtigung für PayTR-Zahlungslinks erhalten, die Hash-Validierung durchführen und korrekte Integrationsvorschläge umsetzen.

Wir empfehlen Ihnen außerdem, sich diese Anleitungen für andere PayTR API-Schritte anzusehen:

Was ist der PayTR Link API Callback?

Wird nur bei erfolgreicher Zahlung ausgeführt.
Wird an die callback_url-Adresse gesendet, die Sie in der Create-Anfrage angegeben haben.
Ist separat von der Benachrichtigungs-URL im Händler-Panel und funktioniert nur für die Link-API.

Information: Wenn Sie beim Erstellen des Links keine callback_url angegeben haben, ist diese Integration nicht erforderlich.

POST-Parameter, die mit dem Callback gesendet werden

Parameter	Beschreibung
hash	Wird verwendet, um die Richtigkeit der Werte der Benachrichtigung zu überprüfen
merchant_oid	Bestellnummer (wird von PayTR generiert)
status	success (wird immer für erfolgreiche Zahlungen gesendet)
total_amount	Tatsächlich abgebuchter Betrag (in Cent)
payment_amount	Bestellbetrag
payment_type	Zahlungsart (card, bex usw.)
currency	Währung (TL, USD, EUR, GBP, RUB)
callback_id	ID, die Sie beim Erstellen des Links angegeben haben
merchant_id	Ihre Händlernummer
test_mode	Gibt an, ob die Zahlung im Testmodus durchgeführt wurde

Schritte zur Callback-URL-Integration

1. POST-Daten abrufen

$post = $_POST;

2. Hash-Validierung durchführen

$merchant_key = 'Ihr_Merchant_Key';
$merchant_salt = 'Ihr_Merchant_Salt';

$hash = base64_encode( hash_hmac('sha256', $post['callback_id'].$post['merchant_oid'].$merchant_salt.$post['status'].$post['total_amount'], $merchant_key, true) );

if( $hash != $post['hash'] ) {
    die('PAYTR notification failed: bad hash');
}

3. Zahlungsbestätigung durchführen

if( $post['status'] == 'success' ) {
    // Bestätigen Sie die Zahlung in Ihrer Datenbank
    // Sie können dem Kunden eine SMS/E-Mail-Benachrichtigung senden
}

4. Senden Sie unbedingt die Antwort OK zurück

echo "OK";
exit;

WICHTIG: Wenn die Antwort "OK" nicht gesendet wird, betrachtet das PayTR-System die Benachrichtigung als fehlgeschlagen und kann sie wiederholt senden.

Häufige Fehler im Callback-Dienst

Eine andere Ausgabe als OK zurückgeben.
Die POST-Hash-Validierung nicht durchführen.
Versuchen, Session-Variablen zu verwenden.
Dieselbe Bestellung bei mehreren Benachrichtigungen wiederholt bearbeiten.

Testphasen

Erstellen Sie einen Zahlungslink (callback_url definiert).
Führen Sie eine Testzahlung durch.
Wenn eine Benachrichtigung an Ihre Callback-URL gesendet wird und die Antwort "OK" korrekt zurückgegeben wird, wird die Transaktion im PayTR Händler-Panel als "Erfolgreich" angezeigt.

Wichtiger Hinweis:

Wenn Sie SSL verwenden, speichern Sie die callback_url mit dem HTTPS-Protokoll.

Fazit: Reibungslose Zahlungsbestätigung mit dem PayTR Link API Callback Service

Damit die Zahlungen über die Link-API professionell in Ihr System integriert werden können, muss der Callback-URL-Dienst unbedingt korrekt implementiert werden. Mit Hash-Validierung, OK-Antwort und idempotenter Struktur (wiederholte Vorgänge nur einmal zählen) kann der gesamte Prozess problemlos durchgeführt werden.

Verlinkte informative Artikel: