Ürün & Teknik Akış

MARS Pay, işletmelerin tüm ödeme süreçlerini güvenli ve hızlı bir şekilde yönetmesini sağlayan ödeme çözümüdür.

Ürün Akışı

Kullanıcının Mars Pay ödeme süreci boyunca deneyimlediği adımlar.

1. Kullanıcı, İşletmenin Uygulaması üzerinde “Mars ile Öde” butonuna tıklar.

2. Kullanıcı otomatik olarak Mars Pay ödeme akışına yönlendirilir.

3. Eğer Mars mobil uygulaması kullanıcının cihazında yüklü değilse, kullanıcı uygulama mağazasına yönlendirilir ve uygulamayı indirir.

4. Kullanıcı Mars uygulamasına giriş yapar veya yeni kayıt oluşturur.

5. Kullanıcı Mars Pay ekranında ödemeyi tamamlar.

6. Ödeme, kullanıcının Mars hesabındaki bakiye veya Mars uygulamasında tanımlı diğer ödeme yöntemleri ile gerçekleştirilir.

7. Ödeme tamamlandıktan sonra kullanıcı, ödeme sonucuna göre başarılı veya başarısız işlem sonuç ekranına yönlendirilir.

Akış Diyagramı

Mars Pay ödeme sürecinin sistemler arası mimari akış özeti.

Teknik Akış

Mars Pay entegrasyonunda backend ve sistemler arası çağrıların detaylı açıklaması.

1) İşlem Oluşturma (Server-to-Server)

1. İşletme backend, MARS Pay’de işlem oluşturmak için PredefinedMarsPayTransaction endpoint’ine istek atar.

2. Başarılı response beklenir (success = true varsayımıyla).

3. Response içindeki ConversationID, tüm akış boyunca ana referans olarak kullanılacaktır (URL yönlendirme, callback, status sorgusu).

2) Kullanıcı Yönlendirme (Redirect)

1. İşletme, kullanıcıyı aşağıdaki adrese yönlendirir: https://pay.marsneo.com/marspay/{conversationId}/{paymentType}

2. Bu sayfa kullanıcıyı otomatik olarak MARS mobil uygulamasına deeplink ile taşır.

3. Uygulama yoksa Store’a yönlendirme yapılır; kullanıcı kurulum/giriş adımlarını tamamlar.

3) Ödeme (In-App)

1. Kullanıcı MARS uygulaması içindeki “MARS Pay > MARS ile Öde” ekranında ödemeyi tamamlar.

2. Başarılı ödeme sonucunda amount, İşletmenin kurumsal MARS hesabına aktarılır.

4) Sonuç Bildirimi (Callback)

1. MARS, işlem sonucuna göre İşletmenin işlem oluştururken tanımladığı:

   • SuccessCallbackURL veya

   • FailCallbackURL endpoint’ini tetikler (HTTP çağrısı).

Not: Callback “bildirim”dir; güvenli sonuç için İşletme mutlaka aşağıdaki statü kontrolü ile doğrulama yapar.

5) Durum Doğrulama (Status Check)

1. İşletme backend, sonucu doğrulamak için şu endpoint’i çağırır: https://prodapi.marsneo.com/evtpay-admin-api/v1/checkPaymentStatus

2. checkPaymentStatus response’una göre İşletme işlem durumu (başarılı/başarısız/beklemede vb.) ve tutar doğrulaması yapar ve kullanıcıyı kendi UI’ında uygun sonuca yönlendirir.

^{_{© 2025 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.}}