Mit der PayTR Link API können Sie Links erstellen, über die Ihre Kunden direkt Zahlungen leisten können. Diese Methode erleichtert Ihnen die Online-Zahlungsabwicklung für Produkte, Dienstleistungen oder Rechnungen, auch wenn Sie keine E-Commerce-Website haben.

In diesem Artikel erklären wir Ihnen Schritt für Schritt, wie Sie mit der PayTR Link API einen Zahlungslink erstellen, und erläutern die zu verwendenden Daten anhand von Beispielcode. Außerdem verweisen wir auf andere relevante Integrationsschritte:

Schritte zur Verwendung der PayTR Link API

1. Token erstellen

Um einen Token zu erstellen, müssen Sie einen Hash-Wert aus Ihren Produkt-/Dienstleistungsinformationen berechnen.

Erforderliche Felder:

name (zwischen 4 und 200 Zeichen)
price (mit 100 multiplizierte Ganzzahl)
currency (TL, USD, EUR, GBP, RUB)
max_installment (zwischen 2 und 12)
link_type ("product" oder "collection")
lang ("tr" oder "en")
merchant_key und merchant_salt (erhalten Sie in Ihrem Händler-Panel)

Beispiel für die Token-Berechnung (PHP):

$required = $name.$price.$currency.$max_installment.$link_type.$lang;
$paytr_token = base64_encode(hash_hmac('sha256', $required.$merchant_salt, $merchant_key, true));

2. Zahlungslink erstellen (POST-Anfrage)

Mit dem Token und anderen Informationen wird eine POST-Anfrage an folgende Adresse gesendet:

https://www.paytr.com/odeme/api/link/create

POST-Parameter:

merchant_id
name
price
currency
max_installment
link_type
lang
paytr_token
(Optional: min_count, max_count, expiry_date, callback_link, callback_id, get_qr, debug_on)

PHP-Beispiel POST:

$post_vals = array(
    'merchant_id' => $merchant_id,
    'name' => $name,
    'price' => $price,
    'currency' => $currency,
    'max_installment' => $max_installment,
    'link_type' => $link_type,
    'lang' => $lang,
    'paytr_token' => $paytr_token,
    'debug_on' => 1
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://www.paytr.com/odeme/api/link/create");
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. Eingehende Antwort

Die Antwort kommt im JSON-Format:

status: success / error / failed
id: eindeutige Link-ID
link: erstellter Zahlungslink
reason: Fehlerbeschreibung (im Fehlerfall)

Beispiel für eine erfolgreiche Antwort:

{
  "status":"success",
  "id":"NB2Zlz3",
  "link":"https://www.paytr.com/link/NB2Zlz3"
}

Optionale Funktionen

get_qr: Wenn Sie 1 senden, erhalten Sie auch den QR-Code des Links im Base64-Format.
expiry_date: Sie können das Ablaufdatum des Links angeben.
callback_link: Die URL, an die das Zahlungsergebnis gemeldet wird.
max_count: Sie können ein bestimmtes Lagerbestandslimit festlegen.

Link löschen (Delete API)

Um mehrere Links gleichzeitig zu löschen, können Sie auch die PayTR Link Delete API verwenden. Dazu senden Sie die "id"-Werte, um den Löschvorgang durchzuführen.

PHP-Beispiel zum Löschen:

$hash_str = $id . $merchant_id . $merchant_salt;
$paytr_token = base64_encode(hash_hmac('sha256', $hash_str, $merchant_key, true));

$post_vals = array(
    'merchant_id' => $merchant_id,
    'id' => $id,
    'paytr_token' => $paytr_token,
    'debug_on' => 1
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://www.paytr.com/odeme/api/link/delete");
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));

Fazit: Schnelle und einfache Inkasso mit der PayTR Link API

Mit der PayTR Link API können Sie innerhalb von Minuten Verkaufs- oder Inkasso-Links erstellen. Durch systematische Nutzung und Sicherheitsvorkehrungen können Sie Ihren Kunden ein professionelles Zahlungserlebnis bieten.

Weitere Informationen und verknüpfte Integrationsanleitungen finden Sie in den folgenden Artikeln: