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ç nokta | Metot | Kapsam |
|---|---|---|
/integration/app-one-time-charges | GET | — |
/integration/app-one-time-charges/{id} | GET | — |
/integration/app-one-time-charges | POST | — |
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
| Alan | Tip | Açıklama |
|---|---|---|
id | string | Ücretin kimliği (UUID). Salt okunur. |
name | string | Mağaza sahibinin onay ekranında ve ödeme sayfasında gördüğü ad. 1–255 karakter. |
price | string | KDV hariç tutar, iki ondalıklı: "49.90". |
vat | string | KDV tutarı. Uygulama ilanınızdaki KDV oranıyla hesaplanır. Salt okunur. |
total | string | Mağaza sahibinin ödeyeceği tutar: price + vat. Salt okunur. |
currency | string | Para birimi: TRY, USD, EUR. |
status | string | pending, active, declined, expired, refunded. Salt okunur. Ayrıntı aşağıda. |
test | boolean | Test ücretiyse true; tahsil edilmez. Varsayılan false. |
returnUrl | string | Mağaza sahibi ücreti onay sayfasından onaylayınca ya da reddedince panelin uygulamanızı açacağı adres. null olabilir. |
createdAt | datetime | Oluşturulma zamanı. Salt okunur. |
approvedAt | datetime | Mağaza sahibinin onayladığı zaman. Onaylanmadıysa null. Salt okunur. |
activatedAt | datetime | Ödemenin alındığı zaman; test ücretinde onay zamanı. Etkin değilse null. Salt okunur. |
declinedAt | datetime | Reddedildiği zaman. Reddedilmediyse null. Salt okunur. |
refundedAt | datetime | Ödendikten sonra iade edildiği zaman. İade edilmediyse null. Salt okunur. |
expiresAt | datetime | Onay 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ğer | Anlamı |
|---|---|
pending | Mağ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. |
declined | Mağ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.
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 kodu | Kod | Sebep |
|---|---|---|
400 | — | page, filter ya da sort gönderildi |
Ücreti getirme
Tek bir ücreti ve güncel durumunu döner.
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
| Parametre | Konum | Tip | Zorunlu | Açıklama |
|---|---|---|---|---|
id | yol | string | Evet | Ü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 kodu | Kod | Sebep |
|---|---|---|
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.
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
| Parametre | Konum | Tip | Zorunlu | Açıklama |
|---|---|---|---|---|
name | gövde | string | Evet | Ücretin adı. 1–255 karakter. |
price | gövde | string ya da number | Evet | KDV hariç tutar. Sıfırdan büyük, en çok iki ondalık, en çok 1000000. |
currency | gövde | string | Evet | TRY, USD ya da EUR. |
returnUrl | gövde | string | Hayır | Bkz. returnUrl. En çok 2048 karakter. |
test | gövde | boolean | Hayır | true 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 kodu | Kod | Sebep |
|---|---|---|
403 | app_token_required | İstek bir uygulama token'ıyla yapılmadı |
403 | test_charge_not_allowed | test: true gönderildi ama mağaza partner panelinden oluşturduğunuz bir geliştirme mağazası değil |
422 | return_url_not_allowed | returnUrl 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 |
503 | checkout_disabled | Ücretli satış geçici olarak kapalı. Test ücreti bundan etkilenmez. |