أمس في ٠٧:٣٦
صاحب الموضوع
Günümüzde online ödeme sistemleri, e-ticaret sitelerinin temel yapı taşlarından biri haline geldi. Türkiye'nin önde gelen ödeme sağlayıcılarından Iyzico'nun API entegrasyonu ise, güvenli ve sorunsuz bir alışveriş deneyimi sunmak için kritik önemdedir. Bu rehberde, PHP kullanarak Iyzico API'sini nasıl kuracağınızı ve temel entegrasyon adımlarını detaylıca ele alacağız.
İlk adım, Iyzico'nun API anahtarlarını almakla başlar.
İyzico Geliştirici Portalı üzerinden hesap oluşturarak, test ve canlı ortamlar için API anahtarlarınızı edinebilirsiniz. Bu anahtarlar (API Key ve Secret), ödeme işlemlerinizde kimlik doğrulama ve güvenlik sağlar.
PHP projenize uygun SDK'yı yüklemek ise en kolay yoldur. Composer kullanıyorsanız, aşağıdaki komutu terminalde çalıştırabilirsiniz:
1composer require iyzico/iyzipay-php
Kurulum sonrası, temel yapılandırma dosyanızda API anahtarlarınızı tanımlamalısınız. Örneğin:
[code]
1234567
require 'vendor/autoload.php';
$options = new \Iyzipay\Options();
$options->setApiKey('API_KEYİNİZİ_BURAYA_YAZIN');
$options->setSecretKey('SECRET_KEYİNİZİ_BURAYA_YAZIN');
$options->setBaseUrl('https://api.iyzico.com'); // Test ortamı için
Daha sonra, ödeme işlemi için ödeme talep nesnesi oluşturarak aşağıdaki adımları takip edebilirsiniz:
- Müşteri ve kart bilgilerini tanımlayın.
- Ürün ve fiyat detaylarını belirleyin.
- Ödeme talebi göndermeden önce, ödeme tutarını ve detayları doğrulayın.
- İşlemi gerçekleştirin ve sonucu kontrol edin.
İşte temel bir ödeme örneği:
[code]
1234567891011121314151617181920212223242526272829303132333435363738394041
$request = new \Iyzipay\Request\CreatePaymentRequest();
$request->setLocale(\Iyzipay\Model\Locale::TR);
$request->setConversationId('123456789');
$request->setPrice('100.00');
$request->setPaidPrice('100.00');
$request->setCurrency(\Iyzipay\Model\Currency::TL);
$request->setInstallment(1);
$request->setBasketId('B67832');
$request->setPaymentChannel(\Iyzipay\Model\PaymentChannel::WEB);
$request->setPaymentGroup(\Iyzipay\Model\PaymentGroup::PRODUCT);
$paymentCard = new \Iyzipay\Model\PaymentCard();
$paymentCard->setCardHolderName('Ahmet Yılmaz');
$paymentCard->setCardNumber('4111111111111111');
$paymentCard->setExpireMonth('12');
$paymentCard->setExpireYear('2030');
$paymentCard->setCvc('123');
$paymentCard->setRegisterCard(0);
$request->setPaymentCard($paymentCard);
$buyer = new \Iyzipay\Model\Buyer();
$buyer->setId('BY789');
$buyer->setName('Ahmet');
$buyer->setSurname('Yılmaz');
$buyer->setGsmNumber('+905551122334');
$buyer->setEmail('ahmet.yilmaz@example.com');
$buyer->setIdentityNumber('12345678900');
$buyer->setRegistrationAddress('İstanbul, Beşiktaş');
$buyer->setIp('85.34.78.112');
$buyer->setCity('İstanbul');
$buyer->setCountry('Turkey');
$buyer->setZipCode('34000');
$request->setBuyer($buyer);
$result = \Iyzipay\Model\Payment::create($request, $options);
if ($result->getStatus() == 'success') {
// Ödeme başarılı
} else {
// Hata veya başarısız
}
Bu temel adımlar, PHP ile Iyzico API entegrasyonunun başlangıç noktasıdır. Güvenlik ve performans açısından, API anahtarlarınızı gizli tutmak, SSL kullanmak ve canlı ortamda testleri tamamladıktan sonra geçiş yapmak önemlidir. Ayrıca, API dokümantasyonunu düzenli takip ederek yeni özellikleri ve güncellemeleri yakalamak da entegrasyonun sürekliliği açısından faydalıdır.
