digital_femsa 1.0.0 → 1.1.0

data/docs/GetChargesResponse.md

@@ -4,10 +4,10 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **has_more** | **Boolean** | Indicates if there are more pages to be requested |  |
-| **object** | **String** | Object type, in this case is list |  |
 | **next_page_url** | **String** | URL of the next page. | [optional] |
 | **previous_page_url** | **String** | Url of the previous page. | [optional] |
+| **has_more** | **Boolean** | Indicates if there are more pages to be requested |  |
+| **object** | **String** | Object type, in this case is list |  |
 | **data** | [**Array<ChargeResponse>**](ChargeResponse.md) |  | [optional] |
 
 ## Example
@@ -16,10 +16,10 @@
 require 'digital_femsa'
 
 instance = DigitalFemsa::GetChargesResponse.new(
-  has_more: false,
-  object: list,
   next_page_url: https://api.femsa.io/resources?limit=10&next=chrg_1,
   previous_page_url: https://api.femsa.io/resources?limit=10&previous=chrg_1,
+  has_more: false,
+  object: list,
   data: null
 )
 ```

data/docs/GetTransactionsResponse.md

@@ -8,7 +8,7 @@
 | **object** | **String** | Object type, in this case is list |  |
 | **next_page_url** | **String** | URL of the next page. | [optional] |
 | **previous_page_url** | **String** | Url of the previous page. | [optional] |
-| **data** | [**Array<TransactionResponse>**](TransactionResponse.md) | Transactions | [optional] |
+| **data** | [**Array<TransactionResponse>**](TransactionResponse.md) | Transactions (ledger movements) | [optional] |
 
 ## Example
 

data/docs/LogsApi.md

@@ -89,7 +89,7 @@ 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. 
 
 ### Examples
 

data/docs/OrderFiscalEntityRequest.md

@@ -18,11 +18,11 @@ require 'digital_femsa'
 
 instance = DigitalFemsa::OrderFiscalEntityRequest.new(
   address: null,
-  email: test@gmail.com,
+  email: null,
   metadata: null,
-  name: Femsa Inc,
-  phone: +525511223344,
-  tax_id: AAA010101AAA
+  name: null,
+  phone: null,
+  tax_id: null
 )
 ```
 

data/docs/OrderRefundRequest.md

@@ -4,9 +4,10 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **amount** | **Integer** |  |  |
-| **expires_at** | **Integer** |  | [optional] |
-| **reason** | **String** |  |  |
+| **amount** | **Integer** | Amount to refund. If not provided, the API refunds the refundable amount of the selected charge. |  |
+| **charge_id** | **String** | Charge ID to refund. If not provided, the API selects a refundable charge from the order. | [optional] |
+| **reason** | **String** | Refund reason. If not provided, the API uses a default reason. |  |
+| **expires_at** | **Integer** | Expiration timestamp for cash refunds (must be within the allowed range configured by the API). | [optional] |
 
 ## Example
 
