Neden PHP ile SanalPos.com?
Web dünyasının en yaygın diliyle güvenli ödeme entegrasyonu.
PHP, internet sitelerinin büyük çoğunluğunu çalıştıran, web geliştirme alanında en yaygın kullanılan programlama dillerinden biridir. WordPress, Laravel, Symfony, Magento, WooCommerce ve daha birçok platform PHP üzerine inşa edilmiştir. Bu yaygınlık, PHP geliştiricilerinin ödeme entegrasyonu konusunda güçlü bir ekosisteme sahip olduğu anlamına gelir. SanalPos.com, PHP geliştiricilerine REST API tabanlı kapsamlı bir ödeme altyapısı sunar.
Laravel ve Symfony gibi modern PHP framework'leri ile sorunsuz çalışan SanalPos.com API entegrasyonu, Composer paket yöneticisi üzerinden kolayca kurulabilir. MVC mimarisiyle uyumlu, PSR standartlarına uygun yapısıyla mevcut projelerinize hızla entegre olur. Ayrıca saf PHP projelerinde de cURL veya herhangi bir HTTP istemcisi ile doğrudan REST API çağrıları yaparak entegrasyon gerçekleştirebilirsiniz. Framework bağımsız tasarımı sayesinde CodeIgniter, Yii, Slim veya kendi çatınızla geliştirdiğiniz özel projelerde de rahatlıkla kullanabilirsiniz.
PHP 7.4 ve üzeri tüm versiyonlar desteklenir — 8.0, 8.1, 8.2 ve 8.3 dahil.
1. SanalPos.com Hesabı Oluşturun
Ücretsiz başvuru yaparak API anahtarlarınızı edinin ve sandbox ortamına erişim sağlayın.
2. PHP SDK'yı Kurun
Composer ile SanalPos.com PHP SDK'sını projenize ekleyin: composer require sanalpos/php-sdk
3. Ödeme Akışını Kodlayın
SDK metotlarını kullanarak ödeme başlatma, 3D Secure yönlendirme ve callback işlemlerini kodlayın.
4. Sandbox'ta Test Edin ve Canlıya Alın
Sandbox ortamında tüm senaryoları test edin, ardından API anahtarlarını canlı değerlerle değiştirerek production'a geçin.
Kurulum Adımları
Dört adımda PHP projenize ödeme entegrasyonu ekleyin.
Öncelikle SanalPos.com hesabı oluşturarak sandbox API anahtarlarınızı edinin. Ardından Composer ile SDK'yı projenize kurun veya doğrudan REST API çağrıları yapın. Ödeme başlatma, 3D Secure yönlendirme ve callback işlemlerini kodladıktan sonra sandbox ortamında tüm senaryoları test edin. Her şey hazır olduğunda canlı API anahtarlarına geçerek production ortamında ödeme almaya başlayın.
SDK kullanmak zorunlu değil — cURL ile doğrudan REST API çağrıları da yapabilirsiniz.
PHP Kod Örneği
REST API ile ödeme başlatma örneği.
Aşağıdaki örnek, SanalPos.com REST API'sine PHP cURL ile ödeme başlatma isteği göndermeyi göstermektedir. Bu temel yapıyı kullanarak kendi ödeme akışınızı oluşturabilirsiniz. API anahtarınızı header'a ekleyerek kimlik doğrulaması yapılır ve JSON formatında ödeme bilgileri gönderilir. Yanıt olarak işlem sonucu ve 3D Secure yönlendirme URL'si döner.
Bu örnek, SDK kullanmadan doğrudan API çağrısı yapmayı gösterir. Daha gelişmiş kullanım ve hazır metotlar için PHP SDK dokümantasyonunu inceleyebilirsiniz.
// SanalPos.com REST API ile ödeme başlatma örneği
$apiKey = 'YOUR_API_KEY';
$apiUrl = 'https://api.sanalpos.com/v1/payments';
$payload = [
'amount' => 150.00,
'currency' => 'TRY',
'locale' => 'tr',
'installment' => 1,
'callbackUrl' => 'https://siteniz.com/odeme/callback',
];
$ch = curl_init($apiUrl);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode($payload),
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Authorization: Bearer ' . $apiKey,
],
]);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
// 3D Secure yönlendirmesi gerekiyorsa
if ($result['status'] === 'redirect') {
header('Location: ' . $result['redirectUrl']);
exit;
}PHP Entegrasyon Özellikleri
PHP projeleriniz için sunulan ödeme altyapısı özellikleri.
Composer Paketi
Kolay kurulum ve güncelleme
REST API
Tam kapsamlı API dokümantasyonu
3D Secure
Güvenli ödeme doğrulaması
Sandbox Ortamı
Güvenli test ortamı
Webhook Desteği
Otomatik callback bildirimleri
Detaylı Dokümantasyon
Adım adım entegrasyon rehberi
Teknik Gereksinimler
PHP sanal POS entegrasyonu için gerekli altyapı koşulları.
PHP 7.4 veya üzeri bir sürüm kullanmanız gerekmektedir. cURL ve JSON eklentileri API iletişimi için zorunludur; bu eklentiler çoğu PHP kurulumunda varsayılan olarak aktiftir. Composer paket yöneticisi SDK kurulumu için önerilir ancak zorunlu değildir. Tüm ödeme işlemleri HTTPS üzerinden gerçekleştirildiği için web sunucunuzda geçerli bir SSL sertifikası bulunmalıdır.
| Gereksinim | Değer |
|---|---|
| PHP | 7.4 veya üzeri |
| Composer | Önerilen |
| cURL Eklentisi | Gerekli |
| JSON Eklentisi | Gerekli |
| SSL Sertifikası | Gerekli (HTTPS) |
| SanalPos.com Hesabı | Ücretsiz başvuru |
Sıkça Sorulan Sorular
PHP sanal POS entegrasyonu hakkında merak edilenler.
PHP Projenize Ödeme Entegrasyonu Ekleyin
Taahhüt yok, gizli maliyet yok.
Yalnızca başarılı işlemler için komisyon ödersiniz.
Neden Bizi Tercih Etmelisiniz