Checkouts

Checkout nesnesi, bir ödeme oturumunun yapılandırmasını ve durumunu temsil eder. Hosted Checkout ve Embedded Checkout yöntemlerinin temelini oluşturur.

Checkout Nesnesi

{
  "session_id": "ses_a1b2c3d4e5f6g7h8i9j0k1l2",
  "checkout_url": "https://checkout.paylox.io?session=ses_a1b2c3d4e5f6g7h8i9j0k1l2",
  "amount": 15000,
  "currency": "TRY",
  "status": "active",
  "expires_at": "2025-01-15T14:30:00Z",
  "customer": {
    "name": "Ahmet",
    "surname": "Yılmaz",
    "email": "[email protected]"
  },
  "success_url": "https://yoursite.com/payment/success",
  "fail_url": "https://yoursite.com/payment/fail"
}

Alanlar

Alan	Tip	Açıklama
session_id	string	Benzersiz oturum kimliği
checkout_url	string	Hosted Checkout sayfası URL'i
amount	integer	Tutar (kuruş cinsinden)
currency	string	Para birimi (TRY, USD, EUR)
status	string	Oturum durumu
expires_at	string	Son geçerlilik zamanı (ISO 8601)
customer	object	Müşteri bilgileri
success_url	string	Başarılı ödeme yönlendirme adresi
fail_url	string	Başarısız ödeme yönlendirme adresi
metadata	object	Özel alanlar (callback'te geri döner)

Hosted vs Embedded Farkları

Özellik	Hosted Checkout	Embedded Checkout
Ödeme sayfası	Paylox'un sayfasında	Sizin sitenizde (widget)
Kullanım	checkout_url'e yönlendirme	session_id ile SDK init
Tasarım	Paylox teması	CSS variable ile özelleştirme
PCI kapsamı	SAQ-A	SAQ-A
3DS yönetimi	Otomatik	Otomatik

Checkout Durumları

Durum	Açıklama
active	Ödeme bekliyor
completed	Ödeme tamamlandı
expired	Süre doldu (1 saat)
cancelled	İptal edildi