Genel Bakış

Satış Azminizi Paraya Dönüştürün

Odesin ile mağazanızı oluşturun; kart, havale/EFT ve e-ticaret araçlarıyla ödemelerinizi harekete geçirin. Bu dokümantasyon API, webhook ve mağaza entegrasyonunu adım adım anlatır.

Base URL

https://odesin.com

Auth

x-api-key + HMAC

API

v1.8 · JSON

Odesin Nedir?

Odesin, e-ticaret mağazanızı kurup ödemelerinizi tek yerden yönetmenizi sağlayan altyapıdır. Kart ödemelerinde +20 banka ve lisanslı ödeme kuruluşuna tek entegrasyon; havale/EFT ve açık bankacılıkta hızlı onay; cüzdanda tüm gelirin takibi ve çekimi sunulur.

Geliştirici tarafında model basittir: sunucunuz API anahtarı ve HMAC ile oturum oluşturur, müşteri checkout veya Elements ile ödemeyi tamamlar, sonuç webhook ve/veya return URL ile size döner. Sabit ücret yoktur; rekabetçi işlem başı komisyon uygulanır.

Önerilen Yol

İlk entegrasyonda Sanal POS (Hosted) veya Havale/EFT (Hosted) ile başlayın; ardından whitelabel, abonelik veya cashout’a geçin.

Neden Odesin?

Esnek ödeme yöntemleri, kullanışlı e-ticaret araçları ve özelleştirilebilir tema ile satışlarınızı hızla büyütün.

Tek Entegrasyon, +20 Altyapı

Yurtiçi ve yurtdışı banka ile lisanslı ödeme kuruluşlarını tek API’den kullanın. Visa, Mastercard, Troy, Amex ve Discover desteklenir.

Havale/EFT ve Açık Bankacılık

Alternatif ödemelerde kurumsal altyapı ile hızlı onay; havale/EFT ve açık bankacılık aynı mutabakat modeliyle çalışır.

E-Ticaret Araçları

Mağaza, ürün, sipariş, abonelik ve tema ile satış akışınızı özelleştirin; ödemeyi Odesin üzerinden harekete geçirin.

Anında Bakiye, Ertesi Gün Çekim

Tahsilatlar Odesin Cüzdan’a yansır; uygun bakiyeyi banka hesabınıza aktarıp durumu panelden takip edersiniz.

Sabit Ücret Yok

Rekabetçi işlem başı komisyon. Yurtiçi ve yurtdışı ödemelerde tek oran modeli ile fiyatlandırmayı sade tutarız.

Geliştirici Odaklı API

REST + JSON, HMAC imza, webhook mutabakatı ve canlı kod örnekleri ile dakikalar içinde canlıya alın.

Hızlı Başlangıç

Dakikalar içinde başvurun, mağazanızı açın ve ilk ödemeyi almaya hazır olun.

  1. 1

    Başvuru ve Mağaza

    Ücretsiz başvurun, mağazanızı açın. Panel → API Ayarları’ndan sk_live_... anahtarını kopyalayın.

  2. 2

    Ödeme Yöntemini Seçin

    Kart için Sanal POS, havale için Hosted veya Direkt, tekrarlayan tahsilat için Abonelik, bakiyeden gönderim için Cashout.

  3. 3

    Oturum Oluşturun

    POST /api/payment/create-session (veya abonelik / cashout endpoint’i) ile oturum açın; yanıtta checkout_url veya embed bilgisi gelir.

  4. 4

    Webhook ve Dönüş

    Müşteri return_url’e döner; sunucunuz callback_url ile bildirimi alır. Güvenlik için session-status ile teyit edin.

Kimlik Doğrulama

Tüm isteklerde x-api-key zorunludur. API v1.8 ile HMAC başlıkları da zorunludur.

API Anahtarı

Panel → API Ayarları → sk_live_.... Anahtar hangi mağazaya aitse oturum ve webhook o mağaza üzerinden işlenir.

HMAC

X-Odesin-Timestamp (Unix saniye) ve X-Odesin-Signature (HMAC-SHA256(apiKey, ts + "\\n" + METHOD + "\\n" + body)). Zaman damgası ±10 dk toleransındadır.
bash
curl -X POST https://odesin.com/api/payment/create-session \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk_live_XXXXXXXX" \
  -H "x-odesin-timestamp: $TS" \
  -H "x-odesin-signature: $SIG" \
  -d '{"mode":"card","amount":100,"currency":"TRY",...}'

Ödeme Ürünleri

Kart, havale/EFT, abonelik ve cashout için entegrasyon rehberlerini seçin.

Kart

Havale / EFT

Abonelik & Cashout

Tipik Entegrasyon Akışı

  1. 1.Mağaza sunucusu create-session (HMAC imzalı) çağırır.
  2. 2.Yanıttaki checkout_url / Elements ile müşteri ödeme ekranına gider.
  3. 3.3DS veya havale onayı tamamlanır; tutar Odesin bakiyesine yansır.
  4. 4.Odesin callback_url’e payment.approved / rejected gönderir.
  5. 5.Mağaza session-status ile durumu teyit eder ve siparişi kapatır.

Yardım