Ürün & Teknik Akış

Marsneo Gift Card API, işletmelerin hediye kartlarını programatik olarak yönetmesine olanak sağlar.

Ürün Akışı

Mars Gift Card, kullanıcının Mars App’te sahip olduğu hediye çeklerini kasada hızlı ve güvenli şekilde kullanabilmesini sağlar. Ödeme, süreli ve tek kullanımlık kod veya QR üzerinden gerçekleştirilir.

1. Kullanıcı Mars App ana ekranından MARS Gift Card alanına girer.

2. Kullanıcı, sahip olduğu geçerli kuponları listeden görüntüler.

3. Kullanmak istediği kupon için “Şimdi Kullan” butonuna basar.

4. Uygulama, kupona özel süreli ve tek kullanımlık bir kod / QR üretir.

5. Kullanıcı bu kodu kasada:

   • Kasiyere söyler veya

   • QR kodu okutulacak şekilde gösterir.

6. Kasa sistemi kodu doğrular ve ödeme tutarı kupon bakiyesinden düşülür.

7. Ödeme tamamlandığında:

   • Kupon bakiyesi güncellenir

   • İşlem, kuponun harcama geçmişine eklenir.

Süresi dolan veya kullanılan kodlar tekrar kullanılamaz. Süre dolması durumunda kullanıcı yeni bir kod üretebilir.

Akış Diyagramı

Teknik Akış

Gift Card ödeme süreci, kupona bağlı bakiyenin güvenli, süreli ve tek kullanımlık bir ödeme anahtarı üzerinden harcanması prensibiyle çalışır. Sistem; aynı kuponun eş zamanlı veya tekrar kullanılmasını engelleyecek şekilde tasarlanmıştır.

1. Kullanıcı uygulama üzerinden “Şimdi Kullan” aksiyonunu başlattığında, sistem kupona bağlı tek kullanımlık ve süreli bir işlem anahtarı üretir.

2. Bu anahtar:

   • Belirli bir süre boyunca geçerlidir

   • Aynı anda yalnızca bir aktif anahtar olacak şekilde yönetilir

   • Süresi dolduğunda otomatik olarak geçersiz hale gelir

3. Kasa sistemi, kullanıcıdan aldığı kod veya QR bilgisini Mars sistemlerine ileterek ödeme doğrulaması talep eder.

4. Mars sistemleri ödeme sırasında:

   • Anahtarın geçerliliğini

   • Süresinin dolup dolmadığını

   • Daha önce kullanılıp kullanılmadığını

   • Kupon bakiyesinin yeterli olup olmadığını kontrol eder.

5. Kontrollerin tamamı başarılıysa:

   • Ödeme tutarı kupon bakiyesinden düşülür

   • İşlem kaydı oluşturulur

   • Kullanılan anahtar anında geçersiz kılınır

6. Ödeme sonucu, kasa sistemine senkron olarak iletilir ve kullanıcı uygulamasında bakiye ile harcama geçmişi güncellenir.

7. Ödeme sonrası süreçlerde:

   • İade talepleri, orijinal işlem referansı üzerinden yönetilir

   • Gün sonu mutabakat işlemleri, gerçekleşen işlemler üzerinden raporlanır

^{_{© 2026 MARS Finansal Yazılım A.Ş. Tüm hakları saklıdır. Bu dokümanın izinsiz kopyalanması, çoğaltılması veya dağıtılması yasaktır.}}