@@ -15,8 +16,9 @@ require 'digital_femsa'
 
 instance = DigitalFemsa::OrderRefundRequest.new(
   amount: 500,
-  expires_at: 1553273553,
-  reason: suspected_fraud
+  charge_id: 6976b2e3c4418f00012943c5,
+  reason: suspected_fraud,
+  expires_at: 1553273553
 )
 ```
 

data/docs/OrderRequest.md

@@ -4,20 +4,19 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **charges** | [**Array<ChargeRequest>**](ChargeRequest.md) | List of [charges](https://developers.femsa.com/v2.1.0/reference/orderscreatecharge) that are applied to the order | [optional] |
-| **checkout** | [**CheckoutRequest**](CheckoutRequest.md) |  | [optional] |
-| **currency** | **String** | Currency with which the payment will be made. It uses the 3-letter code of the [International Standard ISO 4217.](https://es.wikipedia.org/wiki/ISO_4217) |  |
+| **currency** | **String** | Currency with which the payment will be made. |  |
 | **customer_info** | [**OrderRequestCustomerInfo**](OrderRequestCustomerInfo.md) |  |  |
-| **discount_lines** | [**Array<OrderDiscountLinesRequest>**](OrderDiscountLinesRequest.md) | List of [discounts](https://developers.femsa.com/v2.1.0/reference/orderscreatediscountline) that are applied to the order. You must have at least one discount. | [optional] |
-| **fiscal_entity** | [**OrderFiscalEntityRequest**](OrderFiscalEntityRequest.md) |  | [optional] |
-| **line_items** | [**Array<Product>**](Product.md) | List of [products](https://developers.femsa.com/v2.1.0/reference/orderscreateproduct) that are sold in the order. You must have at least one product. |  |
-| **metadata** | **Hash<String, Object>** | Metadata associated with the order | [optional] |
+| **line_items** | [**Array<Product>**](Product.md) | List of [products](https://developers.digitalfemsa.io/reference/orderscreateproduct) that are sold in the order. You must have at least one product. |  |
+| **charges** | [**Array<ChargeRequest>**](ChargeRequest.md) | List of [charges](https://developers.digitalfemsa.io/reference/orderscreatecharge) that are applied to the order | [optional] |
+| **checkout** | [**CheckoutRequest**](CheckoutRequest.md) |  | [optional] |
+| **discount_lines** | [**Array<OrderDiscountLinesRequest>**](OrderDiscountLinesRequest.md) | List of [discounts](https://developers.digitalfemsa.io/reference/orderscreatediscountline) that are applied to the order. You must have at least one discount. | [optional] |
+| **tax_lines** | [**Array<OrderTaxRequest>**](OrderTaxRequest.md) | List of [taxes](https://developers.digitalfemsa.io/reference/orderscreatetaxes) that are applied to the order. | [optional] |
 | **needs_shipping_contact** | **Boolean** | Allows you to fill out the shipping information at checkout | [optional] |
-| **processing_mode** | **String** | Indicates the processing mode for the order, either ecommerce, recurrent or validation. | [optional] |
-| **return_url** | **String** | Indicates the redirection callback upon completion of the 3DS2 flow. | [optional] |
 | **shipping_contact** | [**CustomerShippingContacts**](CustomerShippingContacts.md) |  | [optional] |
-| **shipping_lines** | [**Array<ShippingRequest>**](ShippingRequest.md) | List of [shipping costs](https://developers.femsa.com/v2.1.0/reference/orderscreateshipping). If the online store offers digital products. | [optional] |
-| **tax_lines** | [**Array<OrderTaxRequest>**](OrderTaxRequest.md) | List of [taxes](https://developers.femsa.com/v2.1.0/reference/orderscreatetaxes) that are applied to the order. | [optional] |
+| **shipping_lines** | [**Array<ShippingRequest>**](ShippingRequest.md) | List of [shipping costs](https://developers.digitalfemsa.io/reference/orderscreateshipping). If the online store offers digital products. | [optional] |
+| **fiscal_entity** | [**OrderFiscalEntityRequest**](OrderFiscalEntityRequest.md) |  | [optional] |
+| **processing_mode** | **String** | Indicates the processing mode for the order, either ecommerce, recurrent or validation. | [optional] |
+| **metadata** | **Hash<String, Object>** | Arbitrary key-value data that you can attach to the order for your internal use (e.g. `customer_segment`, `sales_channel`, `internal_order_id`). It is not used for payment processing or fraud decisions. Keys should be strings; values can be any JSON value. | [optional] |
 
 ## Example
 
@@ -25,20 +24,19 @@
 require 'digital_femsa'
 
 instance = DigitalFemsa::OrderRequest.new(
-  charges: null,
-  checkout: null,
   currency: MXN,
   customer_info: null,
-  discount_lines: null,
-  fiscal_entity: null,
   line_items: null,
-  metadata: null,
+  charges: null,
+  checkout: null,
+  discount_lines: null,
+  tax_lines: null,
   needs_shipping_contact: false,
-  processing_mode: ecommerce,
-  return_url: https://my-website.com,
   shipping_contact: null,
   shipping_lines: null,
-  tax_lines: null
+  fiscal_entity: null,
+  processing_mode: ecommerce,
+  metadata: null
 )
 ```
 

data/docs/OrderResponse.md

