ÖdecikGeliştirici

Başlangıç

Hızlı başlangıç

On dakikadan kısa sürede ilk ürününü oluştur ve ilk ödeme bağlantını üret.

  1. Hesap ve mağaza

    odecik.com üzerinden hesap aç, mağazanı oluştur ve IBAN bilgini kaydet. IBAN olmadan panel açılmaz; ödemeler bu hesaba aktarılır.

  2. API anahtarı oluştur

    Panelde Geliştirici → API Anahtarları bölümüne git. Ürün ve sipariş oluşturacaksan read,write, yalnızca okuyacaksan read yetkisi ver. Anahtar yalnızca bir kez gösterilir — güvenli bir yere kaydet.

    .env
    ODECIK_API_KEY=odecik_sk_xxxxxxxxxxxxxxxxxxxxxxxx

  3. Kimlik doğrulamayı dene

    curl https://odecik.com/api/v1/store \
  -H "Authorization: Bearer $ODECIK_API_KEY"
    200 — yanıt
    {
  "object": "store",
  "id": "cm9x2k1a30001",
  "name": "Ayşe'nin Mağazası",
  "slug": "ayse",
  "url": "https://odecik.com/magaza/ayse",
  "isPublic": true
}

  4. Ürün oluştur

    curl -X POST https://odecik.com/api/v1/products \
  -H "Authorization: Bearer $ODECIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Premium şablon paketi",
    "type": "DIGITAL",
    "priceKurus": 14900,
    "description": "12 sayfalık UI kit"
  }'

    Yanıttaki url ürünün herkese açık ödeme sayfasıdır; olduğu gibi paylaşabilirsin.

  5. Sunucundan ödeme başlat

    Kendi sitende özel bir akış kuruyorsan ödeme oturumu oluştur ve alıcıyı paymentUrl'ye yönlendir. Ayrıntılar için Ödeme akışı rehberine bak.

  6. Webhook'u bağla

    Siparişin ödendiğini yoklama (polling) yapmadan öğrenmek için webhook tanımla. İmzayı doğrulamayı unutma.