İçeriğe Geç

Ticimax Craftgate Webhook Bildiriminde Ödeme Onayı

Ticimax Craftgate bağlantısında webhook anahtarı, dönüş adresi ve olay seçimini inceleyerek onaysız görünen siparişi ödeme sonucuyla eşleştirin.

Yazar: Teknik AçıklamaPlatforma ÖzelÖdeme ve GüvenlikAltyapı ve Entegrasyon
AdPix tarafından hazırlanan açıklayıcı şema.

Başarılı Ödeme Neden Onaysız Görünür?

Ticimax Craftgate entegrasyonunda ödeme sağlayıcısındaki işlemle mağazanın sipariş durumu ayrı sistemlerde izlenir. Ödeme tamamlandığı hâlde mağazada onay görülmüyorsa bildirim yolu araştırılır. Müşteriden hemen tekrar ödeme istenmeden mevcut işlemin gerçek sonucu belirlenir. Resmî Ticimax belgesi, webhook sonrası yeniden ödeme sorgusu üzerinden başarılı işlemin sipariş durumuna yansıtılmasını açıklar. İnceleme ödeme referansı ve sipariş kimliğiyle başlar; yalnız müşterinin ekrandaki başarı mesajı veya paneldeki tek durum adına göre karar verilmez.

Doğru Ortamın Bilgileri

Craftgate test ve canlı ortamları farklı anahtarlar ve adresler kullanır. Sağlayıcı belgesi test anahtarlarının canlı ortamda çalışmadığını açıklar. Ticimax ödeme ayarlarına girilen bilgiler hangi ortamın kullanıldığıyla karşılaştırılır. Test sırasında başarılı görünen işlem gerçek banka tahsilatı gibi sunulmaz. Canlı ortamın verileri açık ekran görüntüsüne eklenmez. Hangi hesaba ait bilgilerin kullanıldığı doğrulanır; anahtarların hepsini tekrar oluşturmak yerine mevcut bağlantının kapsamı anlaşılır ve hata araştırması doğru ortamla sınırlandırılır.

Craftgate Webhook Ayarları

Craftgate Webhook Ayarları ilgili resmî yardım belgesindeki örnektir. Bu ekran, makaledeki ilgili ayara hangi bölümden ulaşıldığını veya o aşamada hangi alanların görüldüğünü açıklar. Alanların yeri kullanılan panel sürümüne göre değişebilir.

Webhook Anahtarını Eşleştirmek

Webhook sistemler arasında işlem bildirimi taşır. Ticimax Craftgate alanındaki Webhook Key değeri, Craftgate tarafında tanımlanan anahtarla uyumlu olmalıdır. Değerin iki tarafta da kayıtlı olması yetmez; aynı anahtarı temsil ettiği doğrulanır. Kopyalama sırasında boşluk veya başka projeden kalan değer bulunması araştırılır. Kurgusal bir mağazada test anahtarı canlı kurulumda bırakılmışsa bildirim beklenen kayda ulaşmayabilir. Anahtarın kendisi destek mesajının açık bölümüne yazılmaz; kontrol sonucu ve hata aşaması hassas değer paylaşılmadan açıklanır ve gerekli iletişim güvenli kanalla yürütülür.

Craftgate Bildirimini Siparişe Bağlama

Ortamı Doğrulayın: Test ve canlı anahtarlarını birbirinden ayırın. Bildirimi Eşleştirin: Anahtar, olay ve hedef adresi birlikte inceleyin. Onayı Kontrol Edin: Gerçek ödeme sonucunu doğru siparişle bağlayın. Bildirim ayarı ve gerçek tahsilat sonucu ayrı doğrulanır. Şema kavramsal anlatımdır; gerçek panel ekranı, müşteri verisi veya yapılmış test sonucu değildir.

Dönüş Adresi ve Olay Seçimi

Ticimax belgesi mağazaya ait Craftgate bildirim adresinin tanımlanmasını ve ortak ödeme sayfası için CHECKOUTFORM_AUTH olayının seçilmesini belirtir. Kullanılan alan adı gerçek mağazayla aynı olmalıdır; örnek alan adı veya eski site kaydı bırakılmaz. Alan adı değişiminde bu hedef yeniden değerlendirilir. Belgedeki olay seçimi kullanılan entegrasyon kapsamına aittir; başka özel entegrasyonlar için gelişigüzel genellenmez. Bildirim hedefiyle müşterinin tarayıcıda gördüğü son sayfa aynı kavram değildir; iki yolun işlevi birbirine karıştırılmadan kontrol edilir.

Yeniden Sorgu Sonucunu İzlemek

Webhook bildirimi geldiğinde ödeme sorgusunun sonucu ve ilgili sipariş durumu karşılaştırılır. Resmî belgede bildirimin gecikmeli ulaşmasına ilişkin ayar açıklanır; her işlem için kesin tamamlama süresi garantisi verilmez. İşlem henüz bekliyorsa veya hata kaydı varsa bu durum açıkça izlenir. Aynı siparişin başka ödeme referansıyla ilişkisi bulunuyorsa denemeler kimlikleriyle ayrılır. Sipariş onayını gerçeğe aykırı değiştirerek sorun gizlenmez; gerçek tahsilat ve mağaza kaydı arasında doğrulanabilir ilişki kurulması hedeflenir ve gerekirse teknik destekle işlem izi incelenir.

Kabul ve Destek Notu

Kabul kaydı kullanılan ortamı, bildirim hedefinin uygunluğunu ve ödeme referansıyla sipariş sonucunun eşleşmesini içerir. Başarılı tahsilatın mağazada doğru siparişi onayladığı görülmelidir. Gerçekleştirilmemiş ödeme veya webhook denemesi yapılmış gibi raporlanmaz. Destek talebinde kart bilgileri yerine gerekli işlem kimliği ve hata açıklaması kullanılır. Aynı bildirimin tekrar ele alınmasıyla yeni ödeme talebi birbirinden ayrılır. Sonuç, yalnız ayarların dolu olmasına değil doğru işlemin doğru mağaza kaydına yansımasına dayanır; açık kalan kayıtlar ayrıca izlenmeye devam eder.

Bu Yazıdaki Terimler 1 Kavram

Kısa açıklamaları burada okuyabilir, ayrıntılar için sözlüğe geçebilirsiniz.

Webhook
Webhook, bir sistemde sipariş oluşması ya da ödeme tamamlanması gibi bir olay gerçekleştiğinde olay bilgisini önceden kaydedilmiş bir adrese HTTP isteğiyle kendiliğinden gönderen bildirim yöntemidir.

Bu Konuda Nasıl Destek Oluyoruz?

AdPix’in bu alandaki hizmet kapsamını ve çalışma sürecini inceleyin.

İlgili Platformlarda Keşfedin

Ticimax