Sıkça Sorulan Sorular
Genel
Paylox'u kullanmak için ne gerekiyor?
Bir merchant API Key'i ve ödeme almak istediğiniz bir web sitesi veya uygulama. API Key almak için [email protected] adresine başvurun.
Hangi ödeme yöntemlerini destekliyorsunuz?
Kredi kartı, debit kart, havale/EFT, alışveriş kredisi ve dijital cüzdan.
Entegrasyon ne kadar sürer?
Hosted Checkout ile 30 dakika, Embedded Checkout ile birkaç saat, Server-to-Server ile 1-2 gün.
Hangi para birimlerini destekliyorsunuz?
TRY, USD ve EUR.
Entegrasyon
Hangi entegrasyon yöntemini seçmeliyim?
| Durum | Önerilen Yöntem |
|---|---|
| Hızlıca başlamak istiyorum | Hosted Checkout |
| Ödeme formu kendi sitemde olsun | Embedded Checkout |
| Tam kontrol istiyorum, PCI DSS sertifikam var | Server-to-Server |
Session ne kadar süre geçerli?
1 saat. Bu süre içinde ödeme tamamlanmazsa session sona erer.
Aynı session ile birden fazla ödeme yapılabilir mi?
Hayır. Her session tek kullanımlıktır. Yeni ödeme için yeni session oluşturun.
Test kartları production'da çalışır mı?
Hayır. Test kartları yalnızca sandbox ortamında çalışır.
Ödeme
3D Secure zorunlu mu?
Çoğu banka 3D Secure gerektirir. is_3d: true göndermenizi öneriyoruz.
Taksitli ödeme nasıl yapılır?
BIN sorgulama ile taksit seçeneklerini alın, müşterinin seçtiği taksit sayısını installment_count olarak gönderin. Hosted ve Embedded Checkout'ta bu otomatik yönetilir.
Debit kartta taksit yapılabilir mi?
Hayır. Taksit yalnızca kredi kartlarında desteklenir.
İade ne kadar sürede yansır?
Bankaya göre 1-10 iş günü.
Kısmi iade yapabilir miyim?
Evet. amount parametresiyle istediğiniz tutarı iade edebilirsiniz. Birden fazla kısmi iade yapılabilir.
Güvenlik
API Key'im ele geçirilirse ne yapmalıyım?
Hemen [email protected] adresine bildirin. Mevcut key iptal edilip yeni key oluşturulur.
PCI DSS sertifikam yok, ödeme alabilir miyim?
Evet. Hosted Checkout veya Embedded Checkout kullanın. Bu yöntemlerde kart bilgileri sizin sunucunuzdan geçmez.
Kart bilgileri sunucumda saklanır mı?
Hosted ve Embedded Checkout'ta hayır. Server-to-Server'da kart bilgileri sunucunuzdan geçer (PCI DSS gerektirir) ancak Paylox tarafında tokenize edilir.
Teknik
Rate limit aşıldığında ne yapmalıyım?
Retry-After header'ındaki süre kadar bekleyin ve tekrar deneyin. Detaylar: Rate Limiting
Webhook gelmiyorsa ne yapmalıyım?
- Callback URL'inizin dışarıdan erişilebilir olduğunu kontrol edin
- HTTPS kullandığınızdan emin olun
- Sunucunuzun HTTP 200 döndüğünü doğrulayın
- Firewall kurallarını kontrol edin
CORS hatası alıyorum
API isteklerini backend'den yapın, frontend'den değil. Paylox API'si doğrudan tarayıcıdan çağrılmak üzere tasarlanmamıştır.