API Dokümantasyonu

Mars Pay API dokümantasyonu; tüm entegrasyon endpointlerin detaylı açıklamalarını içerir. Geliştiriciler için örnek istek/yanıtlar ve kullanım rehberi.

Genel Bakış

Bu doküman, Mars Pay ödeme çözümünün tüm entegrasyon adımlarını tek bir çatı altında toplar:

Mars uygulaması üzerinden veya kredi kartı ile direkt ödeme.

Mars Pay ile ödeme akışları ortak API çağrıları üzerinden yürütülür. Detaylı parametreler, endpoint’ler ve kullanım rehberi aşağıda yer almaktadır.

Base URL: https://pay.marsneo.com

API Version: v1.6

Son Güncelleme Tarihi: 10.02.2026

Content-Type: application/json

Desteklenen Diller: Türkçe (tr), İngilizce (en)

---

Genel Akış

Ödeme Akışı – Adımlar

1. Ödeme isteği oluşturma Uygulamanızda “Mars ile Öde” veya “Kart ile Öde” butonuna tıklanınca PredefinedMarsPayTransaction endpoint’ine istek gönderilir. Bu çağrının cevabındaki conversationId, ödeme süreci boyunca takip edilir.

2. Kullanıcı Yönlendirmesi

   • Mars’lı kullanıcı: Kullanıcı cihazında Mars uygulaması varsa otomatik yönlendirilir (paymentType = 1). Yoksa uygulama mağazasına yönlendirilir. Burada kayıt / login sonrası Mars içi ödemeye devam edilir.

   • Mars’lı olmayan kullanıcı: Kullanıcı doğrudan https://pay.marsneo.com/marspay/{{conversationId}}/{{paymentType}} adresine yönlendirilir (paymentType = 0) ve kart bilgilerini bu ekranda girer.

3. Ödeme Sonucu Ödeme başarıyla tamamlandığında işlem sonucu, önceden tanımlanan SuccessCallbackURL veya FailCallbackURL adresine callback ile bildirilir.

4. Durum Sorgulama Ödeme işlemi tamamlanmadan veya callback önce, sonuç checkPaymentStatus endpoint’i ile sorgulanabilir.

API Endpoints

1

Get Token (Login)

Mars Pay API’lerine erişim için yönetici kullanıcıların kimlik doğrulamasını yaparak erişim için gerekli olan AccessToken bilgisini sağlar.

POST: https://prodapi.marsneo.com/evtpay-admin-api/v1/login

//EXAMPLE REQUEST
{
  "username": "username",
  "password": "password"
}

//EXAMPLE RESPONSE
{
  "responseId": "000-1717148012-f2f72c620f9df3fbf23c70689955af9bd6d9",
  "isSuccessful": true,
  "errorCode": 0,
  "message": "Operation is successful!",
  "data": {
    "accessToken": "000-1717148012-\nfe942455bfec4f5769957cb55a74b1d640ad",
    "expireDate": "2024-05-31T10:33:32+0000",
    "adminData": {
      "id": 46,
      "status": 1,
      "role": {
        "id": 6,
        "name": "Administrator ",
        "isSuperadmin": false,
        "auths": {
          "ADMIN_ROLES": [
            "LIST",
            "DELETE",
            "EDIT"
          ],
          "CAMPAIGN_PROMOCODES": [
            "LIST",
            "EDIT",
            "SET_USED"
          ],
          "CONTENT_AND_DEFINITIONS": [
            "DELETE",
            "EDIT",
            "LIST"
          ],
          "TRANSACTIONS": [
            "LIST"
          ],
          "USERS": [
            "SEE_PRIV_DATA",
            "EDIT",
            "LIST"
          ],
          "CAMPAIGNS_AND_COLONIES": [
            "LIST",
            "EDIT",
            "DELETE"
          ],
          "ADMINS": [
            "DELETE",
            "EDIT",
            "LIST"
          ],
          "API_TRANSLATIONS": [
            "LIST",
            "EDIT"
          ],
          "CUSTOMER_ORDERS": [
            "LIST",
            "EDIT_PRIV_DATA"
          ],
          "CUSTOMER_WALLETS": [
            "LIST",
            "EDIT_PRIV_DATA"
          ]
        }
      },
      "msisdn": "905057077007",
      "email": "[email protected]",
      "username": "omer.mars",
      "firstName": "Ömer",
      "middleName": "",
      "lastName": "Imzalı",
      "defaultLang": "en"
    }
  },
  "challenge": null
}

