1. PayTR Hesabı Oluşturma

PayTR entegrasyonuna başlamadan önce, bir PayTR hesabınızın olması gerekiyor. Hesabınızı oluşturduktan sonra, PayTR size entegrasyon için gerekli olan API bilgilerini sağlayacaktır.

1. Kayıt Olma: PayTR web sitesine gidin ve hesap oluşturma sürecini tamamlayın.
2. API Anahtarları ve Gizli Anahtar: Hesabınıza giriş yaptıktan sonra, API anahtarlarınızı ve gizli anahtarınızı alabileceğiniz bir bölüm olacak. Bu anahtarlar, entegrasyon sırasında kullanılacaktır.

2. PayTR API’larının Tanınması

PayTR, çeşitli ödeme yöntemlerini destekleyen API’lar sunar. Aşağıdaki temel API’lar entegrasyon sırasında kullanılabilir:

1. Ödeme API’si: Bu API, müşteri tarafından yapılan ödemelerin alınmasını sağlar.
2. İade API’si: İade işlemlerini yönetmek için kullanılır.
3. 3D Secure API’si: 3D Secure destekli ödemeler için kullanılır.

3. Yazılım Tarafında Hazırlık

Entegrasyon yapılacak yazılımın hangi dilde yazıldığına göre gerekli modüllerin yüklenmesi ve yapılandırılması gerekir. Aşağıda PHP dilinde entegrasyon adımlarını anlatacağım. Ancak diğer diller için de benzer adımlar izlenir.

3.1. PHP ile PayTR Entegrasyonu

1. Gerekli Kütüphaneleri Kurma: İlk olarak, cURL ve OpenSSL gibi kütüphanelerin kurulu olduğundan emin olun. PayTR API’ları genellikle bu kütüphanelerle çalışır.
2. API Çağrısı Yapma: Aşağıda örnek bir PHP kodu ile nasıl API çağrısı yapılacağı gösterilmiştir.

 

$merchant_id = ‘Mağaza Numarası’; // PayTR tarafından sağlanır

$merchant_key = ‘API Anahtarı’; // PayTR tarafından sağlanır

$merchant_salt = ‘Gizli Anahtar’; // PayTR tarafından sağlanır

 

$email = ‘[email protected]’;

$payment_amount = 10000; // Ödeme tutarı, kuruş cinsinden

$merchant_oid = uniqid(); // Eşsiz bir sipariş numarası

 

$hash_str = $merchant_id.$email.$payment_amount.$merchant_oid.$merchant_salt;

$paytr_token = base64_encode(hash_hmac(‘sha256’, $hash_str, $merchant_key, true));

 

// Post verisi hazırlanır

$post_vals = [

‘merchant_id’ => $merchant_id,

’email’ => $email,

‘payment_amount’ => $payment_amount,

‘merchant_oid’ => $merchant_oid,

‘paytr_token’ => $paytr_token

];

 

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, “https://www.paytr.com/odeme/api”);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

curl_setopt($ch, CURLOPT_POST, 1);

curl_setopt($ch, CURLOPT_POSTFIELDS, $post_vals);

 

$response = curl_exec($ch);

 

if (curl_errno($ch)) {

die(“cURL error: “.curl_error($ch));

}

 

curl_close($ch);

 

$response_data = json_decode($response, true);

 

if ($response_data[‘status’] == ‘success’) {

echo “Ödeme başarılı!”;

} else {

echo “Ödeme başarısız: ” . $response_data[‘reason’];

}

3.2. 3D Secure Kullanımı

Eğer 3D Secure kullanıyorsanız, PayTR’ın sunduğu iframe entegrasyonunu da yapılandırmanız gerekebilir. Bu, kullanıcıyı doğrulama süreci sırasında yönlendirmek için kullanılır.

4. Test ve Doğrulama

PayTR, entegrasyonun doğru çalıştığından emin olmak için test işlemleri yapılmasını önerir. PayTR hesabınızla birlikte gelen test kartları ve API bilgilerini kullanarak bu işlemleri yapabilirsiniz.

1. Test Modu: PayTR’da, canlı ortamda olduğu gibi test işlemleri yapabileceğiniz bir test modu vardır. Bu modda, sahte kart numaraları ve verilerle işlemler yapabilir ve entegrasyonunuzu test edebilirsiniz.
2. Canlı Ortama Geçiş: Testleri başarıyla tamamladıktan sonra, API anahtarlarınızı canlı anahtarlarla değiştirip canlı ortama geçebilirsiniz.

5. Hata Yönetimi ve Destek

Entegrasyon sırasında veya sonrasında oluşabilecek hatalar için PayTR dokümantasyonuna başvurabilir veya destek ekibiyle iletişime geçebilirsiniz. Aşağıda bazı yaygın hatalar ve çözümleri listelenmiştir:

1. API Anahtar Hatası: Yanlış API anahtarları veya gizli anahtarlar kullanılıyorsa, doğrulama hataları alabilirsiniz.
2. Güvenlik Hataları: IP adresiniz PayTR tarafından izin verilen IP adresleri listesinde değilse, işlem reddedilebilir.
3. Ödeme Tutarı Hatası: Ödeme tutarının doğru formatta ve doğru birimle (kuruş cinsinden) gönderildiğinden emin olun.

Sonuç

PayTR entegrasyonu, doğru bir şekilde yapılandırıldığında ödeme süreçlerinizi hızlı ve güvenli bir şekilde yönetmenizi sağlar. Yukarıdaki adımları takip ederek, yazılımınıza PayTR ödeme sistemini başarıyla entegre edebilir ve müşterilerinize farklı ödeme seçenekleri sunabilirsiniz.

Herhangi bir sorun yaşarsanız, PayTR’ın teknik destek ekibiyle iletişime geçmekten çekinmeyin.

Bu makale, PHP kullanarak PayTR entegrasyonunu anlatmaktadır. Farklı bir programlama dili veya platform kullanıyorsanız, PayTR’ın resmi dokümantasyonunu inceleyerek benzer adımları uygulayabilirsiniz. Ayrıca aşağıdaki link üzerinden PayTR ‘ ye kayıt olursanız partnerliğimiz sayesinde indirimli komisyon oranları alırsınız.
BAŞVURU LİNKİ