diff --git a/extension-iap/api/iap.script_api b/extension-iap/api/iap.script_api
index c323c03..e4a1873 100644
--- a/extension-iap/api/iap.script_api
+++ b/extension-iap/api/iap.script_api
@@ -23,6 +23,10 @@
           type: string
           desc: Facebook only. [icon:facebook] Optional custom unique request id to
                 set for this transaction. The id becomes attached to the payment within the Graph API.
+        - name: token
+          type: string
+          desc: [icon:googleplay] Which subscription offer to use when buying a subscription. The token can be retrieved from
+                the subscriptions table returned when calling iap.list()
 
     examples:
       - desc: |-
@@ -128,15 +132,23 @@
         - name: price
           type: number
           desc: The price of the product.
+                [icon:googleplay]: Used only for in-app products
 
         - name: price_string
           type: string
           desc: The price of the product, as a formatted string (amount and currency symbol).
+                [icon:googleplay]: Used only for in-app products
 
         - name: currency_code
           type: string
-          desc: The currency code. On Google Play, this reflects the merchant's locale, instead of the user's.
-                [icon:ios] [icon:googleplay] [icon:facebook]
+          desc: [icon:ios] [icon:googleplay] [icon:facebook] The currency code.
+                [icon:googleplay]: The merchant's locale, instead of the user's
+                [icon:googleplay]: Used only for in-app products
+
+        - name: subscriptions
+          type: table
+          desc: [icon:googleplay] List of subscription offers.
+                Each offer contains a token and a list of price and billing options.
 
       - name: error
         type: table