Sanal para birimi hızlı başlangıç

Ana makale: Sanal para birimleri

Bu hızlı başlangıç kılavuzu, bir token para birimini uçtan uca kurar: bir abonelik kullanıcılara ayda 1000 token verir ve uygulamanızdaki ücretli işlemler token harcar. Adapty her bakiyeyi takip eder, bu sayede backend’iniz yalnızca bunları okur ve harcar.

TOKENS para birimi oluşturmak için Sanal para birimi oluşturma kılavuzunu izleyin. Bunu Pro aboneliğinize bağlayın ve Credit per cycle değerini 1000 olarak ayarlayın. Ekstra token satmak için tek seferlik token paketi ürünlerini de bağlayın.
Oluşturma işlemi başlatılmadan önce kullanıcının bakiyesini okumak için Sanal para birimi bakiyelerini listele çağrısını yapın:

   curl https://api.adapty.io/api/v2/server-side-api/vc/balances/ \
     -H "Authorization: Api-Key {your secret key}" \
     -H "adapty-customer-user-id: user-42"

Yanıt, kullanıcının sahip olduğu her para birimini listeler; örneğin 1000 TOKENS:

   {
     "data": [
       { "code": "TOKENS", "name": "Tokens", "balance": 1000, "held": 0, "available": 1000 }
     ]
   }

Kullanıcı bir üretim işlemi başlattığında, Sanal para birimi işlemi oluştur çağrısını negatif bir amount değeriyle yaparak token’ları harcayın. Bu örnekte, bir görsel üretimi 100 token’a mal olmaktadır:

curl -X POST https://api.adapty.io/api/v2/server-side-api/vc/transactions/ \
  -H "Authorization: Api-Key {your secret key}" \
  -H "adapty-customer-user-id: user-42" \
  -H "Content-Type: application/json" \
  -d '{"items": [{"currency_code": "TOKENS", "amount": -100}]}'

İşlem atomiktir ve güncellenmiş bakiyeyi döndürür. Kullanıcı maliyeti karşılayamazsa istek insufficient_balance döndürür ve hiçbir şey değişmez. İstekleri güvenle yeniden denemek için Idempotency-Key başlığı ekleyin. 4. Geri kazanma promosyonu düzenlemek için aynı uç noktaya pozitif bir amount ile token verin. Bu şekilde verdiğiniz krediler hiç sona ermez. Kullanıcılara ilk satın almalarından önce bakiye vermek için Başlangıç bakiyesi ver bölümüne bakın. 5. Ekonomiyi istediğiniz zaman denetleyebilmek için kullanıcının profilindeki her değişikliği veya işlem geçmişini inceleyin.