Paratika, VakıfPayS ve ZiraatPay ortak ödeme sayfası için Omnipay sürücüsü
Türkçe | English
Mağazanızda kartla ödeme almanızı sağlar. Sunucunuz Paratika'da bir ödeme oturumu açar, müşteri Paratika'nın güvenli ödeme sayfasına gider, kartını ve taksitini orada seçer, sitenize geri döner. Kart bilgisi sizin sunucunuzdan hiç geçmez.
Sunucunuz ──(oturum aç)──▶ Paratika API ──▶ oturum anahtarı
Müşteri ──▶ Paratika ödeme sayfası (kart + taksit + 3D Secure) ──▶ Siteniz (dönüş adresi)
Sunucunuz ──(işlem sorgusu)──▶ Paratika API ──▶ ödeme kesinleşir
Aynı altyapı, üç ürün (platform ayarı):
platform |
Ürün | Kimin? |
|---|---|---|
paratika |
Paratika | Payten; birçok bankanın taksit kampanyası tek hesapta |
vakifpay |
VakıfPayS | Vakıfbank |
ziraatpay |
ZiraatPay | Ziraat Bankası |
Özellikler
| Ödeme | Ortak ödeme sayfası (HPP), 3D Secure sağlayıcıda |
| Taksit | Müşteri sağlayıcının sayfasında seçer; hangi taksitlerin sunulacağını siz belirlersiniz |
| İade / iptal | refund() (tam ya da kısmi), void() (gün sonundan önce) |
| Sorgu | fetchTransaction() |
| Güvenlik | Dönüşte sdSha512 imzası + sunucudan işlem sorgusu + tutar denetimi |
composer require yasinkuyu/omnipay-paratika php-http/guzzle7-adapterPHP 8.1 ya da üstü gerekir.
| Ayar | Nedir? | Nereden bulunur? |
|---|---|---|
merchant |
Üye iş yeri numarası | Hesap açılışında gönderilen bilgiler / yönetim paneli |
merchantUser |
API kullanıcısının e-posta adresi | Yönetim panelinde API yetkili bir kullanıcı açın |
merchantPassword |
API kullanıcısının şifresi | Aynı kullanıcı |
secretKey |
Üye iş yeri gizli anahtarı | Yönetim paneli → üye iş yeri ayarları. İsteğe bağlı ama önerilir |
Test ortamı için sağlayıcı ayrı bir üye iş yeri hesabı verir; herkese açık ortak bir test hesabı yoktur.
use Omnipay\Omnipay;
$gateway = Omnipay::create('Paratika');
$gateway->initialize([
'platform' => 'paratika', // paratika | vakifpay | ziraatpay
'merchant' => '10000000',
'merchantUser' => 'api@magaza.com',
'merchantPassword' => '********',
'secretKey' => '********',
'testMode' => true, // canlıya geçerken false
]);$response = $gateway->purchase([
'amount' => '149.90',
'currency' => 'TRY',
'transactionId' => 'SIP-10045', // sizin sipariş numaranız, her denemede benzersiz
'returnUrl' => 'https://magaza.com/odeme-donus.php',
'clientIp' => $_SERVER['REMOTE_ADDR'],
'allowedInstallments' => [2, 3, 6], // sunulacak taksitler (2-12)
'card' => [ // kart numarası YOK; yalnız müşteri bilgisi
'email' => 'ali@ornek.com',
'billingFirstName' => 'Ali',
'billingLastName' => 'Kaya',
'billingPhone' => '5551112233',
],
'items' => [ // isteğe bağlı; toplamı tutara eşit olmalı
['name' => 'Kazak', 'quantity' => 2, 'price' => '50.00'],
['name' => 'Kargo', 'quantity' => 1, 'price' => '49.90'],
],
])->send();
if ($response->isRedirect()) {
$response->redirect(); // müşteriyi https://…/payment/{oturum} adresine götürür
} else {
echo $response->getMessage(); // ör. "Geçersiz kullanıcı bilgileri"
}Sepet satırlarının toplamı tutarı tutmazsa paket tek satır ("Siparis SIP-10045") gönderir; sağlayıcı toplamın tutmasını şart koşar.
$result = $gateway->completePurchase([
'transactionId' => 'SIP-10045', // KENDİ kaydınızdaki sipariş no (dönüşten okunmaz)
'amount' => '149.90', // KENDİ kaydınızdaki tutar
])->send();
if (!$result->isVerified()) {
// Sonuç kesinleşmedi: imza tutmadı, sorgu yapılamadı ya da işlem hala sürüyor.
// Siparişi ödenmiş saymayın; biraz sonra fetchTransaction() ile yeniden bakın.
} elseif ($result->isSuccessful()) {
// Ödeme alındı.
$pgTranId = $result->getTransactionReference(); // iade / iptal için saklayın
$result->getInstallment();
$result->getMaskedCard(); // 545616******5454
} else {
echo $result->getMessage(); // ret nedeni
}Doğrulama nasıl çalışır? Önce dönüşteki
sdSha512imzasısecretKeyile denetlenir. Sonra paket, sizin verdiğiniz sipariş numarasıyla Paratika'ya sunucudan sorar. Onaylı bir satış ve doğru tutar görülmeden ödeme başarılı sayılmaz. Bu yüzden dönüş sayfası bir API isteği yapar.
// Gün sonundan önce: iptal
$gateway->void(['transactionReference' => $pgTranId])->send();
// Tam ya da kısmi iade
$gateway->refund(['transactionReference' => $pgTranId, 'amount' => '50.00', 'currency' => 'TRY'])->send();
// İşlemler
$gateway->fetchTransaction(['transactionId' => 'SIP-10045'])->send()->getTransactions();transactionReference (Paratika işlem no) yerine transactionId (sizin sipariş no) da verebilirsiniz.
Her yanıtta isSuccessful() ve getMessage() vardır. isReadable() false dönerse yanıt okunamamıştır: işlem
gerçekleşmiş olabilir. Otomatik olarak yeniden denemeyin; yönetim panelinden kontrol edin.
| Ayar | Varsayılan | Açıklama |
|---|---|---|
language |
tr |
Ödeme sayfasının dili |
sessionExpiry |
sağlayıcının varsayılanı (7 gün) | Oturum süresi, ör. 1h |
endpoint |
Listede olmayan kurulum için API adresi (https://…/api/v2) |
| Hata | Neden |
|---|---|
ERR10020 Geçersiz kullanıcı bilgileri |
merchantUser / merchantPassword yanlış ya da test ve canlı ortam karıştı |
ERR10010 Zorunlu parametre yok |
Hatanın violatorParam alanına bakın ($response->getData()) |
ERR10022 Satır toplamı tutmuyor |
items toplamı amount ile aynı olmalı |
ERR10048 / ERR10117 Sipariş no kullanılmış |
Her ödeme denemesinde yeni bir transactionId verin |
ERR10115 Desteklenmeyen taksit |
allowedInstallments hesabınızda tanımlı olmayan bir taksit içeriyor |
3.0, Omnipay v3 için baştan yazıldı:
- Kart numarasıyla doğrudan satış ve DirectPost kaldırıldı; ödeme ortak ödeme sayfasında alınır.
merchant,merchantUser,merchantPassword,secretKey,platformayarları;bankvemodekalktı.completePurchase()dönüşü imza ve sorguyla doğrular.- Eski sürümü (2.x) kullanmaya devam etmek isterseniz:
composer require yasinkuyu/omnipay-paratika:^2.0
composer install
vendor/bin/phpunit- Omnipay: NestPay (EST / Payten) — İş Bankası, Akbank, Halkbank, Ziraat, TEB, QNB, ING, Şekerbank, Anadolubank sanal POS'u; 3D Pay Hosting
- Omnipay: GVP (Garanti BBVA) — Garanti BBVA sanal POS'u; Ortak Ödeme Sayfası
- Omnipay: Akbank — Akbank sanal POS'u (yeni altyapı); ortak ödeme sayfası
- Omnipay: QNB — QNB sanal POS'u (PayFor); ortak ödeme sayfası
- Omnipay: Paycell SDK — Turkcell Paycell ödeme sayfası (Web SDK)
- Omnipay: Paycell API — Turkcell Paycell ödeme API'si
- Omnipay: iyzico — iyzico ödeme formu
- Omnipay: PayTR — PayTR sanal POS
- Omnipay: Posnet — Yapı Kredi Posnet sanal POS'u
MIT — Yasin Kuyu