@@ -4,27 +4,28 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **amount** | **Integer** | The total amount to be collected in cents | [optional] |
-| **amount_refunded** | **Integer** | The total amount refunded in cents | [optional] |
-| **channel** | [**ChargeResponseChannel**](ChargeResponseChannel.md) |  | [optional] |
-| **charges** | [**OrderResponseCharges**](OrderResponseCharges.md) |  | [optional] |
-| **checkout** | [**OrderResponseCheckout**](OrderResponseCheckout.md) |  | [optional] |
-| **created_at** | **Integer** | The time at which the object was created in seconds since the Unix epoch | [optional] |
-| **currency** | **String** | The three-letter ISO 4217 currency code. The currency of the order. | [optional] |
+| **id** | **String** |  | [optional] |
+| **object** | **String** |  | [optional] |
+| **livemode** | **Boolean** |  | [optional] |
+| **amount** | **Integer** |  | [optional] |
+| **currency** | **String** |  | [optional] |
+| **payment_status** | **String** | Current payment status of the order. It can be `null` for orders without payment information yet. | [optional] |
+| **amount_refunded** | **Integer** |  | [optional] |
+| **split_payment** | **Boolean** | Indicates whether the order uses split payments (when available/configured). | [optional] |
+| **metadata** | **Hash<String, Object>** | Metadata attached to the order. | [optional] |
+| **is_refundable** | **Boolean** | Indicates whether the order is currently refundable. | [optional] |
+| **created_at** | **Integer** |  | [optional] |
+| **updated_at** | **Integer** |  | [optional] |
 | **customer_info** | [**OrderResponseCustomerInfo**](OrderResponseCustomerInfo.md) |  | [optional] |
-| **discount_lines** | [**OrderResponseDiscountLines**](OrderResponseDiscountLines.md) |  | [optional] |
+| **shipping_contact** | [**OrderResponseShippingContact**](OrderResponseShippingContact.md) |  | [optional] |
+| **channel** | [**OrderResponseChannel**](OrderResponseChannel.md) |  | [optional] |
 | **fiscal_entity** | [**OrderFiscalEntityResponse**](OrderFiscalEntityResponse.md) |  | [optional] |
-| **id** | **String** |  | [optional] |
-| **is_refundable** | **Boolean** |  | [optional] |
+| **checkout** | [**OrderResponseCheckout**](OrderResponseCheckout.md) |  | [optional] |
 | **line_items** | [**OrderResponseProducts**](OrderResponseProducts.md) |  | [optional] |
-| **livemode** | **Boolean** | Whether the object exists in live mode or test mode | [optional] |
-| **metadata** | **Hash<String, Object>** | Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. | [optional] |
-| **next_action** | [**OrderNextActionResponse**](OrderNextActionResponse.md) |  | [optional] |
-| **object** | **String** | String representing the object’s type. Objects of the same type share the same value. | [optional] |
-| **payment_status** | **String** | The payment status of the order. | [optional] |
-| **processing_mode** | **String** | Indicates the processing mode for the order, either ecommerce, recurrent or validation. | [optional] |
-| **shipping_contact** | [**OrderResponseShippingContact**](OrderResponseShippingContact.md) |  | [optional] |
-| **updated_at** | **Integer** | The time at which the object was last updated in seconds since the Unix epoch | [optional] |
+| **discount_lines** | [**OrderResponseDiscountLines**](OrderResponseDiscountLines.md) |  | [optional] |
+| **charges** | [**OrderResponseCharges**](OrderResponseCharges.md) |  | [optional] |
+| **partial_reference** | **Hash<String, Object>** | Partial reference information (when applicable). Structure may vary depending on the payment flow. | [optional] |
+| **payments_info** | **Hash<String, Object>** | Additional payment information (when available). Structure may vary. | [optional] |
 
 ## Example
 
