Geliştirici
Bildirim adresleri ve entegrasyon mimarisi
PlusTurk'te genel bir API yoktur; entegrasyonlar sağlayıcı bağlantıları ve bildirim (webhook) adresleridir. PayTR bildirimi, ödeme dönüş adresi ve doğrulama sayfaları.
1 dk okumaGüncelleme: 21 Eylül 2026v2026.09
Adresler#
| Adres | Kim çağırır? | Amaç |
|---|---|---|
/odeme/<anahtar> | Borçlu (tarayıcı) | Ödeme bağlantısı sayfası |
/odeme/<anahtar>/belge | Borçlu | Borcu yoktur belgesi / makbuz |
/api/pay/notify/<sağlayıcı>/<firma-kimliği> | Sağlayıcı (PayTR) | Sunucudan sunucuya ödeme sonucu bildirimi |
/api/pay/callback/<işlem-kimliği> | Borçlunun tarayıcısı | Ödeme sonrası dönüş adresi |
/dogrula/<kod> | Herkes | Borcu yoktur belgesinin doğrulanması |
Tüm adresler https://panel.plusturk.com altındadır.
PayTR bildirimi#
1POST /api/pay/notify/paytr/<firma-kimliği> HTTP/1.12Host: panel.plusturk.com3Content-Type: application/x-www-form-urlencoded4 5merchant_oid=PT8F2K91XA&status=success&total_amount=1245000&hash=<imza>PlusTurk bildirimi işlerken şunları yapar:
hashdeğerini mağaza anahtarlarınızla yeniden hesaplayıp karşılaştırır; uyuşmayan istek işlenmez.- Bildirilen
merchant_oidişlemini bulur ve tutarı kendi kaydıyla karşılaştırır. - Sonucu işler (başarılıysa tahsilat + dosya güncellemesi) ve PayTR'nin beklediği yanıtı döner.
- Aynı bildirim tekrar gelirse ödeme ikinci kez işlenmez.
Sağlayıcıya giden istekler#
| Servis | Yöntem |
|---|---|
| iyzico | Checkout Form oluşturma / sonuç sorgulama |
| PayTR | iFrame API token isteği |
| Stripe | Checkout Session oluşturma |
| Nestpay bankaları | 3D Pay Hosting form yönlendirmesi |
| SMS sağlayıcıları | Sağlayıcının HTTP / XML API'si |
Sağlayıcı isteklerinde kullanılan anahtarlar şifreli saklanır: API bilgilerinin korunması.