docs(billing): add info about resellers (#1885)

Author: scaleway-bot

packages/clients/src/api/billing/v2beta1/api.gen.ts

@@ -221,9 +221,16 @@ export class API extends ParentAPI {
     )
 
   /**
-   * List discounts. List all discounts for your organization and usable
+   * List discounts. List all discounts for your Organization and usable
    * categories, products, offers, references, regions and zones where the
-   * discount can be applied.
+   * discount can be applied. As a reseller:
+   *
+   * - If you do not specify an `organization_id` you will list the discounts
+   *   applied to your own Organization and your customers
+   * - If you indicate your `organization_id` you will list only the discounts
+   *   applied to your Organization
+   * - If you indicate `the organization_id` of one of your customers, you will
+   *   list the discounts applied to their Organization.
    *
    * @param request - The request {@link ListDiscountsRequest}
    * @returns A Promise of ListDiscountsResponse

packages/clients/src/api/billing/v2beta1/types.gen.ts

@@ -119,7 +119,7 @@ export interface Discount {
   id: string
   /** The creation date of the discount. */
   creationDate?: Date
-  /** The organization ID of the discount. */
+  /** The Organization ID of the discount. */
   organizationId: string
   /** The description of the discount. */
   description: string