POST /api/v2/server-side-api/purchase/set/transaction/

İşlem kaydet

Adapty'de uygulamanızın bir son kullanıcısı için yeni bir işlem oluşturur ve access level sağlar. Bu yöntemle oluşturulan işlem analizlerinizde ve Event Feed'de görünecek ve tüm entegrasyonlara gönderilecektir.

Header parameters

adapty-customer-user-idstring

Sisteminizdeki müşterinin benzersiz kimliği. adapty-customer-user-id veya adapty-profile-id alanlarından biri zorunludur.

adapty-profile-idstring

Sisteminizdeki profilin benzersiz kimliği. Anonim profiller ile çalışıyorsanız en iyi seçenektir. adapty-customer-user-id veya adapty-profile-id alanlarından biri zorunludur.

Request body

Option 1 — object

Tek seferlik satın alma için işlem verisi

purchase_typestringrequired

Satın alma türü

One of: "one_time_purchase"

storestringrequired

Satın alımın yapıldığı mağaza. Yaygın değerler arasında app_store, play_store, stripe, paddle veya herhangi bir özel mağaza tanımlayıcısı bulunur

environmentstring

Satın alımın yapıldığı ortam

One of: "Production", "Sandbox"

store_product_idstringrequired

Mağazadaki ürün kimliği

store_transaction_idstringrequired

Mağazadaki işlem kimliği

store_original_transaction_idstringrequired

Mağazadaki orijinal işlem kimliği

is_family_sharedboolean

Satın alımın aile paylaşımında olup olmadığı

priceobjectrequired

countrystringrequired

Ülke kodu

currencystringrequired

Para birimi kodu

valuenumberrequired

Fiyat değeri

purchased_atstringrequired

Satın alımın yapıldığı zaman

variation_idstring

A/B testi için varyant kimliği

offerobject

categorystringrequired

Teklif kategorisi

One of: "introductory", "promotional", "offer_code", "win_back"

typestringrequired

Teklif türü

One of: "free_trial", "pay_as_you_go", "pay_up_front"

idstring

Teklif kimliği

refunded_atstring

Satın alımın iade edildiği zaman

cancellation_reasonstring

İptal nedeni

One of: "billing_error", "cancelled_by_developer", "new_subscription_replace", "price_increase", "product_was_not_available", "refund", "unknown", "upgraded", "voluntarily_cancelled", "adapty_revoked"

Option 2 — object

Abonelik satın alma için işlem verisi

purchase_typestringrequired

Satın alma türü

One of: "subscription"

storestringrequired

Satın alımın yapıldığı mağaza. Yaygın değerler arasında app_store, play_store, stripe, paddle veya herhangi bir özel mağaza tanımlayıcısı bulunur

environmentstring

Satın alımın yapıldığı ortam

One of: "Production", "Sandbox"

store_product_idstringrequired

Mağazadaki ürün kimliği

store_transaction_idstringrequired

Mağazadaki işlem kimliği

store_original_transaction_idstringrequired

Mağazadaki orijinal işlem kimliği

is_family_sharedboolean

Satın alımın aile paylaşımında olup olmadığı

priceobjectrequired

countrystringrequired

Ülke kodu

currencystringrequired

Para birimi kodu

valuenumberrequired

Fiyat değeri

purchased_atstringrequired

Satın alımın yapıldığı zaman

variation_idstring

A/B testi için varyant kimliği

offerobject

categorystringrequired

Teklif kategorisi

One of: "introductory", "promotional", "offer_code", "win_back"

typestringrequired

Teklif türü

One of: "free_trial", "pay_as_you_go", "pay_up_front"

idstring

Teklif kimliği

refunded_atstring

Satın alımın iade edildiği zaman

cancellation_reasonstring

İptal nedeni

originally_purchased_atstringrequired

Aboneliğin ilk satın alındığı zaman

expires_atstringrequired

Aboneliğin sona erdiği zaman

renew_statusbooleanrequired

Aboneliğin yenilenip yenilenmeyeceği

