Hướng dẫn nhanh về tiền tệ ảo

Bài viết chính: Tiền tệ ảo

Hướng dẫn nhanh này thiết lập một tiền tệ token từ đầu đến cuối: một gói đăng ký cấp cho người dùng 1000 token mỗi tháng, và các hành động có trả phí trong ứng dụng sẽ tốn token. Adapty quản lý toàn bộ số dư, vì vậy backend của bạn chỉ cần đọc và tiêu token.

Làm theo hướng dẫn Tạo tiền tệ ảo để tạo loại tiền tệ TOKENS. Liên kết nó với gói đăng ký Pro và đặt Credit per cycle thành 1000. Để bán thêm token, hãy liên kết thêm các sản phẩm gói token mua một lần.
Gọi Lấy danh sách số dư tiền tệ ảo để đọc số dư của người dùng, ví dụ trước khi bắt đầu một lần tạo nội dung:

   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"

Phản hồi liệt kê tất cả các loại tiền tệ mà người dùng có, ví dụ 1000 TOKENS:

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

Khi người dùng chạy một lần tạo ảnh, hãy trừ token bằng cách gọi Create virtual currency transaction với amount âm. Trong ví dụ này, một lần tạo ảnh tốn 100 token:

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}]}'

Giao dịch có tính nguyên tử và trả về số dư đã cập nhật. Nếu người dùng không đủ số dư để thanh toán, yêu cầu sẽ trả về insufficient_balance và không có gì thay đổi. Hãy thêm header Idempotency-Key để thử lại yêu cầu một cách an toàn. 4. Để chạy ưu đãi thu hút khách hàng cũ, hãy cấp token thông qua cùng endpoint đó với amount dương. Các khoản tín dụng được cấp theo cách này không bao giờ hết hạn. Để cấp số dư cho người dùng trước lần mua đầu tiên của họ, xem Cấp số dư ban đầu. 5. Xem lại mọi thay đổi trong hồ sơ người dùng hoặc trong lịch sử giao dịch, để bạn có thể kiểm tra kinh tế ảo bất cứ lúc nào.