feat(api): api update

.stats.yml

@@ -1,3 +1,3 @@
 configured_endpoints: 239
-openapi_spec_hash: d691eb2845a0108278fe81faa111d29f
+openapi_spec_hash: e8136cf3fc19b9f1d4632136a98880cd
 config_hash: 1ca082e374ef7000e2a5971e8da740e0

src/increase/types/pending_transaction.py

@@ -1580,10 +1580,10 @@ class PendingTransaction(BaseModel):
     amount: int
     """The Pending Transaction amount in the minor unit of its currency.
 
-    For dollars, for example, this is cents. This amount does not change after the
-    Pending Transaction is created. If a card authorization settles for a different
-    amount, the settled amount is available on the resulting Transaction and on the
-    Card Payment's `state.settled_amount`.
+    For dollars, for example, this is cents. For a card authorization this is the
+    amount still held: it decreases when the merchant reverses part of the
+    authorization. The amount that settled is available on the resulting Transaction
+    and on the Card Payment's `state.settled_amount`.
     """
 
     completed_at: Optional[datetime] = None
@@ -1651,8 +1651,8 @@ class PendingTransaction(BaseModel):
     - `complete` - The Pending Transaction is confirmed. An associated Transaction
       exists for this object. The Pending Transaction will no longer count against
       your balance and can generally be hidden from UIs, etc. The Pending
-      Transaction's `amount` is not updated if the associated Transaction settles
-      for a different amount.
+      Transaction's `amount` is the amount that was still held when it completed,
+      which can differ from the amount of the associated Transaction.
     """
 
     type: Literal["pending_transaction"]