renew_status_changed_atstring

Yenileme durumunun değiştiği zaman

billing_issue_detected_atstring

Faturalama sorununun tespit edildiği zaman

grace_period_expires_atstring

Ek sürenin sona erdiği zaman

Responses

İşlem başarıyla kaydedildi

Schema

dataobjectrequired

app_idstringrequired

Uygulamanızın dahili kimliği

profile_idstringrequired

Adapty profil kimliği

customer_user_idstringrequired

Sisteminizdeki kullanıcı kimliğiniz

total_revenue_usdnumberrequired

Profilde kazanılan USD cinsinden toplam geliri temsil eden ondalık değer

segment_hashstringrequired

Dahili parametre

timestampintegerrequired

Milisaniye cinsinden yanıt süresi, bir yarış koşulunu çözmek için gereklidir

custom_attributesarray of objectrequired

Profile en fazla 30 özel özellik ayarlanmasına izin verilir

keystringrequired

Anahtar, 30 karakterden fazla olmayan bir dize olmalıdır. Yalnızca harfler, rakamlar, tireler, noktalar ve alt çizgiler kullanılabilir

valuestring | numberrequired

Özellik değeri 50 karakterden fazla olmamalıdır. Değer olarak yalnızca dizeler ve ondalık sayılara izin verilir

access_levelsarray of objectrequired

Access level nesneleri dizisi. Müşterinin access level'ı yoksa boş dizi döner

access_level_idstring

Access level tanımlayıcısı

storestring

Access level'ın satın alındığı mağaza

store_product_idstring

Mağazadaki ürün kimliği

store_base_plan_idstring

Mağazadaki temel plan kimliği

store_transaction_idstring

Mağazadaki işlem kimliği

store_original_transaction_idstring

Mağazadaki orijinal işlem kimliği

offerallOf

Promosyonel veya tanıtım teklifi uygulandıysa teklif ayrıntıları

categorystring

Teklif kategorisi

One of: "introductory", "promotional", "offer_code", "win_back"

typestring

Teklif türü

One of: "free_trial", "pay_as_you_go", "pay_up_front"

idstring

Teklif kimliği

starts_atstring

Access level'ın başladığı zaman

purchased_atstring

Access level'ın satın alındığı zaman

originally_purchased_atstring

Access level'ın ilk satın alındığı zaman

expires_atstring

Access level'ın sona erdiği zaman

renewal_cancelled_atstring

Yenilemenin iptal edildiği zaman

billing_issue_detected_atstring

Faturalama sorununun tespit edildiği zaman

is_in_grace_periodboolean

Access level'ın ek sürede olup olmadığı

cancellation_reasonstring

İptal nedeni

subscriptionsarray of objectrequired

Abonelik nesneleri dizisi. Müşterinin aboneliği yoksa boş dizi döner

storestring

Aboneliğin satın alındığı mağaza

store_product_idstring

Mağazadaki ürün kimliği

store_base_plan_idstring

Mağazadaki temel plan kimliği

store_transaction_idstring

Mağazadaki işlem kimliği

store_original_transaction_idstring

Mağazadaki orijinal işlem kimliği

offerallOf

Promosyonel veya tanıtım teklifi uygulandıysa teklif ayrıntıları

categorystring

Teklif kategorisi

One of: "introductory", "promotional", "offer_code", "win_back"

typestring

Teklif türü

One of: "free_trial", "pay_as_you_go", "pay_up_front"

idstring

Teklif kimliği

environmentstring

Ortam (Sandbox, Production)

purchased_atstring

Aboneliğin satın alındığı zaman

originally_purchased_atstring

Aboneliğin ilk satın alındığı zaman

expires_atstring

Aboneliğin sona erdiği zaman

renewal_cancelled_atstring

Yenilemenin iptal edildiği zaman

billing_issue_detected_atstring

Faturalama sorununun tespit edildiği zaman

is_in_grace_periodboolean

Aboneliğin ek sürede olup olmadığı

cancellation_reasonstring

İptal nedeni

