document payment account and upsell (bug 933370)

docs/api/topics/apps.rst

@@ -142,7 +142,7 @@ App
     :param categories: An array of strings representing the slugs of the
         categories the app belongs to.
     :type categories: array
-    :param content_ratings: An object representing the content ratings 
+    :param content_ratings: An object representing the content ratings
         associated with the app by region. Regions not included in this object
         will use the rating keyed under "generic".
     :type content_ratings: object
@@ -161,7 +161,7 @@ App
         ``desktop``, ``android-mobile``, ``android-tablet``, ``firefoxos``.
     :param homepage: The app's homepage.
     :type homepage: string
-    :param icons: An object containing information about the app icons. The 
+    :param icons: An object containing information about the app icons. The
         keys represent icon sizes, the values the corresponding URLs.
     :type icons: object
     :param id: The app ID.
@@ -172,6 +172,8 @@ App
         app, this will be a minimal manifest generated by the Marketplace.
     :param name: The app name.
     :type name: string
+    :param payment_account: The path to the :ref:`payment account <payment-account-response-label>`
+        being used for this app, or none if not applicable.
     :param payment_required: A payment is required for this app. It
         could be that ``payment_required`` is ``true``, but price is ``null``.
         In this case, the app cannot be bought.
@@ -182,7 +184,7 @@ App
     :type premium_type: string
     :param previews: List containing the preview images for the app.
     :type previews: array
-    :param previews.filetype: The mimetype for the preview. 
+    :param previews.filetype: The mimetype for the preview.
     :type previews.filetype: string
     :param previews.id: The ID of the preview.
     :type previews.id: int
@@ -239,6 +241,8 @@ App
     :param supported_locales: The list of locales (as strings) supported by the
         app, according to what was set by the developer in the manifest.
     :param supported_locales: array
+    :param upsell: The path to the premium app resource that this free app is
+        upselling to, or null if not applicable.
     :param upsold: The path to the free app resource that
         this premium app is an upsell for, or null if not applicable.
     :param user: an object representing information specific to this