digital_femsa 1.0.0 → 1.1.0

data/lib/digital_femsa/api/api_keys_api.rb

@@ -19,8 +19,8 @@ module DigitalFemsa
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
-    # Create Api Key
-    # Create a api key
+    # Create API key
+    # Creates a new API key.  The response includes an `authentication_token` that is shown only once (at creation time). Copy and store it securely. 
     # @param api_key_request [ApiKeyRequest] requested field for a api keys
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
@@ -31,8 +31,8 @@ module DigitalFemsa
       data
     end
 
-    # Create Api Key
-    # Create a api key
+    # Create API key
+    # Creates a new API key.  The response includes an `authentication_token` that is shown only once (at creation time). Copy and store it securely. 
     # @param api_key_request [ApiKeyRequest] requested field for a api keys
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
@@ -240,8 +240,8 @@ module DigitalFemsa
       return data, status_code, headers
     end
 
-    # Get list of Api Keys
-    # Consume the list of api keys you have
+    # List API keys
+    # Retrieves a paginated list of API keys for the authenticated account.  Use the pagination parameters (`limit`, `next_page`, `previous_page`) to navigate through results. Use the `search` query parameter to perform a general search (for example by key `id` or description). 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
     # @option opts [String] :x_child_company_id In the case of a holding company, the company id of the child company to which will process the request.
@@ -255,8 +255,8 @@ module DigitalFemsa
       data
     end
 
-    # Get list of Api Keys
-    # Consume the list of api keys you have
+    # List API keys
+    # Retrieves a paginated list of API keys for the authenticated account.  Use the pagination parameters (`limit`, `next_page`, `previous_page`) to navigate through results. Use the `search` query parameter to perform a general search (for example by key `id` or description). 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
     # @option opts [String] :x_child_company_id In the case of a holding company, the company id of the child company to which will process the request.

data/lib/digital_femsa/api/balances_api.rb

@@ -20,7 +20,7 @@ module DigitalFemsa
       @api_client = api_client
     end
     # Get a company's balance
-    # Get a company's balance
+    # Retrieves the current balance information for the authenticated company.  Monetary fields are returned as arrays of amounts grouped by currency. 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
     # @return [BalanceResponse]
@@ -30,7 +30,7 @@ module DigitalFemsa
     end
 
     # Get a company's balance
-    # Get a company's balance
+    # Retrieves the current balance information for the authenticated company.  Monetary fields are returned as arrays of amounts grouped by currency. 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
     # @return [Array<(BalanceResponse, Integer, Hash)>] BalanceResponse data, response status code and response headers

data/lib/digital_femsa/api/charges_api.rb

@@ -19,28 +19,30 @@ module DigitalFemsa
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
-    # Get A List of Charges
+    # List charges
+    # Retrieves a paginated list of charges for the authenticated account.  Use the pagination parameters (`limit`, `next_page`, `previous_page`) to navigate through results. Use `search` to filter charges (for example by id or reference). 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
     # @option opts [String] :x_child_company_id In the case of a holding company, the company id of the child company to which will process the request.
     # @option opts [Integer] :limit The numbers of items to return, the maximum value is 250 (default to 20)
-    # @option opts [String] :search General order search, e.g. by mail, reference etc.
     # @option opts [String] :_next next page
     # @option opts [String] :previous previous page
+    # @option opts [String] :search General order search, e.g. by mail, reference etc.
     # @return [GetChargesResponse]
     def get_charges(opts = {})
       data, _status_code, _headers = get_charges_with_http_info(opts)
       data
     end
 
-    # Get A List of Charges
+    # List charges
+    # Retrieves a paginated list of charges for the authenticated account.  Use the pagination parameters (`limit`, `next_page`, `previous_page`) to navigate through results. Use `search` to filter charges (for example by id or reference). 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
     # @option opts [String] :x_child_company_id In the case of a holding company, the company id of the child company to which will process the request.
     # @option opts [Integer] :limit The numbers of items to return, the maximum value is 250 (default to 20)
-    # @option opts [String] :search General order search, e.g. by mail, reference etc.
     # @option opts [String] :_next next page
     # @option opts [String] :previous previous page
+    # @option opts [String] :search General order search, e.g. by mail, reference etc.
     # @return [Array<(GetChargesResponse, Integer, Hash)>] GetChargesResponse data, response status code and response headers
     def get_charges_with_http_info(opts = {})
       if @api_client.config.debugging
