PayTR Link API sadece ödeme linkleri oluşturmakla kalmaz, aynı zamanda bu linkleri SMS veya Email aracılığıyla müşterilerinize ulaştırmanızı sağlar. Bu makalede PayTR Link API SMS ve Email gönderim servislerini detaylıca anlatıyor, örnek kodlarla destekliyoruz. Ayrıca doğru entegrasyon ve sık hataları da öğretiyoruz.
Bağlantılı Rehberler:
-
PayTR Link API Callback Servisi: Ödeme Sonuç Bildirimi ve Entegrasyon Rehberi
-
PayTR iFrame API Entegrasyonu: Adım Adım Bilgilendirici Rehber
1) PayTR Link API SMS Servisi
Müşterilerinize doğrudan cep telefonu numarası uzerinden ödeme linki SMS gönderebilirsiniz.
Token Oluşturma Gereken Alanlar:
-
id: Link oluşturduğunuz ID
-
merchant_id: Mağaza ID'niz
-
cell_phone: 05 ile başlayan 11 haneli numara
-
merchant_salt & merchant_key: Mağaza panelinizden
Token Hesaplama (PHP Örneği):
$paytr_token = base64_encode(hash_hmac('sha256', $id.$merchant_id.$cell_phone.$merchant_salt, $merchant_key, true));
POST İsteği Çıkışı:
$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));
Dönen Değerler:
-
status: success / error / failed
-
reason: Hata mesajı (varsa)
2) PayTR Link API Email Servisi
SMS yerine müşterilerinize ödeme linkini Email ile de gönderebilirsiniz.
Token Oluşturma Gereken Alanlar:
-
id: Link ID
-
merchant_id: Mağaza ID'niz
-
email: Alıcı email adresi (max 100 karakter)
-
merchant_salt & merchant_key
Token Hesaplama (PHP Örneği):
$paytr_token = base64_encode(hash_hmac('sha256', $id.$merchant_id.$email.$merchant_salt, $merchant_key, true));
POST İsteği Çıkışı:
$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) Sık Yapılan Hatalar ve Çözümler
Hata Durumu | Sebep | Çözümler |
---|---|---|
status: error | Yanlış token hesaplama | Hash oluşturma formülünü kontrol edin |
SMS gitmiyor | Telefon numarası 05 ile başlamıyor veya 11 hane değil | Formata dikkat edin |
Email gitmiyor | Email adresi hatalı veya karakter sınırı aşıldı | Email adresini doğrulayın |
CURL timeout | Sunucu firewall veya SSL ayarları engelliyor | SSL ayarlarını kontrol edin |
4) Örnek Başarılı Yanıtlar
SMS İçin:
{
"status":"success"
}
Email İçin:
{
"status":"success"
}
5) Tavsiyeler
-
SMS gönderimi için çift tıklı kontrol ekleyin (bir numaraya çoklu gönderim olmasın).
-
Email gönderiminde MX kaydı ve blacklist kontrolleri yapın.
-
Gelen JSON verisini her zaman "status" ve "reason" alanları ile doğrulayın.
-
Entegrasyon geliştirirken test modunda "debug_on" = 1 kullanın.
Sonuç: PayTR Link API SMS ve Email Gönderimi ile Satışlarınızı Artırın
PayTR Link API SMS ve Email servisleri, müşterilerinize kolay, hızlı ve doğrudan ödeme yapma imkânı sunar. Düzenli kullanım ile tahsilatlarınızı %30'a kadar artırabilirsiniz.
Bağlantılı Kaynaklar:
-
PayTR Link API Callback Servisi: Ödeme Sonuç Bildirimi ve Entegrasyon Rehberi
-
PayTR iFrame API Entegrasyonu: Adım Adım Bilgilendirici Rehber