Skip to main content

Hızlı Başlangıç

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

Ön Gereksinimler​

  • Paylox merchant hesabı (Odoo panelinden oluşturulur)
  • merchant_api_key (Odoo → Paylox Checkout → Merchants → API Key)

Adım 1: API Key'inizi Alın​

Odoo paneline giriş yapın:

  1. Paylox Checkout menüsüne gidin
  2. Merchants → Merchant'ınızı seçin
  3. Merchant API Key alanındaki değeri kopyalayın
tip

API Key otomatik oluşturulur. Kaybederseniz "Regenerate API Key" butonuyla yenileyebilirsiniz.

Adım 2: Checkout Session Oluşturun​

Ödeme almak istediğinizde, backend'inizden şu isteği gönderin:

curl -X POST https://api.paylox.io/api/v1/checkout/session \
  -H "Content-Type: application/json" \
  -d '{
    "merchant_api_key": "YOUR_MERCHANT_API_KEY",
    "amount": 1000,
    "currency": "TRY",
    "customer": {
      "name": "Ahmet",
      "surname": "Yılmaz",
      "email": "ahmet@example.com",
      "phone": "+905551234567"
    },
    "success_url": "https://yoursite.com/payment/success",
    "fail_url": "https://yoursite.com/payment/fail"
  }'

Yanıt:

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

amount alanı kuruş cinsindendir. Örneğin:

  • 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 (En Kolay)​

Müşteriyi checkout_url'e yönlendirmeniz yeterli:

// Frontend
window.location.href = response.checkout_url;

Yöntem B: Shadow DOM Widget (Kendi Sitenizde)​

<!-- 1. Script'i ekleyin -->
<script src="https://checkout.paylox.io/sdk/paylox.js"></script>

<!-- 2. Container oluşturun -->
<div id="paylox-checkout"></div>

<!-- 3. Widget'ı başlatın -->
<script>
  Paylox.init({
    sessionId: "ses_a1b2c3d4e5f6g7h8i9j0k1l2",
    container: "#paylox-checkout",
    onSuccess: function(data) {
      console.log("Ödeme başarılı!", data);
    },
    onFail: function(error) {
      console.log("Ödeme başarısız:", error);
    }
  });
</script>

Adım 4: Ödeme Sonucunu Alın​

Ödeme tamamlandığında, Paylox belirttiğiniz success_url veya fail_url adresine yönlendirme yapar.

Yönlendirme URL'inde şu parametreler bulunur:

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

Sırada Ne Var?​