non_subscriptionsarray of objectrequired

Abonelik dışı nesneler dizisi. Müşterinin satın alımı yoksa boş dizi döner

purchase_idstring

Benzersiz satın alma tanımlayıcısı

storestring

Satın alımın yapıldığı mağaza

store_product_idstring

Mağazadaki ürün kimliği

store_base_plan_idstring

Mağazadaki temel plan kimliği

store_transaction_idstring

Mağazadaki işlem kimliği

store_original_transaction_idstring

Mağazadaki orijinal işlem kimliği

purchased_atstring

Satın alımın yapıldığı zaman

environmentstring

Ortam (Sandbox, Production)

is_refundboolean

Bunun bir iade olup olmadığı

is_consumableboolean

Bunun bir consumable satın alım olup olmadığı

Hatalı istek

Schema

errorsarray of objectrequired

sourcestring

Hatanın kaynağı

errorsarray of string

Hata mesajları dizisi

error_codestringrequired

Kısa hata adı

status_codeintegerrequired

HTTP durum kodu

Yetkisiz

Schema

errorsarray of objectrequired

sourcestring

Hatanın kaynağı

errorsarray of string

Hata mesajları dizisi

error_codestringrequired

Kısa hata adı

status_codeintegerrequired

HTTP durum kodu

Profil bulunamadı

Schema

errorsarray of objectrequired

sourcestring

Hatanın kaynağı

errorsarray of string

Hata mesajları dizisi

error_codestringrequired

Kısa hata adı

status_codeintegerrequired

HTTP durum kodu

Sunucu içi hata

Try it

Authorization

Header parameters

adapty-customer-user-id

adapty-profile-id

Body

curl --request POST \
  --url 'https://api.adapty.io/api/v2/server-side-api/purchase/set/transaction/' \
  --header 'Authorization: Api-Key YOUR_SECRET_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "purchase_type": "one_time_purchase",
    "store": "app_store",
    "environment": "Production",
    "store_product_id": "premium_lifetime",
    "store_transaction_id": "1000000123456789",
    "store_original_transaction_id": "1000000123456789",
    "is_family_shared": false,
    "price": {
      "country": "US",
      "currency": "USD",
      "value": 9.99
    },
    "purchased_at": "2024-01-15T10:30:00Z",
    "variation_id": "variation_123",
    "offer": null,
    "refunded_at": null,
    "cancellation_reason": null
  }'

const response = await fetch('https://api.adapty.io/api/v2/server-side-api/purchase/set/transaction/', {
  method: 'POST',
  headers: {
    'Authorization': 'Api-Key YOUR_SECRET_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "purchase_type": "one_time_purchase",
    "store": "app_store",
    "environment": "Production",
    "store_product_id": "premium_lifetime",
    "store_transaction_id": "1000000123456789",
    "store_original_transaction_id": "1000000123456789",
    "is_family_shared": false,
    "price": {
      "country": "US",
      "currency": "USD",
      "value": 9.99
    },
    "purchased_at": "2024-01-15T10:30:00Z",
    "variation_id": "variation_123",
    "offer": null,
    "refunded_at": null,
    "cancellation_reason": null
  }),
});
const data = await response.json();

import requests

response = requests.post('https://api.adapty.io/api/v2/server-side-api/purchase/set/transaction/', headers={
    'Authorization': 'Api-Key YOUR_SECRET_API_KEY',
    'Content-Type': 'application/json',
}, json={
      "purchase_type": "one_time_purchase",
      "store": "app_store",
      "environment": "Production",
      "store_product_id": "premium_lifetime",
      "store_transaction_id": "1000000123456789",
      "store_original_transaction_id": "1000000123456789",
      "is_family_shared": False,
      "price": {
        "country": "US",
        "currency": "USD",
        "value": 9.99
      },
      "purchased_at": "2024-01-15T10:30:00Z",
      "variation_id": "variation_123",
      "offer": None,
      "refunded_at": None,
      "cancellation_reason": None
    })
data = response.json()