@@ -32,27 +33,28 @@
 require 'digital_femsa'
 
 instance = DigitalFemsa::OrderResponse.new(
-  amount: 21605,
-  amount_refunded: 0,
-  channel: null,
-  charges: null,
-  checkout: null,
-  created_at: 1676328434,
+  id: ord_2zKSF2aUY2kBRcyXJ,
+  object: order,
+  livemode: true,
+  amount: 10000,
   currency: MXN,
+  payment_status: pending_payment,
+  amount_refunded: 0,
+  split_payment: null,
+  metadata: {},
+  is_refundable: false,
+  created_at: 1767651766,
+  updated_at: 1767651766,
   customer_info: null,
-  discount_lines: null,
+  shipping_contact: null,
+  channel: null,
   fiscal_entity: null,
-  id: ord_2tMtQQpDvfnNjiuFG,
-  is_refundable: false,
+  checkout: null,
   line_items: null,
-  livemode: false,
-  metadata: null,
-  next_action: null,
-  object: order,
-  payment_status: paid,
-  processing_mode: ecommerce,
-  shipping_contact: null,
-  updated_at: 1676328434
+  discount_lines: null,
+  charges: null,
+  partial_reference: null,
+  payments_info: null
 )
 ```
 

data/docs/OrderResponseChannel.md

@@ -0,0 +1,24 @@
+# DigitalFemsa::OrderResponseChannel
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **segment** | **String** |  | [optional] |
+| **checkout_request_id** | **String** |  | [optional] |
+| **checkout_request_type** | **String** |  | [optional] |
+| **id** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'digital_femsa'
+
+instance = DigitalFemsa::OrderResponseChannel.new(
+  segment: Checkout,
+  checkout_request_id: 6fca054a-8519-4c43-971e-cea35cc519bb,
+  checkout_request_type: HostedPayment,
+  id: channel_2tNDzhA4Akmzj11AU
+)
+```
+

data/docs/OrderResponseShippingContact.md

@@ -8,13 +8,13 @@
 | **receiver** | **String** |  | [optional] |
 | **between_streets** | **String** |  | [optional] |
 | **address** | [**CustomerShippingContactsResponseAddress**](CustomerShippingContactsResponseAddress.md) |  | [optional] |
-| **parent_id** | **String** |  | [optional] |
+| **parent_id** | **String** | Customer ID that owns this shipping contact. | [optional] |
 | **default** | **Boolean** |  | [optional] |
 | **id** | **String** |  | [optional] |
 | **created_at** | **Integer** |  | [optional] |
 | **metadata** | **Hash<String, Object>** | Metadata associated with the shipping contact | [optional] |
 | **object** | **String** |  | [optional] |
-| **deleted** | **Boolean** |  | [optional] |
+| **deleted** | **Boolean** | Present only when the shipping contact was deleted. | [optional] |
 
 ## Example
 
