Zopio
Geliştiriciler/Geliştirici rehberi
Geliştirici rehberi

Ticari bilgiyi sunucuda tutun. Tarayıcıya yalnız gerekli checkout durumunu açın.

Oturum bazlı ödeme akışı modeli, arka uç sisteminizin ticari bilgiyi oluşturmasını, müşteriye dönük sınırlı bir oturumu etkinleştirmesini ve sağlayıcıya özgü kimlik bilgileri ile entegrasyon ayrıntılarını platform sınırının arkasında tutmasını sağlar.

01Oturum oluştur
02Etkinleştir
03Tarayıcı kapsamını sınırla
04Konfigürasyonu yükle
05Öde
06Sonucu gözlemle
Entegrasyon sınırı

Sunucu ile tarayıcı arasında kontrollü sınır

Üretimde kanıtlanmış oturum bazlı entegrasyon modeli; ödeme konfigürasyonu yüklenmeden ve işlem başlatılmadan önce sunucu tarafında oluşturulan bir oturum, etkinleştirme adımı ve tarayıcıya özel sınırlı erişim kullanır. Yeniden kullanılabilir tasarım ilkesi, ticari ve sağlayıcı bilgisini güvenilir tarafta tutup müşteriye yalnız deneyim için gereken durumu açmaktır.

Sunucu tarafı bilgi

Sipariş, hesap, tutar, para birimi ve iş kuralları güvenilir arka uç uygulaması tarafından belirlenir.

Checkout oturumu

Sınırlandırılmış bir oturum müşteriye dönük ödeme yolculuğunu temsil eder.

Tarayıcı kapsamı

İstemci yalnız ödeme akışını göstermek ve sürdürmek için gereken sınırlı bilgiyi alır.

Ödeme akışı konfigürasyonu

Uygun ödeme yöntemleri ve deneyim seçenekleri aktif oturum için belirlenebilir.

Sonuç

Ödeme durumu yanıt, olay ve durum sorgusu modelleriyle daha geniş işlem yaşam döngüsüne geri bağlanır.

Kanıtlanmış model

Oturum bazlı ödeme akışı modeli

Bu yapı, mağaza veya mobil uygulamanın müşteri deneyimine odaklanmasını sağlarken arka uç ve platform iş kurallarını, sağlayıcı bağlantılarını ve işlem kimliğini korur.

  • Ticari bilgiyi güvenilir sunucu tarafı uygulamasında oluşturun.
  • Müşteri yolculuğu için sınırlandırılmış bir checkout oturumunu etkinleştirin.
  • Sağlayıcı kimlik bilgileri veya sağlayıcıya özgü ayrıntılar yerine yalnız sınırlı tarayıcı durumunu açın.
  • Ödeme deneyimini aktif oturum ve uygunluk bilgisine göre yükleyin.
  • Ortaya çıkan ödemeyi sonraki sistemlerin kullandığı aynı işlem kimliğine geri bağlayın.
Kavramsal oturum modeli — güncel API şeması değildir
{
  "session": {
    "id": "checkout-session-id",
    "reference": "your-business-reference",
    "scope": "customer-checkout"
  },
  "experience": {
    "eligible_methods": ["..."],
    "options": ["..."]
  },
  "transaction": {
    "id": "durable-transaction-id",
    "state": "..."
  }
}
Uygulama modeli

Bu sınır neden önemli

Bu modeller üretim sistemlerinde kanıtlanmış entegrasyon davranışlarını açıklar. Teknik modeli tanımlar; güncel Zopio API'sinin belirli bir endpoint adı, alan adı veya sözleşme biçimini kullanacağına dair taahhüt değildir.

01

Sağlayıcı bağımsızlığı

İstemci uygulama her sağlayıcının kimlik bilgilerine veya uygulama ayrıntılarına sahip olmak zorunda değildir.

02

Kontrollü görünürlük

Tarayıcıya açılan durum, sunucu tarafındaki ticari ve sağlayıcı bilgisinden daha sınırlı tutulabilir.

03

Yeniden kullanılabilir deneyim

Web ve mobil kanallar sağlayıcıya özgü uygulamalara dönüşmeden aynı işletim kavramlarını kullanabilir.

04

İzlenebilir sonuç

Oturumdan oluşturulan ödeme aynı gözlemlenebilir işlem yaşam döngüsünde devam eder.