WhatsApp Botunda Iyzico ile Otomatik Ödeme Alma

Bu rehber, WhatsApp üzerinden satış yapan ve Iyzico ile ödeme almak isteyen Türkiye'deki işletmeler için hazırlandı: ödeme linkini her seferinde elle oluşturmak yerine, bot bunu sohbet sırasında otomatik olarak nasıl yapıyor, müşteri Iyzico'nun ödeme ekranında ne görüyor ve link oluşturmadan önce neden müşterinin kimlik numarasını almanız gerektiği, hepsi burada anlatılıyor.

Iyzico entegrasyonuyla ilgili çoğu içerik yalnızca ödeme linkinin nasıl oluşturulacağını anlatır, ama linki oluşturmak için gereken kimlik numarası zorunluluğunu genelde atlar. Bu zorunluluk Iyzico'nun keyfi bir kuralı değil, Türkiye'deki MASAK (Mali Suçları Araştırma Kurulu) düzenlemelerinin bir sonucu, ve önceden bilinmezse kurulum sırasında sizi şaşırtabilir.

Kısaca:

• Ödeme WhatsApp sohbeti içinden başlar; müşteri Iyzico'nun ödeme sayfasına yönlendirilir ve sonuç bota otomatik olarak döner.
• Ödeme linkini oluşturmak için müşterinin adı, adresi ve kimlik numarası (yabancılar için pasaport numarası) gerekir. Bu MASAK düzenlemesinden kaynaklanır, fatura kuralından değil.
• Desteklenen para birimleri TRY, USD, EUR, GBP, CHF ve NOK.
• Bot yalnızca iki sonuç alır: ödeme başarılı ya da başarısız. Ara durumlar belgelenmemiştir.
• Kurulum Iyzico Merchant Panel üzerinden API Key ve Secret Key ile yapılır; test için sandbox modu mevcuttur.

WhatsApp'ta ödeme almadan önce bilmeniz gereken şey

WhatsApp, Türkiye'de satışın zaten yapıldığı yer: müşteri orada soru sorar, pazarlık eder ve karar verir. Ödemeyi de aynı sohbetin içinde tutmak, müşteriyi başka bir sekmeye ya da siteye yönlendirmenin getirdiği kopuşu ortadan kaldırır.

Kimlik numarası neden isteniyor

Iyzico'nun ödeme linki oluşturma fonksiyonu olan get_iyzico_payment_url(), yalnızca tutar ve açıklama değil, müşterinin adı, adresi ve kimlik numarasını da parametre olarak ister. Bunun nedeni iyzico'nun resmi dokümantasyonunda açıkça belirtiliyor: identityNumber alanı, Türkiye'deki MASAK düzenlemeleri gereği zorunlu, kara para aklamayı ve dolandırıcılığı önlemeye yönelik bir kimlik doğrulama gereksinimi. Türk müşteriler için bu TC Kimlik No, yabancı müşteriler için pasaport numarası.

Pratikte bu şu anlama geliyor: link oluşturulmadan önce bu bilgilerin sohbet içinde toplanması gerekiyor. Bot, ödeme adımına geçmeden önce müşteriden adını, adresini ve kimlik numarasını istemeli.

Bu adım atlanırsa link oluşturma isteği hata döner, bu yüzden müşteriden bu bilgiyi almadan ödeme adımına geçmemek gerekir.

MaviBot'ta akış nasıl işliyor

1. Bot, müşteri satın almaya hazır olduğunda sohbet içinde bir ödeme butonu sunar.
2. Müşteri tıklamadan önce bot gerekli bilgileri (ad, adres, kimlik numarası) toplar.
3. MaviBot bu bilgilerle get_iyzico_payment_url() üzerinden anlık olarak bir ödeme linki oluşturur.
4. Müşteri Iyzico'nun kendi ödeme sayfasına yönlendirilir ve ödemeyi orada tamamlar.
5. Iyzico, MaviBot'a ödemenin sonucunu bildirir ve bot sohbete otomatik olarak devam eder.

Önemli: ödeme WhatsApp'ın kendi metni içinde gerçekleşmiyor, sohbete yapıştırılan bir kod yok. Müşteri her zaman Iyzico'nun resmi sayfasından ödemeyi onaylıyor. MaviBot'un otomatikleştirdiği kısım, doğru linki doğru anda oluşturmak ve sonuca göre sohbeti manuel müdahale olmadan sürdürmek.

Sohbetten çıkan tek şey ödeme adımı, satış süreci sohbetin dışına taşmıyor.

