Bu kimin için?
Hali hazırda Hosted Checkout kullanan ve Unified Checkout'a geçmek isteyen tüm satıcılar için geçerlidir . Yeni bir CyberSource hesabına gerek yoktur: Bu işlem yalnızca mevcut üretim satıcı kimliğinde (MID) yeni bir hizmeti etkinleştirir ve OpenApply yapılandırmasını ona aktarır.
⚠️ OpenApply CyberSource modu ( Hosted Checkout vs. Unified Checkout ), kullanıcı veya oturum başına değil, okul başına tek bir ayardır. Bu ayar değiştirildiği anda, o okuldaki her veli Birleşik Ödeme'yi kullanmaya başlar. Aşamalı bir dağıtım veya sadece personele özel önizleme olmadığı için lütfen buna göre plan yapın.
Kontrol listesi
- Üretim MID'inde Birleşik Ödeme, Ödeme Yapanın Kimlik Doğrulaması (3DS) ve Karar Yöneticisi'ni etkinleştirmek için bir MID Yapılandırma Talebi gönderin.
- Hizmet onaylandıktan sonra yeni bir REST API anahtarı oluşturun.
- Trafik yoğunluğunun düşük olduğu bir dönemde: Hosted Checkout kimlik bilgilerini yedekleyin, ardından OpenApply yeni anahtar ve Decision Manager onay kutusuyla Unified Checkout'a geçirin.
- Birleşik Ödeme web kancasını kurun.
- Tek bir gerçek işlemle doğrulayın, ardından geçişi sürdürün veya geri alın.
Adım 1: Hizmeti etkinleştirin (Hizmet Etkinleştirme)
İş Merkezi'nde Destek → Destek Merkezi'ni açın:
Bu, Vize Kabul Çözümleri Destek Merkezi'ni açar. Destek talepleri → MID yapılandırma isteği bölümüne gidin:
Formu gönderirken yalnızca "Hizmet etkinleştirme" seçeneğini işaretleyin ve şu talebi iletin:
- Birleşik Ödeme İşlemi (REST API)
- Ödeme Yapanın Kimlik Doğrulaması (3DS)
- Karar Yöneticisi (dolandırıcılık taraması gerekiyorsa)
Ortam altında, yalnızca Üretim seçeneğini işaretleyin. Özel seçeneğini işaretli bırakın.
CyberSource ile ilgili sorularınız için lütfen doğrudan CyberSource destek ekibiyle iletişime geçin.
CyberSource bunu dahili olarak işler (yayınladıkları belgelere göre, genellikle 3 iş günü içinde). Bu onaylanana kadar bu kılavuzdaki başka hiçbir şey ilerleyemez, çünkü 2. adımda oluşturulan REST anahtarı ve 3. adımda yer alan Karar Yöneticisi onay kutusu, öncelikle bu hizmetlerin satıcı hesabında etkinleştirilmesine bağlıdır.
Adım 2: Yeni REST API anahtarını oluşturun ve kaydedin.
⚠️ Birleşik Ödeme anahtarı, aynı satıcıya/Profile ait olsalar bile, Barındırılan Ödeme anahtarıyla aynı değildir . Barındırılan Ödeme, Güvenli Kabul Erişim Anahtarı + Gizli Anahtar kullanırken; Birleşik Ödeme ayrı bir REST API anahtarı (Anahtar Kimliği + Paylaşılan Gizli Anahtar) kullanır. Bunlar İş Merkezi'nde farklı yerlerde bulunur ve birbirlerinin yerine kullanılamazlar.
Hizmet etkinleştirildikten sonra, İş Merkezi → Ödeme Yapılandırması → Anahtar Yönetimi bölümüne gidin:
Tıklayın + Anahtar oluşturun :
Unified Checkout'un kullandığı REST API'leri için önerilen tür olan "REST - Shared Secret" anahtar türünü seçin:
Aşağıdaki eski SCMP / SOAP Toolkit seçeneklerini dikkate almayın (CyberSource bunları kullanım ömrünün sonuna işaretlemiştir) ve Anahtar oluştur'a tıklayın:
Üretim tarihini doğrulayın:
CyberSource, Paylaşılan Gizli Anahtarı yalnızca bir kez gösterdiğinden, Anahtarı ve Paylaşılan Gizli Anahtarı hemen kopyalayın (veya indirin):
3. Adım: Hosted Checkout'u yedekleyin, ardından OpenApply Unified Checkout'a geçirin.
⚠️ Bu adım, okuldaki tüm velileri anında Birleşik Ödeme sistemine yönlendirir: Mod ayarı tüm okul tarafından paylaşılır (yukarıdaki uyarıya bakın) ve bu moda geçmeden Birleşik Ödeme sistemini test etmenin bir yolu yoktur. Bu adımı, 5. adıma kadar, trafiğin az olduğu bir zaman diliminde tek seferde yapmak isteyebilirsiniz.
Herhangi bir değişiklik yapmadan önce , OpenApply yönetim panelinde okulun Ödeme ayarlarını açın ve daha sonra geri alma gerekmesi ihtimaline karşı mevcut Barındırılan Ödeme yapılandırmasını (Satıcı Kimliği, Profil Kimliği, Erişim anahtarı, Gizli anahtar) güvenli bir yere kaydedin:
Ardından Modu Birleşik Ödeme olarak değiştirin ve yeni değerleri girin:
- Satıcı Kimliği : öncekiyle aynı değer; satıcı hesabı değişmiyor.
- Erişim anahtarı / Gizli anahtar : 2. adımda oluşturulan Anahtar Kimliği ve Paylaşılan Gizli Anahtar (Barındırılan Ödeme Erişim anahtarını/Gizli anahtarını tekrar kullanmayın ; 2. adımdaki uyarıya bakın)
- Bu modda Profil Kimliği alanının kaybolduğunu unutmayın: Bu alan yalnızca Hosted Checkout'a özgüdür ve Unified Checkout tarafından kullanılmaz.
- Ortam : Canlı Ortamı seçin
- Şimdi, 1. Adım isteğine dahil edilip onaylandıysa, Karar Yöneticisi ile ekran işlemlerini kontrol edin (bunu 4. Adımdan önce yapın: webhook aboneliği, kurulum sırasında bu onay kutusunun belirttiği değere göre oluşturulur).
Adım 4: Webhook'u kurun
Öncelikle 3. adımdaki Birleşik Ödeme yapılandırmasını kaydedin. Kaydedildikten sonra, aynı ayarlar ekranına gidin (yukarıdaki ekran görüntüsündeki Birleşik Ödeme webhook bölümüne bakın) ve "Webhook'u otomatik olarak kur" seçeneğine tıklayın. Bu işlem, şifrelenmiş webhook kimlik bilgilerini oluşturur ve kaydeder, bir sağlık kontrolü yapar ve aboneliği oluşturur. Business Center'da manuel adımlara gerek yoktur.
Adım 5: Gerçek bir işlemle doğrulayın, ardından geçişi sürdürün veya geri alın.
- Yeni REST anahtarının kaydedildiğini ve Decision Manager / 3DS / webhook aboneliğinin üretim MID'si için etkin olduğunu doğrulayın.
- Küçük bir gerçek işlem gerçekleştirin ve doğrulayın: yetkilendirme başarılı olur ve OpenApply ücret/fatura durumu doğru şekilde güncellenir.
- Her şey yolunda ise, geçiş olduğu gibi kalır: başka bir işlem gerekmez, ebeveynler artık Birleşik Ödeme Sistemi üzerinden ödeme yaparlar. Herhangi bir sorun varsa, hemen geri alın.
Geri alma: Modu tekrar Barındırılan Ödeme'ye geçirin ve 3. adımda yedeklenen kimlik bilgilerini geri yükleyin. Bu işlem, okuldaki tüm velileri anında Barındırılan Ödeme'ye geri döndürür.