@@ -64,9 +66,9 @@ module DigitalFemsa
       # query parameters
       query_params = opts[:query_params] || {}
       query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
-      query_params[:'search'] = opts[:'search'] if !opts[:'search'].nil?
       query_params[:'next'] = opts[:'_next'] if !opts[:'_next'].nil?
       query_params[:'previous'] = opts[:'previous'] if !opts[:'previous'].nil?
+      query_params[:'search'] = opts[:'search'] if !opts[:'search'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -104,8 +106,8 @@ module DigitalFemsa
       return data, status_code, headers
     end
 
-    # Create charge
-    # Create charge for an existing orden
+    # Create a charge for an order
+    # Creates a new charge associated with an existing order.  Notes: - The charge is created for the order identified by the path parameter `id`. - Depending on the payment method, the charge may be created in a non-final status (for example, pending). - If the order does not meet the required conditions, the API may respond with **428 Precondition Required**. 
     # @param id [String] Identifier of the resource
     # @param charge_request [ChargeRequest] requested field for a charge
     # @param [Hash] opts the optional parameters
@@ -117,8 +119,8 @@ module DigitalFemsa
       data
     end
 
-    # Create charge
-    # Create charge for an existing orden
+    # Create a charge for an order
+    # Creates a new charge associated with an existing order.  Notes: - The charge is created for the order identified by the path parameter &#x60;id&#x60;. - Depending on the payment method, the charge may be created in a non-final status (for example, pending). - If the order does not meet the required conditions, the API may respond with **428 Precondition Required**. 
     # @param id [String] Identifier of the resource
     # @param charge_request [ChargeRequest] requested field for a charge
     # @param [Hash] opts the optional parameters
@@ -189,6 +191,7 @@ module DigitalFemsa
     end
 
     # Update a charge
+    # Updates an existing charge. Only `reference_id` can be updated.
     # @param id [String] Identifier of the resource
     # @param charge_update_request [ChargeUpdateRequest] requested field for update a charge
     # @param [Hash] opts the optional parameters
@@ -201,6 +204,7 @@ module DigitalFemsa
     end
 
     # Update a charge
+    # Updates an existing charge. Only &#x60;reference_id&#x60; can be updated.
     # @param id [String] Identifier of the resource
     # @param charge_update_request [ChargeUpdateRequest] requested field for update a charge
     # @param [Hash] opts the optional parameters

data/lib/digital_femsa/api/customers_api.rb

@@ -19,8 +19,8 @@ module DigitalFemsa
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
-    # Create customer
-    # The purpose of business is to create and keep a customer, you will learn what elements you need to create a customer. 
+    # Create a customer
+    # Creates a new customer for the authenticated company.  Use customers to store and reuse buyer information (for example name, email, phone, and addresses). The created customer can be referenced later when creating orders and other resources. 
     # @param customer [Customer] requested field for customer
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
@@ -31,8 +31,8 @@ module DigitalFemsa
       data
     end
 
-    # Create customer
-    # The purpose of business is to create and keep a customer, you will learn what elements you need to create a customer. 
+    # Create a customer
+    # Creates a new customer for the authenticated company.  Use customers to store and reuse buyer information (for example name, email, phone, and addresses). The created customer can be referenced later when creating orders and other resources. 
     # @param customer [Customer] requested field for customer
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
@@ -98,7 +98,7 @@ module DigitalFemsa
     end
 
     # Create Fiscal Entity
-    # Create Fiscal entity resource that corresponds to a customer ID.
+    # Create a fiscal entity resource for a given customer ID.
     # @param id [String] Identifier of the resource
     # @param customer_fiscal_entities_request [CustomerFiscalEntitiesRequest] requested field for customer fiscal entities
     # @param [Hash] opts the optional parameters
@@ -111,7 +111,7 @@ module DigitalFemsa
     end
 
     # Create Fiscal Entity
-    # Create Fiscal entity resource that corresponds to a customer ID.
+    # Create a fiscal entity resource for a given customer ID.
     # @param id [String] Identifier of the resource
     # @param customer_fiscal_entities_request [CustomerFiscalEntitiesRequest] requested field for customer fiscal entities
     # @param [Hash] opts the optional parameters
@@ -328,7 +328,7 @@ module DigitalFemsa
     end
 
     # Get a list of customers
-    # The purpose of business is to create and maintain a client, you will learn what elements you need to obtain a list of clients, which can be paged.
+    # Returns a paginated list of customers for the authenticated company.  Use the [search] parameter to filter results. 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
     # @option opts [String] :x_child_company_id In the case of a holding company, the company id of the child company to which will process the request.
@@ -343,7 +343,7 @@ module DigitalFemsa
     end
 
     # Get a list of customers
-    # The purpose of business is to create and maintain a client, you will learn what elements you need to obtain a list of clients, which can be paged.
+    # Returns a paginated list of customers for the authenticated company.  Use the [search] parameter to filter results. 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
     # @option opts [String] :x_child_company_id In the case of a holding company, the company id of the child company to which will process the request.
@@ -498,11 +498,11 @@ module DigitalFemsa
       return data, status_code, headers
     end
 
-    # Update  Fiscal Entity
+    # Update Fiscal Entity
     # Update Fiscal Entity resource that corresponds to a customer ID.
     # @param id [String] Identifier of the resource
     # @param fiscal_entities_id [String] identifier
-    # @param customer_update_fiscal_entities_request [CustomerUpdateFiscalEntitiesRequest] requested field for customer update fiscal entities
+    # @param customer_update_fiscal_entities_request [CustomerUpdateFiscalEntitiesRequest] Request body for updating a customer fiscal entity.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
     # @option opts [String] :x_child_company_id In the case of a holding company, the company id of the child company to which will process the request.
@@ -512,11 +512,11 @@ module DigitalFemsa
       data
     end
 
-    # Update  Fiscal Entity
+    # Update Fiscal Entity
     # Update Fiscal Entity resource that corresponds to a customer ID.
     # @param id [String] Identifier of the resource
     # @param fiscal_entities_id [String] identifier
-    # @param customer_update_fiscal_entities_request [CustomerUpdateFiscalEntitiesRequest] requested field for customer update fiscal entities
+    # @param customer_update_fiscal_entities_request [CustomerUpdateFiscalEntitiesRequest] Request body for updating a customer fiscal entity.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
     # @option opts [String] :x_child_company_id In the case of a holding company, the company id of the child company to which will process the request.

data/lib/digital_femsa/api/discounts_api.rb

@@ -20,7 +20,7 @@ module DigitalFemsa
       @api_client = api_client
     end
     # Create Discount
-    # Create discount lines for an existing orden
+    # Create discount lines for an existing order
     # @param id [String] Identifier of the resource
     # @param order_discount_lines_request [OrderDiscountLinesRequest] requested field for a discount lines
     # @param [Hash] opts the optional parameters
@@ -33,7 +33,7 @@ module DigitalFemsa
     end
 
     # Create Discount
-    # Create discount lines for an existing orden
+    # Create discount lines for an existing order
     # @param id [String] Identifier of the resource
     # @param order_discount_lines_request [OrderDiscountLinesRequest] requested field for a discount lines
     # @param [Hash] opts the optional parameters
@@ -104,7 +104,7 @@ module DigitalFemsa
     end
 
     # Delete Discount
-    # Delete an existing discount lines for an existing orden
+    # Delete an existing discount line for an existing order
     # @param id [String] Identifier of the resource
     # @param discount_lines_id [String] discount line id identifier
     # @param [Hash] opts the optional parameters
@@ -117,7 +117,7 @@ module DigitalFemsa
     end
 
     # Delete Discount
-    # Delete an existing discount lines for an existing orden
+    # Delete an existing discount line for an existing order
     # @param id [String] Identifier of the resource
     # @param discount_lines_id [String] discount line id identifier
     # @param [Hash] opts the optional parameters
@@ -183,7 +183,7 @@ module DigitalFemsa
     end
 
     # Get Discount
-    # Get an existing discount lines for an existing orden
+    # Get an existing discount line for an existing order
     # @param id [String] Identifier of the resource
     # @param discount_lines_id [String] discount line id identifier
     # @param [Hash] opts the optional parameters
@@ -196,7 +196,7 @@ module DigitalFemsa
     end
 
     # Get Discount
-    # Get an existing discount lines for an existing orden
+    # Get an existing discount line for an existing order
     # @param id [String] Identifier of the resource
     # @param discount_lines_id [String] discount line id identifier
     # @param [Hash] opts the optional parameters
@@ -261,8 +261,8 @@ module DigitalFemsa
       return data, status_code, headers
     end
 
-    # Get a List of Discount
-    # Get discount lines for an existing orden
+    # Get a List of Discounts
+    # Get discount lines for an existing order
     # @param id [String] Identifier of the resource
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
@@ -277,8 +277,8 @@ module DigitalFemsa
       data
     end
 
-    # Get a List of Discount
-    # Get discount lines for an existing orden
+    # Get a List of Discounts
+    # Get discount lines for an existing order
     # @param id [String] Identifier of the resource
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
@@ -355,7 +355,7 @@ module DigitalFemsa
     end
 
     # Update Discount
-    # Update an existing discount lines for an existing orden
+    # Update an existing discount line for an existing order
     # @param id [String] Identifier of the resource
     # @param discount_lines_id [String] discount line id identifier
     # @param update_order_discount_lines_request [UpdateOrderDiscountLinesRequest] requested field for a discount lines
@@ -369,7 +369,7 @@ module DigitalFemsa
     end
 
     # Update Discount
-    # Update an existing discount lines for an existing orden
+    # Update an existing discount line for an existing order
     # @param id [String] Identifier of the resource
     # @param discount_lines_id [String] discount line id identifier
     # @param update_order_discount_lines_request [UpdateOrderDiscountLinesRequest] requested field for a discount lines

data/lib/digital_femsa/api/events_api.rb

@@ -20,7 +20,7 @@ module DigitalFemsa
       @api_client = api_client
     end
     # Get Event
-    # Returns a single event
+    # Returns a single event by its ID, including its payload (`data`) and webhook delivery information. The `webhook_status` indicates whether webhook notifications were applicable and their overall status. The [webhook_logs]) array contains delivery attempts (it can be empty when webhook notifications are not applicable or no attempts were created). 
     # @param id [String] Identifier of the resource
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
@@ -32,7 +32,7 @@ module DigitalFemsa
     end
 
     # Get Event
-    # Returns a single event
+    # Returns a single event by its ID, including its payload (`data`) and webhook delivery information. The `webhook_status` indicates whether webhook notifications were applicable and their overall status. The [webhook_logs]) array contains delivery attempts (it can be empty when webhook notifications are not applicable or no attempts were created). 
     # @param id [String] Identifier of the resource
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
@@ -178,7 +178,7 @@ module DigitalFemsa
     end
 
     # Resend Event
-    # Try to send an event
+    # Triggers a new delivery attempt for a specific webhook log associated with the given event. Use this endpoint to retry failed webhook deliveries (for example, non-2xx responses or timeouts). The response returns the updated webhook log with the latest attempt metadata. 
     # @param event_id [String] event identifier
     # @param webhook_log_id [String] webhook log identifier
     # @param [Hash] opts the optional parameters
@@ -190,7 +190,7 @@ module DigitalFemsa
     end
 
     # Resend Event
-    # Try to send an event
+    # Triggers a new delivery attempt for a specific webhook log associated with the given event. Use this endpoint to retry failed webhook deliveries (for example, non-2xx responses or timeouts). The response returns the updated webhook log with the latest attempt metadata. 
     # @param event_id [String] event identifier
     # @param webhook_log_id [String] webhook log identifier
     # @param [Hash] opts the optional parameters

data/lib/digital_femsa/api/logs_api.rb

@@ -93,7 +93,7 @@ module DigitalFemsa
     end
 
     # Get List Of Logs
-    # Get log details in the form of a list
+    # Returns a paginated list of logs generated by the platform. Logs can be used for troubleshooting and auditing requests and internal operations. Use pagination parameters to navigate through results, and `search` to filter by supported criteria. 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
     # @option opts [String] :x_child_company_id In the case of a holding company, the company id of the child company to which will process the request.
@@ -108,7 +108,7 @@ module DigitalFemsa
     end
 
     # Get List Of Logs
-    # Get log details in the form of a list
+    # Returns a paginated list of logs generated by the platform. Logs can be used for troubleshooting and auditing requests and internal operations. Use pagination parameters to navigate through results, and `search` to filter by supported criteria. 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
     # @option opts [String] :x_child_company_id In the case of a holding company, the company id of the child company to which will process the request.

data/lib/digital_femsa/api/orders_api.rb

@@ -20,7 +20,7 @@ module DigitalFemsa
       @api_client = api_client
     end
     # Cancel Order
-    # Cancel an order that has been previously created.
+    # Cancels an existing order. This operation marks the order as cancelled and prevents further processing depending on its current state. If the order cannot be cancelled (for example, due to its status or related charge constraints), the API returns an error response.
     # @param id [String] Identifier of the resource
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
@@ -32,7 +32,7 @@ module DigitalFemsa
     end
 
     # Cancel Order
-    # Cancel an order that has been previously created.
+    # Cancels an existing order. This operation marks the order as cancelled and prevents further processing depending on its current state. If the order cannot be cancelled (for example, due to its status or related charge constraints), the API returns an error response.
     # @param id [String] Identifier of the resource
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
@@ -93,7 +93,7 @@ module DigitalFemsa
     end
 
     # Create order
-    # Create a new order.
+    # Creates a new order (products + amounts + customer data).  Minimum required fields: - `currency` - `line_items` - `customer_info`  About `customer_info`: - You can reference an existing customer using `customer_info.customer_id`, or - You can provide customer details at minimum `customer_info.name` and `customer_info.email` to create the order with customer context.  How to create the order: - Create an order only (no payment): send only the order data. - Create an order and create the first payment charge: include `charges`. - Create an order with a checkout configuration (for a hosted payment flow): include `checkout`.  Important rules: - You cannot send `charges` and `checkout` in the same request (they are mutually exclusive). - If you send `shipping_contact_id` and/or `fiscal_entity_id`, you must also send `customer_info.customer_id` so the API can validate those IDs against that customer. 
     # @param order_request [OrderRequest] requested field for order
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
@@ -105,7 +105,7 @@ module DigitalFemsa
     end
 
     # Create order
-    # Create a new order.
+    # Creates a new order (products + amounts + customer data).  Minimum required fields: - `currency` - `line_items` - `customer_info`  About `customer_info`: - You can reference an existing customer using `customer_info.customer_id`, or - You can provide customer details at minimum `customer_info.name` and `customer_info.email` to create the order with customer context.  How to create the order: - Create an order only (no payment): send only the order data. - Create an order and create the first payment charge: include `charges`. - Create an order with a checkout configuration (for a hosted payment flow): include `checkout`.  Important rules: - You cannot send `charges` and `checkout` in the same request (they are mutually exclusive). - If you send `shipping_contact_id` and/or `fiscal_entity_id`, you must also send `customer_info.customer_id` so the API can validate those IDs against that customer. 
     # @param order_request [OrderRequest] requested field for order
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
@@ -171,7 +171,7 @@ module DigitalFemsa
     end
 
     # Get Order
-    # Info for a specific order
+    # Returns the full details of an Order by its ID. The response follows the standard Order representation, including nested previews (for example `charges`, `line_items`, `shipping_lines`, `tax_lines`, and `discount_lines`) when available.
     # @param id [String] Identifier of the resource
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
@@ -183,7 +183,7 @@ module DigitalFemsa
     end
 
     # Get Order
-    # Info for a specific order
+    # Returns the full details of an Order by its ID. The response follows the standard Order representation, including nested previews (for example `charges`, `line_items`, `shipping_lines`, `tax_lines`, and `discount_lines`) when available.
     # @param id [String] Identifier of the resource
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
@@ -244,7 +244,7 @@ module DigitalFemsa
     end
 
     # Get a list of Orders
-    # Get order details in the form of a list
+    # Returns a paginated list of orders created in your account. Use pagination parameters to navigate through results, and `search` to filter by supported criteria. 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
     # @option opts [String] :x_child_company_id In the case of a holding company, the company id of the child company to which will process the request.
@@ -259,7 +259,7 @@ module DigitalFemsa
     end
 
     # Get a list of Orders
-    # Get order details in the form of a list
+    # Returns a paginated list of orders created in your account. Use pagination parameters to navigate through results, and `search` to filter by supported criteria. 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
     # @option opts [String] :x_child_company_id In the case of a holding company, the company id of the child company to which will process the request.
@@ -331,7 +331,7 @@ module DigitalFemsa
     end
 
     # Cancel Refund
-    # A refunded order describes the items, amount, and reason an order is being refunded.
+    # Cancels a refund previously created for an order. This operation is only available when the refund is still cancellable according to its current status and the payment method rules. If the refund cannot be cancelled, the API returns an error response.
     # @param id [String] Identifier of the resource
     # @param refund_id [String] refund identifier
     # @param [Hash] opts the optional parameters
@@ -344,7 +344,7 @@ module DigitalFemsa
     end
 
     # Cancel Refund
-    # A refunded order describes the items, amount, and reason an order is being refunded.
+    # Cancels a refund previously created for an order. This operation is only available when the refund is still cancellable according to its current status and the payment method rules. If the refund cannot be cancelled, the API returns an error response.
     # @param id [String] Identifier of the resource
     # @param refund_id [String] refund identifier
     # @param [Hash] opts the optional parameters
@@ -410,7 +410,7 @@ module DigitalFemsa
     end
 
     # Refund Order
-    # A refunded order describes the items, amount, and reason an order is being refunded.
+    # Creates a refund for an order. This operation is used to refund a previously paid order (fully or partially, depending on the request body). The API will validate the order and its related charges before processing the refund. If the refund cannot be created due to business rules or state, an error response is returned.
     # @param id [String] Identifier of the resource
     # @param order_refund_request [OrderRefundRequest] requested field for a refund
     # @param [Hash] opts the optional parameters
@@ -423,7 +423,7 @@ module DigitalFemsa
     end
 
     # Refund Order
-    # A refunded order describes the items, amount, and reason an order is being refunded.
+    # Creates a refund for an order. This operation is used to refund a previously paid order (fully or partially, depending on the request body). The API will validate the order and its related charges before processing the refund. If the refund cannot be created due to business rules or state, an error response is returned.
     # @param id [String] Identifier of the resource
     # @param order_refund_request [OrderRefundRequest] requested field for a refund
     # @param [Hash] opts the optional parameters
@@ -494,12 +494,12 @@ module DigitalFemsa
     end
 
     # Capture Order
-    # Processes an order that has been previously authorized.
+    # Captures (finalizes) an order that has been previously authorized. Use this endpoint to capture a specific amount. The captured amount must be greater than 0 and must comply with the order and charge constraints enforced by the API.
     # @param id [String] Identifier of the resource
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
     # @option opts [String] :x_child_company_id In the case of a holding company, the company id of the child company to which will process the request.
-    # @option opts [OrderCaptureRequest] :order_capture_request requested fields for capture order
+    # @option opts [OrderCaptureRequest] :order_capture_request Requested fields for capturing an order
     # @return [OrderResponse]
     def orders_create_capture(id, opts = {})
       data, _status_code, _headers = orders_create_capture_with_http_info(id, opts)
@@ -507,12 +507,12 @@ module DigitalFemsa
     end
 
     # Capture Order
-    # Processes an order that has been previously authorized.
+    # Captures (finalizes) an order that has been previously authorized. Use this endpoint to capture a specific amount. The captured amount must be greater than 0 and must comply with the order and charge constraints enforced by the API.
     # @param id [String] Identifier of the resource
     # @param [Hash] opts the optional parameters
     # @option opts [String] :accept_language Use for knowing which language to use (default to 'es')
     # @option opts [String] :x_child_company_id In the case of a holding company, the company id of the child company to which will process the request.
-    # @option opts [OrderCaptureRequest] :order_capture_request requested fields for capture order
+    # @option opts [OrderCaptureRequest] :order_capture_request Requested fields for capturing an order
     # @return [Array<(OrderResponse, Integer, Hash)>] OrderResponse data, response status code and response headers
     def orders_create_capture_with_http_info(id, opts = {})
       if @api_client.config.debugging
@@ -573,8 +573,8 @@ module DigitalFemsa
       return data, status_code, headers
     end
 
-    # Update Order
-    # Update an existing Order.
+    # Update order
+    # Updates an existing order by its ID.  Orders are the central resource in the API. Updating an order may also update related order sub-resources when they are included in the request payload, according to server-side validations.  Only fields supported by the API can be modified. 
     # @param id [String] Identifier of the resource
     # @param order_update_request [OrderUpdateRequest] requested field for an order
     # @param [Hash] opts the optional parameters
@@ -585,8 +585,8 @@ module DigitalFemsa
       data
     end
 
-    # Update Order
-    # Update an existing Order.
+    # Update order
+    # Updates an existing order by its ID.  Orders are the central resource in the API. Updating an order may also update related order sub-resources when they are included in the request payload, according to server-side validations.  Only fields supported by the API can be modified. 
     # @param id [String] Identifier of the resource
     # @param order_update_request [OrderUpdateRequest] requested field for an order
     # @param [Hash] opts the optional parameters