@@ -26,13 +26,13 @@ instance = DigitalFemsa::OrderResponseShippingContact.new(
   receiver: Marvin Fuller,
   between_streets: Ackerman Crescent,
   address: null,
-  parent_id: null,
+  parent_id: cus_1234567890,
   default: false,
   id: null,
   created_at: null,
   metadata: null,
   object: null,
-  deleted: false
+  deleted: true
 )
 ```
 

data/docs/OrderUpdateFiscalEntityRequest.md

@@ -7,7 +7,7 @@
 | **address** | [**FiscalEntityAddress**](FiscalEntityAddress.md) |  |  |
 | **email** | **String** | Email of the fiscal entity | [optional] |
 | **name** | **String** | Name of the fiscal entity | [optional] |
-| **metadata** | **Hash<String, Object>** | Metadata associated with the fiscal entity | [optional] |
+| **metadata** | **Hash<String, Object>** | Arbitrary key-value data associated with the fiscal entity for your internal use. Keys should be strings; values can be any JSON value.  | [optional] |
 | **phone** | **String** | Phone of the fiscal entity | [optional] |
 | **tax_id** | **String** | Tax ID of the fiscal entity | [optional] |
 

data/docs/OrderUpdateRequest.md

@@ -4,18 +4,20 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **charges** | [**Array<ChargeRequest>**](ChargeRequest.md) |  | [optional] |
-| **checkout** | [**CheckoutRequest**](CheckoutRequest.md) |  | [optional] |
-| **currency** | **String** | Currency with which the payment will be made. It uses the 3-letter code of the [International Standard ISO 4217.](https://es.wikipedia.org/wiki/ISO_4217) | [optional] |
+| **currency** | **String** | Currency code in ISO 4217 (3-letter uppercase). | [optional] |
 | **customer_info** | [**OrderUpdateRequestCustomerInfo**](OrderUpdateRequestCustomerInfo.md) |  | [optional] |
-| **discount_lines** | [**Array<OrderDiscountLinesRequest>**](OrderDiscountLinesRequest.md) | List of [discounts](https://developers.femsa.com/v2.1.0/reference/orderscreatediscountline) that are applied to the order. You must have at least one discount. | [optional] |
-| **fiscal_entity** | [**OrderUpdateFiscalEntityRequest**](OrderUpdateFiscalEntityRequest.md) |  | [optional] |
 | **line_items** | [**Array<Product>**](Product.md) | List of [products](https://developers.femsa.com/v2.1.0/reference/orderscreateproduct) that are sold in the order. You must have at least one product. | [optional] |
-| **metadata** | **Hash<String, String>** |  | [optional] |
-| **pre_authorize** | **Boolean** | Indicates whether the order charges must be preauthorized | [optional][default to false] |
+| **charges** | [**Array<ChargeRequest>**](ChargeRequest.md) |  | [optional] |
+| **discount_lines** | [**Array<OrderDiscountLinesRequest>**](OrderDiscountLinesRequest.md) | List of [discounts](https://developers.femsa.com/v2.1.0/reference/orderscreatediscountline) that are applied to the order. You must have at least one discount. | [optional] |
+| **tax_lines** | [**Array<OrderTaxRequest>**](OrderTaxRequest.md) |  | [optional] |
+| **shipping_contact_id** | **String** | Existing shipping contact id from the customer to link to this order. | [optional] |
 | **shipping_contact** | [**CustomerShippingContacts**](CustomerShippingContacts.md) |  | [optional] |
 | **shipping_lines** | [**Array<ShippingRequest>**](ShippingRequest.md) | List of [shipping costs](https://developers.femsa.com/v2.1.0/reference/orderscreateshipping). If the online store offers digital products. | [optional] |
-| **tax_lines** | [**Array<OrderTaxRequest>**](OrderTaxRequest.md) |  | [optional] |
+| **fiscal_entity_id** | **String** | Existing fiscal entity id from the customer to link to this order. | [optional] |
+| **fiscal_entity** | [**OrderUpdateFiscalEntityRequest**](OrderUpdateFiscalEntityRequest.md) |  | [optional] |
+| **return_url** | **String** | URL where the customer should be redirected after completing a payment flow (if applicable). | [optional] |
+| **metadata** | **Hash<String, Object>** | Arbitrary key-value data that you can attach to the order for your internal use. It is not used for payment processing. Keys should be strings; values can be any JSON value.  | [optional] |
+| **status** | **String** | Order status update (only allowed transitions will be accepted). | [optional] |
 
 ## Example
 
@@ -23,18 +25,20 @@
 require 'digital_femsa'
 
 instance = DigitalFemsa::OrderUpdateRequest.new(
-  charges: null,
-  checkout: null,
   currency: MXN,
   customer_info: null,
-  discount_lines: null,
-  fiscal_entity: null,
   line_items: null,
-  metadata: null,
-  pre_authorize: null,
+  charges: null,
+  discount_lines: null,
+  tax_lines: null,
+  shipping_contact_id: null,
   shipping_contact: null,
   shipping_lines: null,
-  tax_lines: null
+  fiscal_entity_id: null,
+  fiscal_entity: null,
+  return_url: null,
+  metadata: null,
+  status: null
 )
 ```
 

data/docs/OrdersApi.md