Ödeme ekranında müşteri ne görüyor

Ödeme ekranı MaviBot'a değil, Iyzico'ya ait, ve ekranda hangi seçeneklerin çıkacağı hesabın para birimine ve ülkesine bağlı. Iyzico'nun Checkout Form ürünü TRY, USD, EUR, GBP, CHF ve NOK para birimlerini destekliyor. MaviBot bu yöntemleri seçmiyor ya da kısıtlamıyor, yalnızca linki oluşturuyor ve sonucu bekliyor.

Kurulum için gerekenler

Kurulum tek seferlik: Iyzico Merchant Panel üzerinden Settings → API Keys bölümünden bir API Key ve Secret Key alınır. Test işlemleri için sandbox önekli test kimlik bilgileri kullanılabilir; üretim ortamında önek olmadan gerçek kimlik bilgileri gerekir. Adım adım kurulum için MaviBot'un Iyzico entegrasyon dokümantasyonuna bakabilirsiniz.

Bağlandıktan sonra ödeme butonu, MaviBot'ta oluşturduğunuz her sohbet akışında kullanılabilir hale gelir. MaviBot'u ücretsiz deneyin ve ilk ödeme akışınızı bugün kurun.

Türkiye'de kullanım senaryoları

E-ticaret. Müşteri WhatsApp üzerinden sipariş oluşturur, kimlik bilgilerini paylaşır ve ödemeyi Iyzico sayfasında tamamlar, sonra bot siparişi onaylar. Detaylı kurulum için web sitesi olmadan WhatsApp ile satış yapma rehberine göz atabilirsiniz.

Online kurslar ve dijital ürünler. Öğrenci sohbet sırasında satın almaya karar verir, ödeme tamamlandığında erişim otomatik olarak açılır. Koçlar ve eğitimciler için satış ve öğrenci desteğini otomatikleştirme rehberi bu senaryoyu daha ayrıntılı anlatıyor.

Randevu bazlı hizmetler (salon, klinik, stüdyo). Müşteri randevu alır ve kapora ya da toplam tutarı aynı sohbette öder, ayrı bir siteye gitmesi gerekmez.

Üç senaryoda da mantık aynı: ödeme sohbetin bir parçası, sohbetten çıkış noktası değil.

Bilinmesi gereken sınırlamalar

• Ödeme linkinin süresi dolmuyor, yapılandırılabilir bir geçerlilik süresi parametresi yok.
• Dönen sonuç ikili: başarılı ya da başarısız. Bekleyen ya da iade gibi ara durumlar belgelenmemiş.
• Ödeme ekranındaki yöntemleri Iyzico belirliyor, MaviBot değil, hangi ülke ve para birimi için hangi seçeneklerin çıkacağı dahil.
• Link oluşturmak için müşterinin kimlik numarası zorunlu, bu bilgi olmadan istek hata döner.

Bu sınırlamaların hiçbiri entegrasyonun kullanılmasını engellemiyor, sadece kurulumdan önce neyin planlanması gerektiğini gösteriyor.

Sıkça sorulan sorular

Kimlik numarası zorunlu mu?

Evet. Iyzico, MASAK düzenlemeleri gereği ödeme linkinin oluşturulması için müşterinin kimlik numarasını (yabancılar için pasaport numarasını) zorunlu tutuyor. Bu bilgi olmadan link oluşturma isteği hata döner.

WhatsApp'tan çıkmadan ödeme yapılabilir mi?

Hayır. Müşteri, ödemeyi tamamlamak için Iyzico'nun kendi sayfasına yönlendirilir. WhatsApp içinde gerçekleşen kısım, linkin oluşturulması ve dönen sonuca bot'un otomatik olarak yanıt vermesidir.

Ödeme başarısız olursa ne olur?

MaviBot başarısız durumunu alır ve bot buna göre sohbete devam edebilir.

Kurulum için kod bilmek gerekiyor mu?

Hayır. Kurulum Iyzico Merchant Panel ve MaviBot'un ödeme ayarları üzerinden yapılır, kod yazmaya gerek yoktur.

WhatsApp'ta Iyzico ile ödeme almaya başlayın

Ödemeyi sohbetin içinde tutmak müşteriyi kaybetme riskini azaltır, kimlik numarası gereksinimini önceden bilmek de kurulum sırasında sürpriz yaşamanızı engeller.

Kurulumu görmek isterseniz MaviBot'u ücretsiz deneyebilirsiniz.