İlk Ödemeni Al

5 dakikada ilk ödemenizi alın. Bu rehber sizi adım adım yönlendirecek.

Ön Gereksinimler

Gereksinim	Açıklama
Merchant API Key	Paylox ekibi tarafından size e-posta ile iletilir
Bir web sitesi veya uygulama	Ödeme alacağınız platform

API Key'iniz henüz yok mu?

[email protected] adresine e-posta gönderin. Ekibimiz size bir API Key oluşturup iletecektir.

Genel Akış

---

Adım 1: API Key'inizi Hazırlayın

Paylox ekibi size şuna benzer bir anahtar iletecektir:

fbd654ad-6448-4cbc-9780-5cdd3eadb677

Bu anahtarı güvenli bir yerde saklayın. Her ödeme isteğinde kullanacaksınız.

Güvenlik

API Key'inizi frontend koduna koymayın. Sadece sunucu tarafında (backend) kullanın.

---

Adım 2: Checkout Session Oluşturun

Müşteriniz ödeme yapmak istediğinde, sunucunuzdan Paylox API'ye istek gönderin:

curl -X POST https://api.jetcheckout.com/api/v1/embedded/session \
  -H "Content-Type: application/json" \
  -d '{
    "merchant_api_key": "BURAYA_API_KEYINIZI_YAZIN",
    "amount": 1000,
    "currency": "TRY",
    "customer": {
      "name": "Ahmet",
      "surname": "Yılmaz",
      "email": "[email protected]",
      "phone": "+905551234567"
    },
    "success_url": "https://yoursite.com/payment/success",
    "fail_url": "https://yoursite.com/payment/fail"
  }'

Paylox size şöyle bir yanıt döner:

{
  "session_id": "ses_a1b2c3d4e5f6g7h8i9j0k1l2",
  "checkout_url": "https://checkout.paylox.io?session=ses_a1b2c3d4e5f6g7h8i9j0k1l2",
  "expires_at": "2025-01-15T14:30:00Z"
}

Alan	Açıklama
session_id	Ödeme oturumunun kimlik numarası
checkout_url	Müşteriyi yönlendireceğiniz ödeme sayfası
expires_at	Session geçerlilik süresi (1 saat)

Tutar Formatı

amount alanı kuruş cinsindendir:

Tutar	amount değeri
10,00 TL	1000
99,99 TL	9999
1.250,00 TL	125000

---

Adım 3: Müşteriyi Ödeme Sayfasına Yönlendirin

Yöntem A: Hosted Checkout (Önerilen)

Müşteriyi Paylox'un hazır ödeme sayfasına yönlendirin:

window.location.href = "https://checkout.paylox.io?session=ses_a1b2c3d4e5f6g7h8i9j0k1l2";

Yöntem B: Embedded Checkout

Ödeme formunu kendi sitenizde gösterin:

<script src="https://checkout.paylox.io/sdk/paylox.js"></script>
<div id="paylox-checkout"></div>
<script>
  Paylox.init({
    sessionId: "ses_a1b2c3d4e5f6g7h8i9j0k1l2",
    container: "#paylox-checkout",
    onSuccess: function(data) {
      alert("Odeme basarili! Siparis No: " + data.order_id);
    },
    onFail: function(error) {
      alert("Odeme basarisiz: " + error.message);
    }
  });
</script>

---

Adım 4: Ödeme Sonucunu Alın

Ödeme tamamlandığında müşteri belirlediğiniz adrese yönlendirilir:

Başarılı ödeme URL örneği:

https://yoursite.com/payment/success?order_id=ORD-xxx&status=success&session_id=ses_xxx

Ödemeyi Doğrulayın

URL parametrelerine güvenmeyin. Sunucunuzdan Paylox API'ye sorgu yaparak ödemeyi doğrulayın:

GET /api/v1/payment/status/{order_id}?session_id=ses_xxx

---

Sırada Ne Var?

• Sandbox Ortamı — Test ortamında deneme yapın
• Test Kartları — Sandbox'ta kullanabileceğiniz kart numaraları
• API Referansı — Tüm endpoint'lerin detayları
• Playground — Canlı demo ortamı