Add KMP VC docs (#1050)

Author: fire-at-will

code_blocks/virtual-currency/vc-balance-sdk-kmp.kt

@@ -0,0 +1,33 @@
+// Fetch virtual currencies
+// With coroutines
+try {
+    val virtualCurrencies: VirtualCurrencies = Purchases.sharedInstance.awaitVirtualCurrencies()
+    // TODO: Handle virtual currencies
+} catch(error: PurchasesException) {
+    // TODO: Handle error
+}
+
+// With callbacks
+Purchases.sharedInstance.getVirtualCurrencies(
+    onError = { error: PurchasesError ->
+        // TODO: Handle error
+    },
+    onSuccess = { virtualCurrencies: VirtualCurrencies ->
+        // TODO: Handle virtual currencies
+    },
+)
+
+// Get the details of a specific virtual currency
+val virtualCurrency = virtualCurrencies.all[<your_virtual_currency_code>]
+val balance = virtualCurrency?.balance
+val name = virtualCurrency?.name
+val code = virtualCurrency?.code
+
+// Keep in mind that serverDescription may be null if no description was provided
+// in the RevenueCat dashboard
+val description = virtualCurrency?.serverDescription
+
+// Iterate through all virtual currencies
+for ((virtualCurrencyCode, virtualCurrency) in virtualCurrencies.all) {
+    println("$virtualCurrencyCode: ${virtualCurrency.balance}")
+}

docs/offerings/virtual-currency.mdx

@@ -101,17 +101,19 @@ import fetchVCBalancesReactNative from "@site/code_blocks/virtual-currency/vc-ba
 import fetchVCBalancesFlutter from "@site/code_blocks/virtual-currency/vc-balance-sdk-flutter.dart?raw";
 import fetchVCBalancesCapacitor from "@site/code_blocks/virtual-currency/virtual-currency-balance-capacitor.ts?raw";
 import fetchVCBalancesUnity from "@site/code_blocks/virtual-currency/vc-balance-unity.cs?raw";
+import fetchVCBalancesKMP from "@site/code_blocks/virtual-currency/vc-balance-sdk-kmp.kt?raw";
 
 Fetching virtual currency balances is supported in the following SDK versions:
 
-| SDK              | Supported Versions |
-| ---------------- | ------------------ |
-| iOS SDK          | 5.32.0+            |
-| Android SDK      | 9.1.0+             |
-| React Native SDK | 9.1.0+             |
-| Flutter SDK      | 9.1.0+             |
-| Capacitor SDK    | 11.1.0+            |
-| Unity SDK        | 8.1.0+             |
+| SDK              | Supported Versions         |
+| ---------------- | -------------------------- |
+| iOS SDK          | 5.32.0+                    |
+| Android SDK      | 9.1.0+                     |
+| React Native SDK | 9.1.0+                     |
+| Flutter SDK      | 9.1.0+                     |
+| Capacitor SDK    | 11.1.0+                    |
+| Unity SDK        | 8.1.0+                     |
+| KMP SDK          | 2.1.0+16.2.0+              |
 
 You can use the `virtualCurrencies()` function to retrieve a customer's balance. The function returns a `VirtualCurrencies` object, which includes the customer's balances along with each virtual currency's metadata.
 
@@ -152,6 +154,11 @@ You can use the `virtualCurrencies()` function to retrieve a customer's balance.
       content: fetchVCBalancesUnity, 
       name: "Unity" 
     },
+    {
+      type: "kotlin",
+      title: "Kotlin Multiplatform",
+      content: fetchVCBalancesKMP,
+    },
   ]}
 />
 
@@ -175,10 +182,6 @@ import cachedVirtualCurrenciesSwift from "@site/code_blocks/virtual-currency/cac
   ]}
 />
 
-##### Hybrid SDK Support
-
-Virtual currency support in the hybrid SDKs is coming soon!
-
 ### Depositing or spending
 
 You can deposit or spend currency by calling the [virtual currency transactions Developer API endpoint](https://www.revenuecat.com/docs/api-v2#tag/Customer/operation/create-virtual-currencies-transaction) from the backend of your app: