İçeriğe geç
Ücretsiz başlayın
Pilot kapsamında

Tek API ile ödeme alın, sonucu doğrulanmış olarak öğrenin.

Sunucunuz sipariş tutarı ve referansıyla bir ödeme oturumu açar; müşteri mobil uyumlu ödeme sayfasında taksidini seçer, kartını sağlayıcının güvenli sayfasında girer. Sonuç sağlayıcıdan sorgulanarak kesinleşir.

Ücretsiz başlayınGeliştirici dokümanı

API ve test ortamı pilot öncesi hazırlıkta; canlı kullanım işletme başvurusu onaylanınca açılır.

Ödeme oturumuÖrnek veri
curl https://api.efespay.com/v1/payment-sessions \
  -H "Authorization: Bearer $EFESPAY_SECRET_KEY" \
  -H "Idempotency-Key: order-1001" \
  -H "Content-Type: application/json" \
  -d '{
    "order_reference": "ORDER-1001",
    "amount_minor": 125000,
    "currency": "TRY",
    "installment_options": [1, 3, 6],
    "return_url": "https://shop.example.com/order/1001"
  }'

Yanıt (201)

{
  "id": "ps_…",
  "object": "payment_session",
  "status": "open",
  "url": "https://efespay.com/pay/ps_…",
  "payment_id": "pay_…"
}

Ödeme akışının zor kısmı bizde.

Sağlayıcıların farklı API'leri, geri dönüşleri ve hata kodları tek sözleşmede birleşir.

  • Tek sözleşme

    Bütün sağlayıcılar için aynı istek ve yanıt biçimi: snake_case alanlar, kuruş cinsinden tutarlar.

  • Doğrulanmış sonuç

    Tarayıcı dönüşü ödemeyi başarılı saymaz; sonuç sunucu tarafında sağlayıcıdan okunur.

  • Çift ödeme yok

    Idempotency-Key ve sipariş referansı koruması, aynı sipariş için ikinci açık ödemeyi engeller.

  • Belirsizlik ayrı durum

    Sağlayıcı yanıt vermezse ödeme başarısız sayılmaz; "doğrulanıyor" durumunda kalır ve otomatik sorgulanır.

Nasıl çalışır?

Dört adımda siparişten doğrulanmış sonuca.

  1. 1. adım: Oturum açın

    POST /v1/payment-sessions ile tutar, sipariş referansı ve taksit seçeneklerini gönderin.

  2. 2. adım: Müşteriyi yönlendirin

    Yanıttaki url müşteriyi işletmenizin adıyla açılan ödeme sayfasına götürür.

  3. 3. adım: Müşteri öder

    Kart bilgisi sağlayıcının güvenli sayfasında girilir; gerekirse 3D Secure tamamlanır.

  4. 4. adım: Sonucu alın

    İmzalı webhook gelir; GET /v1/payments/{id} ile istediğiniz an doğrulayabilirsiniz.

Ödemeden sonrası da aynı API'de.

İade, kısmi iade ve iptal aynı ödeme kaydı üzerinden yapılır. Her sağlayıcı çağrısı ayrı bir deneme olarak tutulur; panelde ve API'de yönlendirme gerekçesiyle birlikte görünür.

  • Tam ve kısmi iade; toplam iade tahsil edilen tutarı aşamaz
  • Sağlayıcı destekliyorsa iptal (void)
  • Test modu ve senaryolu test kartları
  • İmzalı webhook ve olay günlüğü
  • Ödeme sayfasında işletme adı, rengi ve destek iletişimi

İlgili çözümler

Bütün çözümler

Sık sorulan sorular

Sorunuzu bize yazın
Kart bilgileri Efespay'den geçer mi?

Hayır. Kart bilgisi sağlayıcının güvenli ödeme sayfasında girilir; Efespay ve işletme kart numarasını görmez. Efespay'de yalnız sağlayıcının döndürdüğü maskeli özet (BIN, son dört hane) tutulur.

Müşteri ödeme sayfasından siteme dönünce ödeme başarılı sayılır mı?

Sayılmaz. Tarayıcı dönüşü tek başına kanıt değildir. Siparişi webhook ile ya da GET /v1/payments/{id} yanıtındaki doğrulanmış duruma göre güncelleyin.

Sağlayıcı yanıt vermezse ne olur?

Ödeme başarısız sayılmaz, "doğrulanıyor" durumuna geçer. Efespay sağlayıcıyı aralıklarla sorgular; sonuç kesinleşince durum güncellenir ve webhook gönderilir.

Entegrasyonu test modunda birlikte deneyelim.

Mevcut ödeme akışınızı anlatın; API'yi test anahtarlarıyla nasıl bağlayacağınızı birlikte planlayalım.

Ücretsiz başlayınGeliştirici dokümanı