PayPal API Nedir?
PayPal API, sunucu ile istemci programı arasında aracılık yapan bir arayüzdür. Bizim durumumuzda üçüncü taraf geliştiricilere API sağlayan sunucu programı PayPal’dır. İstemci ise geliştiricilerin PayPal API’sine dayanarak bir web sitesinde ödeme yapmak, satışları iade etmek, işlem ayrıntılarını görüntülemek, bir faturalandırma planı kurmak, kredi kartı geçmişini güvenli şekilde saklamak vb. için oluşturdukları bir programdır. PayPal REST API’dir; web ve mobil uygulamalara kolayca entegre edilmesi için HTTP yöntemlerini kullanır.
PayPal API Anahtarını, Kimlik Bilgilerini ve İmzasını Nasıl Alırsınız
Unutmayın: PayPal API ile çalışabilmek için sadece PayPal Premier, Business veya Website Payments Pro hesabına sahip olmanız gerekir. Öncelikle bu eğitimde bir işletme hesabı oluşturmanız gerekecek.
PayPal İşletme Hesabı Oluşturun
Adım 1. PayPal’a kaydolun.
Adım 2. Öncelikle kendinizle ilgili bazı bilgiler vermeniz gerekecek: adınız, soyadınız, iş e-posta adresiniz ve şifreniz.
Adım 3. Ardından işletmenizle ilgili şu bilgileri girin: yasal adı, telefon numarası ve adresi.
PayPal’in dünya genelinde bazı bölgelerde ve ülkelerde kullanılabildiğine özel dikkat edin.
Bunlar: Alberta, British Columbia, Manitoba, New Brunswick, Newfoundland and Labrador, Northwest Territories, Nova Scotia, Nunavut, Ontario, Prince Edward Island, Quebec, Saskatchewan, Yukon.
İşletmeniz bu bölgelerden hiç birine ait değilse, Uluslararası Geliştiriciler için PayPal SSS’yi okumanız gerekir. Kısacası, ABD veya İngiltere dışı bir geliştiriciyseniz, onların NVP/SOAP API’lerini kullanabilirsiniz.
Aşama 4. Ayrıca aşağıdaki seçeneklerden işletme türünüzü seçmelisiniz: Bireysel, Tek Şahıs Şirketi, Ortaklık, Anonim Şirketi, Özel Şirket, Halka açık Şirket, Kâr amacı gütmeyen kuruluş, Devlet Kurumu.
Sonra işinizi daha ayrıntılı olarak tanımlayın ve birkaç soruyu yanıtlayın:
Gönder’e tıklayın. Ardından kendiniz hakkında bilgi verin.
Aşama 5. Bundan sonra PayPal hesabınızın amacını belirlemeniz gerekir. Bunu para talep etmek veya göndermek, müşterilere fatura göndermek veya web sitesinde PayPal ödeme seçeneğini sunmak için kullanabilirsiniz. Çevrimiçi Ödemeleri Ayarla olarak seçin. Şimdi PayPal anahtarını almak için yolun yarısındasınız.
PayPal API Kimlik Bilgileri Edinin
Adım 1. Bir işletme hesabı oluşturduğunuzda, PayPal Geliştirici sayfası’na gidin ve kontrol paneline giriş yapın.
Step 2. Oturum açtıktan sonra kişisel PayPal API anahtarını alabileceksiniz. Bunun için “My Apps & Credentials” bölümüne gidin ve “Create App” düğmesine tıklayın.
Adım 3. Bir uygulama adı girin ve yeniden “Oluştur”a tıklayın. Bir istemci kimliği, bir Sandbox hesabı adı ve bir “Gizli Anahtar” alacaksınız.
PayPal API İmzası veya Sertifikası Edinin
Bir sonraki adım, PayPal API İmza kimlik bilgileri veya API Sertifikası kimlik bilgileri oluşturmaktır. Hangi türü seçeceğinize karar veremiyorsanız, aralarındaki farkı şu şekilde açıklıyoruz:
- PayPal API İmzası API Kullanıcı Adı, API Şifresi ve İmza içerir ve süresi dolmaz.
- API Certificate credentials include an API Username in PayPal, API Password, and Certificate, which expires automatically after three years.
PayPal’de API kimlik bilgilerini elde etmek için doğrulanmış bir e-posta adresine sahip olmanız gerektiğini unutmayın.
PayPal hesabınız için API İmzası veya Sertifika bilgilerinin nasıl alınacağını aşağıda bulabilirsiniz.
- PayPal Sandbox hesabınıza giriş yapın, iş profili verilerinizi kullanın.
- “Ayarlar” simgesine tıklayın.
- Sayfanın solunda bulunan ‘Hesap ve Güvenlik’ altında Hesap erişimine tıklayın.
- API erişimi bölümünde “Güncelle” düğmesine tıklayın.
- “NVP/SOAP API entegrasyonu” altında “API kimlik bilgilerini yönet”e tıklayın.
- Aşağıdaki seçeneklerden birini seçin. API İmza Talebi – API İmza kimlik doğrulaması için seçin. API Sertifikası Talebi – API Sertifikası kimlik doğrulaması için seçin.
- Kabul et ve Gönder’e tıkla.
- İşte bu kadar! Bundan sonra PayPal API kimlik bilgilerinizi üretecektir.
PayPal API Örnekleri
PayPal birkaç REST API sunar ve bunları üç kategoriye ayırır:
- Canlı Sürüm – kısa süre önce yayımlandı, tamamen destekleniyor ve yeni abonelere sunuluyor.
- Sınırlı sürüm – tam destekli API, belirli pazarlarda mevcut.
- Kullanımdan Kaldırıldı – arşivlenmiş fakat tamamen desteklenen API’ler.
Aşağıda en popüler örnekleri bulabilirsiniz.
Ödemeler API’si
Bu tür API, birden çok PayPal alıcısına para göndermek için kullanılır. Ödüller, iadeler ve komisyonlar göndermek isteyenler için idealdir. Alıcılar e-posta adreslerini, mobil numaralarını veya Payer ID’lerini bildirmek zorunda kalacaklardır.
Ödeme REST API
En yaygın ve işlevsel API türüdür. Web siteleri ve uygulamalarda güvenli ve sorunsuz çevrimiçi ödemelerin alınmasını sağlar. Ödemeleri hemen kabul etmek veya ertelemek, tamamlanan işlemlerin ayrıntılarını göstermek ve tam veya kısmi iadeler yapmak için kullanılır.
PayPal Express Checkout API
Akıllı PayPal ödeme düğmeleri, kullanıcılara en uygun, sade ve güvenli ödeme deneyimleri sunar. PayPal düğmelerini kolayca özelleştirebilir ve Venmo veya kredi kartı gibi alternatif ödeme yöntemleri ekleme imkanınız da vardır. Bunu web sitenize veya uygulamanıza eklediğinizde şu şekilde çalışır: önce bir ödeme açılır pencere görünür ve kullanıcıya PayPal’a giriş yapması teklif edilir. Ardından, alışverişçi ödemeyi onayladıktan sonra PayPal Orders API işlemi tamamlar.
Abonelikler API
Fiziksel ürünler ve hizmetler için tekrarlayan PayPal ödemelerini başlatmanıza olanak tanır; dijital ürünler için de geçerlidir. Ayrıca ödenmesi gereken sabit bir tutar belirleme ve kademeli bir plan oluşturma imkanı sunar.
PayPal İtirazlar API’si
Bir sorun PayPal tarafında oluşursa, bir itiraz açmanızı ve destek ekibiyle iletişim kurmanızı önerirler.
PayPal Tekrarlayan Ödemeler API
Bu API örneği kullanımdan kaldırılmıştır, ancak PayPal ekibi bunu hâlâ kullanan tüccarlara tamamen destek vermektedir. Tekrarlanan ödemeler API’si Abonelikler API’sinin bir benzeridir, ancak daha az işlevsellik sunar.
Fatura API
Bu API örneği kullanımdan kaldırıldı; ancak PayPal ekibi hâlâ bu API’yi kullanan tüccarları destekliyor. Yinelenen ödemeler API’si Abonelikler API’sinin bir analoğudur, ancak daha az işlevsellik sunar. Fatura ödemelerini izlemek için olaylar hakkında bildirim mesajları alan HTTP geri çağırmaları olan webhook’ları kullanabilirsiniz.
PayPal, geliştiricilerin ürünleri yayınlamadan önce test edip entegre etmelerini sağlayan bir API Çalıştırıcısı sunar. Seçtiğiniz herhangi bir ürünün çalışmasını kontrol etmek için bunu kullanın.
Web sitesi üzerinde PayPal Entegrasyonu
Bir web sitesi üzerinde PayPal düğmesi elde etmek için Mühendislik ve İş Akışlarını aynı anda başlatmanız gerekir.
İlk olarak, bu makalede daha önce anlatıldığı gibi kendi API çözümünüzü geliştin. İkincisi, ürünü test etmek için (geliştirici olarak) bir sandbox kurun ve Canlı hesap için başvurun. Canlı hesap, PayPal’in tüm işlevlerini entegre eder. Oluşturduğunuz çözümü entegre edin ve test edin. Her şey yolunda olduğunda, Canlı hesap almak için sözleşme imzalayın. Canlıya geçiş için her şeyi hazırlayın, iyice kontrol edin ve sonunda PayPal API tabanlı çözümünüzü hayata geçirin.
Bu adımların tümünü geçmek için çok zaman harcamak istemiyorsanız, özelleştirilebilir, güzel ve kolay entegre edilen PayPal düğmesi Elfsight tarafından sunulur. Sadece PayPal’da bir işletme hesabı oluşturun ve bir web sitesine düğmeyi gömeye hazır olun.
En popüler API örneklerinden biri, NVP ve SOAP Entegrasyon yöntemiyle çalışan PayPal Express Checkout’tir. Kullanımdan kaldırılmıştır; PayPal hâlâ desteklese de, daha yeni Checkout API yeni ve gelişmiş özellikler sunar.
PayPal API Sınırları ve Fiyatlandırması
Bir PayPal hesabından para alırsanız, para birimine bağlı olarak değişen belirli bir yüzde ile sabit bir ücreti ödemeniz gerekir. PayPal kullandığınızda, 2020 yılında aylık veya fesih ücreti ödemeniz gerekmez. Aşağıda, PayPal kullanmanın birkaç ülkede ne kadara mal olacağını göreceksiniz:
| Eğer aldığınız para PayPal hesabından geliyorsa: | Ödeme yapmalısınız |
| Kanada | İşlem tutarının %2,9’u artı 0,30 CAD ücreti |
| ABD | İşlem tutarının %3,7’si artı 0,30 USD ücreti |
| Avrupa | İşlem tutarının %3.9’una ek olarak 0,35 EUR ücret. |
| Rusya | İşlem tutarının %3,9’u artı 10 RUB ücreti |
| Brezilya | İşlem tutarının %3,9’u artı 0,60 BRL ücreti |
| Meksika | İşlem tutarının %3,9’u artı 4,00 MXN ücreti |
| Singapur | İşlem tutarının %3,9’u artı 0,50 SGD sabit ücret |
Ülkelerin ve ücretlerin tam listesini PayPal Payments Standard sayfasında kontrol edin.
PayPal API’ye günlük kaç çağrı yapabileceğiniz konusunda bahsederken, istediğiniz kadar çağrı yapmanız mümkün. Ancak API’yi çok sık çağırmaktan kaçınmanızı öneririz.
PayPal Dokümantasyonu
PayPal API belgeleri dünya çapında ödeme süreçlerini anlattığı için son derece büyüktür. Onlarla çalışmak için hesap türü seçmelisiniz: Geliştirici, Kişisel veya İş. İkincisi, projede kullanmak istediğiniz API türünü seçin (bunları daha önce listeledik). Ardından, ihtiyaç duyduğunuz API türünü içeren bir sayfa bulun, PayPal’ın sunduğu yöntemleri ve nesneleri inceleyin ve son olarak, geliştirici Sandbox’ında elde ettiğinizi test edin.
PayPal API Değişiklikleri
PayPal, bazı API türlerini kullanımdan kaldırdı, ancak hâlâ destekliyor. PayPal API’deki pek çok değişiklikle aşinalık kazanmak, bir web sitesine entegrasyon sürecini incelemek açısından faydalı olabilir.
2018 değişiklikleri: Yatay düğme yerleşimi varsayılan olarak kullanılmaya başlandı; Payouts API Entegrasyonu’ndaki kod örnekleri güncellendi; Küçük Smart Payment Button için önerilen ve varsayılan gösterimler kaldırıldı.
2019 değişikliği: Para birimi dönüşüm özelliklerine kod örnekleri eklendi, ayrıca ülke hariç tutma listesi de eklendi.
2020 değişikliği: Yinelenen ödemelerin işlenmesi güncellendi. Artık kullanıcılar aynı anda en fazla 10 ödeme yapmak yerine yinelenen ödemeler oluşturmaları gerekiyor.
SSS (Sık Sorulan Sorular)
Geliştirici olarak kaydolmalı mıyım, geliştirici sitesine giriş yapmadan sandbox’a erişebiliyor muyum?
Gerekli değildir. Ancak, önceden yapılandırılmış bir test hesabı oluşturma, REST API kimlik bilgilerine ve işlem panosuna erişim gibi bazı gerçekten kullanışlı özelliklere sahip olmak isterseniz, bunu yapmalısınız.
Şu anda REST API kullanıyor olsam, işlemlerimin geçmişini NVP/SOAP API’leri ile geri yüklemek mümkün müdür?
Maalesef hayır, ancak bu özel durum için PayPal geliştiricileri TransactionSearch API’sini tanıttı.
Değerler isteğe bağlıysa boş bırakmalı mıyım?
İşleyici boş değerlerle bırakılmamalı; isteğe bağlı alanları doldurmak istemiyorsanız, onları eklemeyin.
Tüm PayPal NVP/SOAP API’leri REST’e Güncellenecek mi?
PayPal şu anda hizmetlerini iyileştiriyor ve eski kuşağa ait NVP API’leri yakında güncellenecek.
Sonuç
PayPal belgelerinin tamamını okumak saatler alabilir; çünkü web sitesi veya uygulama üzerinden ödemeleri almak ve satmak için süreci düzenlemeniz gerekir. Ayrıca PayPal şu anda eski NVP/SOAP API’lerinden REST API’ye geçiş yapıyor; bu da önceki belgelere göre iki kat daha çok dokümantasyon anlamına geliyor.
Bugün, kodlama yapmadan ve sayısız dokümantasyon sayfası okumadan web sitenize kolayca özelleştirilebilir Elfsight PayPal düğmesi eklemek mümkün. İşletme hesabınızı PayPal sitesi üzerinden kaydedin – süreç kılavuzumuzda yer alıyor – ve şaşırtıcı işlevsellikte bir widget oluşturun. Hemen deneyin!