Alınan accessToken, takip eden tüm API çağrılarında header’daki AccessToken={{accessToken}} şeklinde kullanılmalıdır.

2

Token Refresh (refreshAccessToken)

Bu endpoint, süresi dolmak üzere olan veya süresi dolmuş AccessToken’ı yenilemek için kullanılır. Her istek için header’a AccessToken = {{accessToken}} eklenmelidir.

POST: https://prodapi.marsneo.com/evtpay-admin-api/v1/refreshAccessToken

//EXAMPLE REQUEST ?????????
{
  "data": {
    "accessToken": "yeniAccessToken"
  }
}

//EXAMPLE RESPONSE
{
  "responseId": "000-1717148079-209f480d8a211850b8ab0012ba2ff4011088",
  "isSuccessful": true,
  "errorCode": 0,
  "message": "Operation is successful!",
  "data": {
    "accessToken": "000-1717148079-\r\n3afd0c855d9bd92140937de25cc9e919bfb4",
    "expireDate": "2024-05-31T10:34:39+0000",
    "adminData": {
      "id": 46,
      "status": 1,
      "role": {
        "id": 6,
        "name": "Administrator ",
        "isSuperadmin": false,
        "auths": {
          "ADMIN_ROLES": [
            "LIST",
            "DELETE",
            "EDIT"
          ],
          "CAMPAIGN_PROMOCODES": [
            "LIST",
            "EDIT",
            "SET_USED"
          ],
          "CONTENT_AND_DEFINITIONS": [
            "DELETE",
            "EDIT",
            "LIST"
          ],
          "TRANSACTIONS": [
            "LIST",
            "pazarama-mars-pay.md 2024-05-31",
          ],
          "USERS": [
            "SEE_PRIV_DATA",
            "EDIT",
            "LIST"
          ],
          "CAMPAIGNS_AND_COLONIES": [
            "LIST",
            "EDIT",
            "DELETE"
          ],
          "ADMINS": [
            "DELETE",
            "EDIT",
            "LIST"
          ],
          "API_TRANSLATIONS": [
            "LIST",
            "EDIT"
          ],
          "CUSTOMER_ORDERS": [
            "LIST",
            "EDIT_PRIV_DATA"
          ],
          "CUSTOMER_WALLETS": [
            "LIST",
            "EDIT_PRIV_DATA"
          ]
        }
      },
      "msisdn": "905057077007",
      "email": "[email protected]",
      "username": "omer.mars",
      "firstName": "Ömer",
      "middleName": "",
      "lastName": "Imzalı",
      "defaultLang": "en"
    }
  },
  "challenge": null
}

Tüm isteklerde AccessToken header olarak gönderilmelidir.

3

Ödeme Başlatma (PredefinedMarsPayTransaction)

Bu endpoint, Mars Pay ödeme sürecini başlatmak için kullanılır. İstek başarıyla alındığında sistem bir conversationId üretir ve bu değer, kullanıcıyı ödeme ekranına yönlendirmek ve işlemi takip etmek için kullanılır.

POST: https://prodapi.marsneo.com/evtpay-admin-api/v1/predefinedMarsPayTransaction

//EXAMPLE REQUEST
{
    "data": {
        "orderId":"12345678",
        "amount":1,
        "productId":1,
        "corporateId":"TRPX",
        "msisdn":"905511088790"
    }
}

