T-SOFT/Admin API/Uygulama ücretleri

Uygulama ücretleri

Uygulamanızın mağazadan istediği tek seferlik ücreti temsil eder. Ücreti oluşturur, mağaza sahibine panelde onaylatır ve ödemenin durumunu buradan okursunuz. Akışın tamamı Faturalama rehberindedir.

Uç noktaMetotKapsam
/integration/app-one-time-chargesGET—
/integration/app-one-time-charges/{id}GET—
/integration/app-one-time-chargesPOST—

Bu uç noktalar kapsam istemez; mağazaya kurulu her uygulamanın token'ı çağırabilir. Uygulama yalnız kendi ücretlerini görür. Uygulama token'ı olmayan istek 403 alır.

Ücret nesnesi

AlanTipAçıklama
idstringÜcretin kimliği (UUID). Salt okunur.
namestringMağaza sahibinin onay ekranında ve ödeme sayfasında gördüğü ad. 1–255 karakter.
pricestringKDV hariç tutar, iki ondalıklı: "49.90".
vatstringKDV tutarı. Uygulama ilanınızdaki KDV oranıyla hesaplanır. Salt okunur.
totalstringMağaza sahibinin ödeyeceği tutar: price + vat. Salt okunur.
currencystringPara birimi: TRY, USD, EUR.
statusstringpending, active, declined, expired, refunded. Salt okunur. Ayrıntı aşağıda.
testbooleanTest ücretiyse true; tahsil edilmez. Varsayılan false.
returnUrlstringMağaza sahibi ücreti onay sayfasından onaylayınca ya da reddedince panelin uygulamanızı açacağı adres. null olabilir.
createdAtdatetimeOluşturulma zamanı. Salt okunur.
approvedAtdatetimeMağaza sahibinin onayladığı zaman. Onaylanmadıysa null. Salt okunur.
activatedAtdatetimeÖdemenin alındığı zaman; test ücretinde onay zamanı. Etkin değilse null. Salt okunur.
declinedAtdatetimeReddedildiği zaman. Reddedilmediyse null. Salt okunur.
refundedAtdatetimeÖdendikten sonra iade edildiği zaman. İade edilmediyse null. Salt okunur.
expiresAtdatetimeOnay ve ödeme için son an: createdAt + 48 saat. Salt okunur.
{
  "type": "app-one-time-charges",
  "id": "0b5f8a52-3c1e-4d7a-9f00-1a2b3c4d5e6f",
  "attributes": {
    "name": "1000 SMS kredisi",
    "price": "49.90",
    "vat": "9.98",
    "total": "59.88",
    "currency": "TRY",
    "status": "active",
    "test": false,
    "returnUrl": "https://sms.example.com/panel/krediler",
    "createdAt": "2026-11-13T10:00:00+03:00",
    "approvedAt": "2026-11-13T10:02:11+03:00",
    "activatedAt": "2026-11-13T10:03:40+03:00",
    "declinedAt": null,
    "refundedAt": null,
    "expiresAt": "2026-11-15T10:00:00+03:00"
  },
  "links": {
    "self": "https://<domain>/api/v3/admin/2026-01/integration/app-one-time-charges/0b5f8a52-3c1e-4d7a-9f00-1a2b3c4d5e6f"
  }
}

status

DeğerAnlamı
pendingMağaza sahibinin onayı ya da ödemesi bekleniyor. Mağaza sahibi onaylayıp ödeme sayfasını açtıysa da ödeme gelene kadar pending kalır; bu durumda approvedAt doludur.
activeÖdeme alındı. Test ücretinde mağaza sahibi onayladı. Hizmeti bu durumda verin.
declinedMağaza sahibi ücreti reddetti.
expiredÜcret expiresAt anına kadar ödenmedi. Yeni bir ücret oluşturmanız gerekir.
refundedÖdeme alındıktan sonra iade edildi (kısmi iade dahil). Verdiğiniz hizmeti geri alın.

Ödeme sayfası açılmış bir ücretin ödemesi süre dolduktan ya da ret sonrası gelirse ücret yine active olur. Durumu her zaman bu uç noktadan okuyun. Durum değişince app_one_time_charge.updated olayı gelir.

returnUrl

https olmalı ve alan adı uygulamanızın app_url adresiyle aynı olmalıdır. Panel, adresin yolunu ve sorgusunu uygulamanızın içinde açar. returnUrl yalnız mağaza sahibi ücreti panelin onay sayfasından onaylayıp reddettiğinde kullanılır; app.billing.confirm ile açılan pencerede sonuç doğrudan uygulamanıza döner.

Ücretleri listeleme

Uygulamanızın bu mağazadaki ücretlerini en yeniden eskiye listeler.

GET /integration/app-one-time-charges
curl 'https://<domain>/api/v3/admin/2026-01/integration/app-one-time-charges' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Accept: application/vnd.api+json'

Parametreler

Yok. Liste sayfalanmaz; en yeni 100 ücret döner. page, filter ve sort gönderirseniz 400 alırsınız.

Yanıt

200 ile ücret nesnelerinden oluşan bir dizi döner (kısaltılmıştır).