@@ -11,7 +11,7 @@ All URIs are relative to *https://api.digitalfemsa.io*
 | [**order_cancel_refund**](OrdersApi.md#order_cancel_refund) | **DELETE** /orders/{id}/refunds/{refund_id} | Cancel Refund |
 | [**order_refund**](OrdersApi.md#order_refund) | **POST** /orders/{id}/refunds | Refund Order |
 | [**orders_create_capture**](OrdersApi.md#orders_create_capture) | **POST** /orders/{id}/capture | Capture Order |
-| [**update_order**](OrdersApi.md#update_order) | **PUT** /orders/{id} | Update Order |
+| [**update_order**](OrdersApi.md#update_order) | **PUT** /orders/{id} | Update order |
 
 
 ## cancel_order
@@ -20,7 +20,7 @@ All URIs are relative to *https://api.digitalfemsa.io*
 
 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.
 
 ### Examples
 
@@ -95,7 +95,7 @@ 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. 
 
 ### Examples
 
@@ -109,7 +109,7 @@ DigitalFemsa.configure do |config|
 end
 
 api_instance = DigitalFemsa::OrdersApi.new
-order_request = DigitalFemsa::OrderRequest.new({currency: 'MXN', customer_info: DigitalFemsa::CustomerInfo.new({name: 'DevTest', email: 'test@femsa.com', phone: '5522997233'}), line_items: [DigitalFemsa::Product.new({name: 'Box of Cohiba S1s', quantity: 1, unit_price: 20000})]}) # OrderRequest | requested field for order
+order_request = DigitalFemsa::OrderRequest.new({currency: 'MXN', customer_info: DigitalFemsa::CustomerInfo.new({name: 'DevTest', email: 'test@femsa.com'}), line_items: [DigitalFemsa::Product.new({name: 'Box of Cohiba', unit_price: 20000, quantity: 1})]}) # OrderRequest | requested field for order
 opts = {
   accept_language: 'es', # String | Use for knowing which language to use
   x_child_company_id: '6441b6376b60c3a638da80af' # String | In the case of a holding company, the company id of the child company to which will process the request.
@@ -170,7 +170,7 @@ 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.
 
 ### Examples
 
@@ -245,7 +245,7 @@ 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. 
 
 ### Examples
 
@@ -326,7 +326,7 @@ 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.
 
 ### Examples
 
@@ -403,7 +403,7 @@ 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.
 
 ### Examples
 
@@ -418,7 +418,7 @@ end
 
 api_instance = DigitalFemsa::OrdersApi.new
 id = '6307a60c41de27127515a575' # String | Identifier of the resource
-order_refund_request = DigitalFemsa::OrderRefundRequest.new({amount: 500, reason: 'suspected_fraud'}) # OrderRefundRequest | requested field for a refund
+order_refund_request = DigitalFemsa::OrderRefundRequest.new({amount: 500, reason: 'requested_by_client'}) # OrderRefundRequest | requested field for a refund
 opts = {
   accept_language: 'es', # String | Use for knowing which language to use
   x_child_company_id: '6441b6376b60c3a638da80af' # String | In the case of a holding company, the company id of the child company to which will process the request.
@@ -480,7 +480,7 @@ 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.
 
 ### Examples
 
@@ -498,7 +498,7 @@ id = '6307a60c41de27127515a575' # String | Identifier of the resource
 opts = {
   accept_language: 'es', # String | Use for knowing which language to use
   x_child_company_id: '6441b6376b60c3a638da80af', # String | In the case of a holding company, the company id of the child company to which will process the request.
-  order_capture_request: DigitalFemsa::OrderCaptureRequest.new({amount: 500}) # OrderCaptureRequest | requested fields for capture order
+  order_capture_request: DigitalFemsa::OrderCaptureRequest.new({amount: 500}) # OrderCaptureRequest | Requested fields for capturing an order
 }
 
 begin
@@ -535,7 +535,7 @@ end
 | **id** | **String** | Identifier of the resource |  |
 | **accept_language** | **String** | Use for knowing which language to use | [optional][default to 'es'] |
 | **x_child_company_id** | **String** | In the case of a holding company, the company id of the child company to which will process the request. | [optional] |
-| **order_capture_request** | [**OrderCaptureRequest**](OrderCaptureRequest.md) | requested fields for capture order | [optional] |
+| **order_capture_request** | [**OrderCaptureRequest**](OrderCaptureRequest.md) | Requested fields for capturing an order | [optional] |
 
 ### Return type
 
@@ -555,9 +555,9 @@ end
 
 > <OrderResponse> update_order(id, order_update_request, opts)
 
-Update Order
+Update order
 
-Update an existing 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. 
 
 ### Examples
 
@@ -578,7 +578,7 @@ opts = {
 }
 
 begin
-  # Update Order
+  # Update order
   result = api_instance.update_order(id, order_update_request, opts)
   p result
 rescue DigitalFemsa::ApiError => e
@@ -594,7 +594,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Update Order
+  # Update order
   data, status_code, headers = api_instance.update_order_with_http_info(id, order_update_request, opts)
   p status_code # => 2xx
   p headers # => { ... }