//EXAMPLE RESPONSE
{
    "responseId": "000-1746535947-a3b7eb61cc2714907b39d2db680beb906b84",
    "isSuccessful": true,
    "errorCode": 0,
    "message": "Operation is successful!",
    "data": {
        "conversationId": "000-1746535947-7f1e34fdae4d6aa5b6317cbf90d959dbb5e3"
    },
    "challenge": null
}

Taksit Seçenekleri:

Taksit seçenekleri, installmentOptions parametresi kullanılarak belirlenir. Bu parametre ile kullanıcıya gösterilecek taksit sayıları sınırlandırılabilir.

Kullanım Kuralları

• installmentOptions gönderilmez, null ya da boş dizi ([]) olarak iletilirse:

  • Kartın ve bankanın desteklediği tüm taksit seçenekleri kullanıcıya gösterilir (1, 2, 3, 6, 9, 12 vb.).

• Parametre gönderildiğinde:

  • Yalnızca belirtilen taksit seçenekleri kullanıcıya sunulur.

  • 1 değeri, tek çekim (peşin) anlamına gelir.

installmentOptions	Açıklama
[] / null / gönderilmez	Tüm uygun taksit seçenekleri gösterilir
[1]	Sadece tek çekim (peşin) – taksit kapalı
[1, 3]	Tek çekim ve 3 taksit
[1, 3, 6]	Tek çekim, 3 ve 6 taksit

_{Not: Gönderilen taksit seçenekleri, bankanın ve kartın desteklediği koşullara bağlı olarak değişkenlik gösterebilir. Desteklenmeyen taksit seçenekleri otomatik olarak elenir.}

4

Ödeme Durumu Sorgulama (CheckPaymentStatus)

Bu endpoint, daha önce başlatılmış bir ödemenin durumunu kontrol etmek için kullanılır. Sorgulama, ödeme sürecinde kullanılan conversationId bilgisi ile yapılır.

POST: https://prodapi.marsneo.com/evtpay-admin-api/v1/checkPaymentStatus

Bu işlem, kullanıcının ödeme tamamlandıktan sonra doğru şekilde yönlendirilmesini sağlamak amacıyla ProAccount sisteminde kullanılmalıdır.

//EXAMPLE REQUEST
{
 "data": {
 "conversationId":"{{conversationId}}"
 }
}

//EXAMPLE RESPONSE SUCCESS
{
 "responseId": "000-1717148372-be6c5a2a75f7dbfef87810d8bea91189d32c",
 "isSuccessful": true,
 "errorCode": 0,
 "message": "Operation is successful!",
 "data": {
 "orderDetail": {
 "status": "SUCCESS",
 "orderId": "123456",
 "amount": 1025,
 "finishedDate": {{timestamp}},
 "paymentDate": {{timestamp}},
 },
 "challenge": null
}

//EXAMPLE RESPONSE FAILED
{
 "responseId": "000-1717148372-be6c5a2a75f7dbfef87810d8bea91189d32c",
 "isSuccessful": true,
 "errorCode": 0,
 "message": "Operation is successful!",
 "data": {
 "orderDetail": {
 "status": "FAILED",
 "orderId": "123456",
 "amount": 1025,
 "finishedDate": {{timestamp}},
 "paymentDate": {{timestamp}},
 },
 "challenge": null
}

//EXAMPLE RESPONSE NOTFOUND
{
 "responseId": "000-1717151254-49e6a5af24ea2ad6b923aa617a2e80773400",
 "isSuccessful": false,
 "errorCode": 21,
 "message": "Order not found!",
 "data": null,
 "challenge": null
}

Status Kod Tablosu

Status	Kod	Açıklama
WAITING	0	İşlem beklemede. Henüz tamamlanmadı veya kullanıcı aksiyonu bekleniyor.
FAILED	-1	İşlem başarısız
SUCCESS	1	İşlem başarılı
PARTIAL_REFUNDED	4	kısmi olarak iade edildi.
REFUNDED	5	Tam iade
CANCELLED	6	İptal

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