1. Vakıf Katılım Sanal POS Başvurusu
Entegrasyon işlemine başlamadan önce Vakıf Katılım üzerinden Sanal POS başvurunuzu tamamlamanız gerekmektedir.
Başvurunuzun kabul edilmesinin ardından banka tarafından aşağıdaki bilgiler tarafınıza iletilir:
- Müşteri Numarası (CustomerId): Banka tarafından tanımlanan müşteri numarası.
- Mağaza Numarası (MerchantID): Sanal POS mağaza numarası.
- Kullanıcı Bilgileri: Yönetim paneline erişmek için gönderilen kullanıcı adı.
- Şifre: Yönetim paneline giriş için kayıtlı cep telefonunuza SMS ile gönderilen şifre.
2. Vakıf Katılım Sanal POS Yönetim Paneline Giriş
Banka tarafından iletilen bilgilerle Vakıf Katılım Sanal POS yönetim paneline giriş yapabilirsiniz.
Yönetim Paneli: https://kurumsal.vakifkatilim.com.tr/Login/CorporateInitialLogin
Giriş ekranında aşağıdaki bilgileri kullanın:
- Müşteri No: Banka tarafından e-posta ile iletilen müşteri numarası.
- Kullanıcı Adı: Banka tarafından e-posta ile iletilen kullanıcı adı.
- Şifre: Kayıtlı cep telefonunuza SMS ile gönderilen şifre.
İlk girişinizde yeni bir şifre belirlemeniz istenecektir. Şifrenizi oluşturduktan sonra yönetim paneline erişebilirsiniz.
3. API Kullanıcısı Oluşturma
Payfoni ile entegrasyonun gerçekleştirilebilmesi için Vakıf Katılım yönetim panelinden API kullanıcısı oluşturmanız gerekmektedir.
İşlem Yolu: Tüm İşlemler > Yönetim > Yeni Kullanıcı Ekle
Açılan ekranda entegrasyonda kullanılacak API kullanıcısını oluşturun. Kullanıcı adı ve şifre bilgilerini belirledikten sonra API kullanıcısını aktif duruma getirin.
Oluşturduğunuz API kullanıcısına ait aşağıdaki bilgileri entegrasyon sırasında kullanmak üzere kaydedin:
- UserName: Oluşturduğunuz API kullanıcısının adı.
- Password: API kullanıcısı için belirlediğiniz şifre.
Önemli: API kullanıcısı, sanal POS entegrasyonunda kullanılmak üzere oluşturulur. Bu kullanıcı ile Vakıf Katılım yönetim paneline giriş yapılamaz.
4. Payfoni Sanal POS Yapılandırması
Vakıf Katılım üzerinden aldığınız bilgileri Payfoni sistemine tanımlamak için aşağıdaki adımları izleyin.
- Üye Firma Paneli > Uygulamalar > Ödeme Servisleri menüsüne giriş yapın.
- Vakıf Katılım Sanal POS uygulamasını bulun.
- Uygulamayı Aktifleştir seçeneğine tıklayın.
- Yapılandırma alanını açarak banka tarafından sağlanan bilgileri ilgili alanlara girin.
Tanımlanması Gereken Bilgiler:
- Müşteri Numarası (CustomerId): Vakıf Katılım tarafından verilen müşteri numarası.
- Mağaza Numarası (MerchantID): Vakıf Katılım tarafından verilen mağaza numarası.
- API Kullanıcı Adı (UserName): Yönetim panelinde oluşturduğunuz API kullanıcısının adı.
- API Şifresi (Password): Oluşturduğunuz API kullanıcısının şifresi.
Gerekli bilgileri eksiksiz ve doğru şekilde girdikten sonra yapılandırma ayarlarını kaydedin.
5. Entegrasyon ve Önemli Teknik Bilgiler
Vakıf Katılım Sanal POS entegrasyonunda aşağıdaki teknik detaylara dikkat edilmelidir:
- 3D Secure Adresi: 3D Secure entegrasyonu için
https://boa.vakifkatilim.com.tr/VirtualPOS.Gatewayadresi kullanılmalıdır. - StoreKey: 3D Secure işlemleri için ayrıca 3D StoreKey oluşturulmasına gerek yoktur. API kullanıcısının oluşturulması yeterlidir.
- Para Birimi: Sanal POS üzerinden gerçekleştirilen işlemler TL cinsinden yapılmaktadır.
- Tutar Formatı: XML içerisinde gönderilen Amount değeri virgül veya nokta içermemelidir. Tutar 100 ile çarpılarak gönderilmelidir. Örneğin 10 TL için Amount değeri 1000 olmalıdır.
- 3D Secure İşlemleri: 3D Secure işlemlerinde
TransactionSecurity = 3, 3D Secure kullanılmayan işlemlerde iseTransactionSecurity = 1değeri gönderilmelidir. - IP Tanımlaması:
PosMerchantIPErrorhatası alınması durumunda sunucu IP adresinizin banka tarafından tanımlanması gerekir.
6. Entegrasyonun Kontrol Edilmesi
Yapılandırmanın geçerli olması için verilerin sisteme işlenmesi şarttır.
- Son Adım: Tüm ayarları bitirdiğinizde sağ alt köşede bulunan "Kaydet" butonuna tıklayın.
Doğrulama: Ekranın üst kısmında "İşlem Başarılı" uyarısını görmeniz, ayarlarınızın sorunsuz kaydedildiği ve Vakıf Katılım entegrasyonunuzun hazır olduğu anlamına gelir.