{
  "jsonapi": { "version": "1.0" },
  "data": [
    {
      "type": "app-one-time-charges",
      "id": "0b5f8a52-3c1e-4d7a-9f00-1a2b3c4d5e6f",
      "attributes": {
        "name": "1000 SMS kredisi",
        "price": "49.90",
        "vat": "9.98",
        "total": "59.88",
        "currency": "TRY",
        "status": "active",
        "test": false,
        "returnUrl": "https://sms.example.com/panel/krediler",
        "createdAt": "2026-11-13T10:00:00+03:00",
        "approvedAt": "2026-11-13T10:02:11+03:00",
        "activatedAt": "2026-11-13T10:03:40+03:00",
        "declinedAt": null,
        "refundedAt": null,
        "expiresAt": "2026-11-15T10:00:00+03:00"
      },
      "links": {
        "self": "https://<domain>/api/v3/admin/2026-01/integration/app-one-time-charges/0b5f8a52-3c1e-4d7a-9f00-1a2b3c4d5e6f"
      }
    }
  ]
}

Hatalar

Durum koduKodSebep
400—page, filter ya da sort gönderildi

Ücreti getirme

Tek bir ücreti ve güncel durumunu döner.

GET /integration/app-one-time-charges/{id}
curl 'https://<domain>/api/v3/admin/2026-01/integration/app-one-time-charges/0b5f8a52-3c1e-4d7a-9f00-1a2b3c4d5e6f' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Accept: application/vnd.api+json'

Parametreler

ParametreKonumTipZorunluAçıklama
idyolstringEvetÜcretin kimliği

Yanıt

200 ile ücret nesnesi döner.

{
  "jsonapi": { "version": "1.0" },
  "data": {
    "type": "app-one-time-charges",
    "id": "0b5f8a52-3c1e-4d7a-9f00-1a2b3c4d5e6f",
    "attributes": {
      "name": "1000 SMS kredisi",
      "price": "49.90",
      "vat": "9.98",
      "total": "59.88",
      "currency": "TRY",
      "status": "active",
      "test": false,
      "returnUrl": "https://sms.example.com/panel/krediler",
      "createdAt": "2026-11-13T10:00:00+03:00",
      "approvedAt": "2026-11-13T10:02:11+03:00",
      "activatedAt": "2026-11-13T10:03:40+03:00",
      "declinedAt": null,
      "refundedAt": null,
      "expiresAt": "2026-11-15T10:00:00+03:00"
    },
    "links": {
      "self": "https://<domain>/api/v3/admin/2026-01/integration/app-one-time-charges/0b5f8a52-3c1e-4d7a-9f00-1a2b3c4d5e6f"
    }
  }
}

Hatalar

Durum koduKodSebep
404—Ücret yok, başka bir uygulamanın ya da başka bir mağazanın

Ücret oluşturma

Mağazadan tek seferlik ücret ister. Ücret pending durumunda açılır; mağaza sahibi panelde onaylayıp ödeyene kadar tahsil edilmez.

POST /integration/app-one-time-charges
curl -X POST 'https://<domain>/api/v3/admin/2026-01/integration/app-one-time-charges' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Content-Type: application/vnd.api+json' \
  -d '{
    "data": {
      "type": "app-one-time-charges",
      "attributes": {
        "name": "1000 SMS kredisi",
        "price": "49.90",
        "currency": "TRY",
        "returnUrl": "https://sms.example.com/panel/krediler"
      }
    }
  }'

Parametreler

ParametreKonumTipZorunluAçıklama
namegövdestringEvetÜcretin adı. 1–255 karakter.
pricegövdestring ya da numberEvetKDV hariç tutar. Sıfırdan büyük, en çok iki ondalık, en çok 1000000.
currencygövdestringEvetTRY, USD ya da EUR.
returnUrlgövdestringHayırBkz. returnUrl. En çok 2048 karakter.
testgövdebooleanHayırtrue ise test ücreti açılır; yalnız partner panelinden oluşturduğunuz geliştirme mağazasında kullanılabilir. Varsayılan false.

Yanıt

201 ile oluşturulan ücret nesnesi döner; Location başlığı ücretin adresini taşır.

{
  "jsonapi": { "version": "1.0" },
  "links": {
    "self": "https://<domain>/api/v3/admin/2026-01/integration/app-one-time-charges/0b5f8a52-3c1e-4d7a-9f00-1a2b3c4d5e6f"
  },
  "data": {
    "type": "app-one-time-charges",
    "id": "0b5f8a52-3c1e-4d7a-9f00-1a2b3c4d5e6f",
    "attributes": {
      "name": "1000 SMS kredisi",
      "price": "49.90",
      "vat": "9.98",
      "total": "59.88",
      "currency": "TRY",
      "status": "pending",
      "test": false,
      "returnUrl": "https://sms.example.com/panel/krediler",
      "createdAt": "2026-11-13T10:00:00+03:00",
      "approvedAt": null,
      "activatedAt": null,
      "declinedAt": null,
      "refundedAt": null,
      "expiresAt": "2026-11-15T10:00:00+03:00"
    },
    "links": {
      "self": "https://<domain>/api/v3/admin/2026-01/integration/app-one-time-charges/0b5f8a52-3c1e-4d7a-9f00-1a2b3c4d5e6f"
    }
  }
}

Hatalar

Durum koduKodSebep
403app_token_requiredİstek bir uygulama token'ıyla yapılmadı
403test_charge_not_allowedtest: true gönderildi ama mağaza partner panelinden oluşturduğunuz bir geliştirme mağazası değil
422return_url_not_allowedreturnUrl https değil ya da alan adı uygulamanızın app_url adresiyle aynı değil
422—Alan doğrulaması başarısız; source.pointer alanı gösterir
503checkout_disabledÜcretli satış geçici olarak kapalı. Test ücreti bundan etkilenmez.