Die PayTR Link API erstellt nicht nur Zahlungslinks, sondern ermöglicht es Ihnen auch, diese Links per SMS oder E-Mail an Ihre Kunden zu senden. In diesem Artikel werden die PayTR Link API SMS- und E-Mail-Versanddienste detailliert erläutert und mit Beispielcode unterstützt. Außerdem lernen Sie die korrekte Integration und häufige Fehler.
Verwandte Anleitungen:
-
Erstellung von Zahlungslinks mit der PayTR Link API: Schritt-für-Schritt-Anleitung
-
PayTR Link API Callback-Dienst: Benachrichtigung über Zahlungsergebnisse und Integrationsanleitung
-
PayTR iFrame API Integration: Schritt-für-Schritt-Informationsleitfaden
1) PayTR Link API SMS-Dienst
Sie können Ihren Kunden Zahlungslink-SMS direkt über ihre Mobiltelefonnummer senden.
Felder, die zur Token-Erstellung erforderlich sind:
-
id: Die ID, mit der Sie den Link erstellt haben
-
merchant_id: Ihre Händler-ID
-
cell_phone: 11-stellige Nummer, beginnend mit 05
-
merchant_salt & merchant_key: Aus Ihrem Händler-Panel
Token-Berechnung (PHP-Beispiel):
$paytr_token = base64_encode(hash_hmac('sha256', $id.$merchant_id.$cell_phone.$merchant_salt, $merchant_key, true));
POST-Anfrageausgabe:
$post_vals = array(
'merchant_id' => $merchant_id,
'id' => $id,
'cell_phone' => $cell_phone,
'debug_on' => 1,
'paytr_token' => $paytr_token
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://www.paytr.com/odeme/api/link/send-sms");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_vals);
$result = curl_exec($ch);
curl_close($ch);
print_r(json_decode($result, true));
Zurückgegebene Werte:
-
status: success / error / failed
-
reason: Fehlermeldung (falls vorhanden)
2) PayTR Link API E-Mail-Dienst
Anstelle von SMS können Sie Ihren Kunden den Zahlungslink auch per E-Mail senden.
Felder, die zur Token-Erstellung erforderlich sind:
-
id: Link-ID
-
merchant_id: Ihre Händler-ID
-
email: E-Mail-Adresse des Empfängers (max. 100 Zeichen)
-
merchant_salt & merchant_key
Token-Berechnung (PHP-Beispiel):
$paytr_token = base64_encode(hash_hmac('sha256', $id.$merchant_id.$email.$merchant_salt, $merchant_key, true));
POST-Anfrageausgabe:
$post_vals = array(
'merchant_id' => $merchant_id,
'id' => $id,
'email' => $email,
'debug_on' => 1,
'paytr_token' => $paytr_token
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://www.paytr.com/odeme/api/link/send-email");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_vals);
$result = curl_exec($ch);
curl_close($ch);
print_r(json_decode($result, true));
3) Häufige Fehler und Lösungen
Fehlerstatus | Ursache | Lösungen |
---|---|---|
status: error | Falsche Token-Berechnung | Überprüfen Sie die Formel zur Hash-Erstellung |
SMS wird nicht gesendet | Telefonnummer beginnt nicht mit 05 oder ist nicht 11-stellig | Achten Sie auf das Format |
E-Mail wird nicht gesendet | E-Mail-Adresse ist fehlerhaft oder Zeichenlimit überschritten | Überprüfen Sie die E-Mail-Adresse |
CURL-Timeout | Server-Firewall oder SSL-Einstellungen blockieren | Überprüfen Sie die SSL-Einstellungen |
4) Beispiele für erfolgreiche Antworten
Für SMS:
{
"status":"success"
}
Für E-Mail:
{
"status":"success"
}
5) Empfehlungen
-
Fügen Sie eine Double-Click-Kontrolle für den SMS-Versand hinzu (kein Mehrfachversand an eine Nummer).
-
Führen Sie MX-Record- und Blacklist-Prüfungen beim E-Mail-Versand durch.
-
Überprüfen Sie die eingehenden JSON-Daten immer mit den Feldern "status" und "reason".
-
Verwenden Sie "debug_on" = 1 im Testmodus, wenn Sie die Integration entwickeln.
Fazit: Steigern Sie Ihren Umsatz mit dem PayTR Link API SMS- und E-Mail-Versand
Die PayTR Link API SMS- und E-Mail-Dienste bieten Ihren Kunden eine einfache, schnelle und direkte Möglichkeit, Zahlungen zu leisten. Durch regelmäßige Nutzung können Sie Ihre Inkassoquote um bis zu 30 % steigern.
Verwandte Ressourcen:
-
Erstellung von Zahlungslinks mit der PayTR Link API: Schritt-für-Schritt-Anleitung
-
PayTR Link API Callback-Dienst: Benachrichtigung über Zahlungsergebnisse und Integrationsanleitung
-
PayTR iFrame API Integration: Schritt-für-Schritt-Informationsleitfaden