TASK: Updating SDK

Author: Auto Mation

changes.md

@@ -37,8 +37,11 @@
 - :warning: changed property `country` of type `MissingTaxRateForCountryError` from type `string` to `CountryCode` (file:/home/runner/work/commercetools-api-reference/commercetools-api-reference/commercetools-api-reference/api-specs/api/types/error/MissingTaxRateForCountryError.raml:23:2)
 - :warning: changed property `currency` of type `OverlappingStandalonePriceValidityError` from type `string` to `CurrencyCode` (file:/home/runner/work/commercetools-api-reference/commercetools-api-reference/commercetools-api-reference/api-specs/api/types/error/OverlappingStandalonePriceValidityError.raml:25:2)
 - :warning: changed property `country` of type `OverlappingStandalonePriceValidityError` from type `string` to `CountryCode` (file:/home/runner/work/commercetools-api-reference/commercetools-api-reference/commercetools-api-reference/api-specs/api/types/error/OverlappingStandalonePriceValidityError.raml:29:2)
+- :warning: changed property `amountPlanned` of type `MyPayment` from type `TypedMoney` to `CentPrecisionMoney` (file:/home/runner/work/commercetools-api-reference/commercetools-api-reference/commercetools-api-reference/api-specs/api/types/me/MyPayment.raml:27:2)
+- :warning: changed property `amountPlanned` of type `Payment` from type `TypedMoney` to `CentPrecisionMoney` (file:/home/runner/work/commercetools-api-reference/commercetools-api-reference/commercetools-api-reference/api-specs/api/types/payment/Payment.raml:49:2)
 - :warning: changed property `field` of type `DuplicateFieldError` to be required (file:/home/runner/work/commercetools-api-reference/commercetools-api-reference/commercetools-api-reference/api-specs/api/types/error/DuplicateFieldError.raml:14:2)
 - :warning: changed property `duplicateValue` of type `DuplicateFieldError` to be required (file:/home/runner/work/commercetools-api-reference/commercetools-api-reference/commercetools-api-reference/api-specs/api/types/error/DuplicateFieldError.raml:18:2)
+- :warning: changed property `state` of type `Transaction` to be required (file:/home/runner/work/commercetools-api-reference/commercetools-api-reference/commercetools-api-reference/api-specs/api/types/payment/Transaction.raml:27:2)
 - :warning: changed property `lineItems` of type `ShoppingList` to be required (file:/home/runner/work/commercetools-api-reference/commercetools-api-reference/commercetools-api-reference/api-specs/api/types/shopping-list/ShoppingList.raml:41:2)
 - :warning: changed property `textLineItems` of type `ShoppingList` to be required (file:/home/runner/work/commercetools-api-reference/commercetools-api-reference/commercetools-api-reference/api-specs/api/types/shopping-list/ShoppingList.raml:45:2)
 </details>

lib/commercetools-api/docs/RequestBuilder.md

@@ -3334,7 +3334,8 @@ $request = $builder
 ```
 ## `withProjectKey("projectKey")->me()->payments()->post(null)`
 
-null
+Creating a Payment produces the [PaymentCreated](ctp:api:type:PaymentCreatedMessage) Message.
+
 
 ### Example
 ```php
@@ -3365,7 +3366,8 @@ $request = $builder
 ```
 ## `withProjectKey("projectKey")->me()->payments()->withId("ID")->post(null)`
 
-null
+This endpoint can only update a Payment when it has no [Transactions](ctp:api:type:Transaction).
+
 
 ### Example
 ```php
@@ -3381,7 +3383,8 @@ $request = $builder
 ```
 ## `withProjectKey("projectKey")->me()->payments()->withId("ID")->delete()`
 
-null
+This endpoint can only delete a Payment when it has no [Transactions](ctp:api:type:Transaction).
+
 
 ### Example
 ```php
@@ -3413,7 +3416,8 @@ $request = $builder
 ```
 ## `withProjectKey("projectKey")->me()->payments()->withKey("key")->post(null)`
 
-null
+This endpoint can only update a Payment when it has no [Transactions](ctp:api:type:Transaction).
+
 
 ### Example
 ```php
@@ -3429,7 +3433,8 @@ $request = $builder
 ```
 ## `withProjectKey("projectKey")->me()->payments()->withKey("key")->delete()`
 
-null
+This endpoint can only delete a Payment when it has no [Transactions](ctp:api:type:Transaction).
+
 
 ### Example
 ```php
@@ -4163,7 +4168,8 @@ $request = $builder
 ```
 ## `withProjectKey("projectKey")->payments()->post(null)`
 
-To create a payment object a payment draft object has to be given with the request.
+Creating a Payment produces the [PaymentCreated](ctp:api:type:PaymentCreatedMessage) Message.
+
 
 ### Example
 ```php

lib/commercetools-api/src/Models/Me/MyCartAddPaymentAction.php

@@ -17,7 +17,7 @@ interface MyCartAddPaymentAction extends MyCartUpdateAction
     public const FIELD_PAYMENT = 'payment';
 
     /**
-     * <p><a href="ctp:api:type:ResourceIdentifier">ResourceIdentifier</a> to a <a href="ctp:api:type:Payment">Payment</a>.</p>
+     * <p><a href="ctp:api:type:ResourceIdentifier">ResourceIdentifier</a> of a <a href="ctp:api:type:Payment">Payment</a>.</p>
      *
 
      * @return null|PaymentResourceIdentifier

lib/commercetools-api/src/Models/Me/MyCartAddPaymentActionBuilder.php

@@ -29,7 +29,7 @@ final class MyCartAddPaymentActionBuilder implements Builder
     private $payment;
 
     /**
-     * <p><a href="ctp:api:type:ResourceIdentifier">ResourceIdentifier</a> to a <a href="ctp:api:type:Payment">Payment</a>.</p>
+     * <p><a href="ctp:api:type:ResourceIdentifier">ResourceIdentifier</a> of a <a href="ctp:api:type:Payment">Payment</a>.</p>
      *
 
      * @return null|PaymentResourceIdentifier

lib/commercetools-api/src/Models/Me/MyCartAddPaymentActionModel.php

@@ -65,7 +65,7 @@ public function getAction()
     }
 
     /**
-     * <p><a href="ctp:api:type:ResourceIdentifier">ResourceIdentifier</a> to a <a href="ctp:api:type:Payment">Payment</a>.</p>
+     * <p><a href="ctp:api:type:ResourceIdentifier">ResourceIdentifier</a> of a <a href="ctp:api:type:Payment">Payment</a>.</p>
      *
      *
      * @return null|PaymentResourceIdentifier

lib/commercetools-api/src/Models/Me/MyCartRemovePaymentAction.php

@@ -17,7 +17,7 @@ interface MyCartRemovePaymentAction extends MyCartUpdateAction
     public const FIELD_PAYMENT = 'payment';
 
     /**
-     * <p><a href="ctp:api:type:ResourceIdentifier">ResourceIdentifier</a> to a <a href="ctp:api:type:Payment">Payment</a>.</p>
+     * <p><a href="ctp:api:type:ResourceIdentifier">ResourceIdentifier</a> of a <a href="ctp:api:type:Payment">Payment</a>.</p>
      *
 
      * @return null|PaymentResourceIdentifier

lib/commercetools-api/src/Models/Me/MyCartRemovePaymentActionBuilder.php

@@ -29,7 +29,7 @@ final class MyCartRemovePaymentActionBuilder implements Builder
     private $payment;
 
     /**
-     * <p><a href="ctp:api:type:ResourceIdentifier">ResourceIdentifier</a> to a <a href="ctp:api:type:Payment">Payment</a>.</p>
+     * <p><a href="ctp:api:type:ResourceIdentifier">ResourceIdentifier</a> of a <a href="ctp:api:type:Payment">Payment</a>.</p>
      *
 
      * @return null|PaymentResourceIdentifier

lib/commercetools-api/src/Models/Me/MyCartRemovePaymentActionModel.php

@@ -65,7 +65,7 @@ public function getAction()
     }
 
     /**
-     * <p><a href="ctp:api:type:ResourceIdentifier">ResourceIdentifier</a> to a <a href="ctp:api:type:Payment">Payment</a>.</p>
+     * <p><a href="ctp:api:type:ResourceIdentifier">ResourceIdentifier</a> of a <a href="ctp:api:type:Payment">Payment</a>.</p>
      *
      *
      * @return null|PaymentResourceIdentifier

lib/commercetools-api/src/Models/Me/MyPayment.php

@@ -8,7 +8,7 @@
 
 namespace Commercetools\Api\Models\Me;
 
-use Commercetools\Api\Models\Common\TypedMoney;
+use Commercetools\Api\Models\Common\CentPrecisionMoney;
 use Commercetools\Api\Models\Customer\CustomerReference;
 use Commercetools\Api\Models\Payment\PaymentMethodInfo;
 use Commercetools\Api\Models\Payment\TransactionCollection;
@@ -28,60 +28,65 @@ interface MyPayment extends JsonObject
     public const FIELD_CUSTOM = 'custom';
 
     /**
-     * <p>Unique identifier of the MyPayment.</p>
+     * <p>Unique identifier of the Payment.</p>
      *
 
      * @return null|string
      */
     public function getId();
 
     /**
+     * <p>Current version of the Payment.</p>
+     *
 
      * @return null|int
      */
     public function getVersion();
 
     /**
-     * <p>A reference to the customer this payment belongs to.</p>
+     * <p>Reference to a <a href="ctp:api:type:Customer">Customer</a> associated with the Payment. Set automatically with a <a href="/../api/authorization#password-flow">password flow token</a>. Either <code>customer</code> or <code>anonymousId</code> is present.</p>
      *
 
      * @return null|CustomerReference
      */
     public function getCustomer();
 
     /**
-     * <p>Identifies payments belonging to an anonymous session (the customer has not signed up/in yet).</p>
+     * <p><a href="/../api/authorization#tokens-for-anonymous-sessions">Anonymous session</a> associated with the Payment. Set automatically with a <a href="/../api/authorization#tokens-for-anonymous-sessions">token for an anonymous session</a>. Either <code>customer</code> or <code>anonymousId</code> is present.</p>
      *
 
      * @return null|string
      */
     public function getAnonymousId();
 
     /**
-     * <p>How much money this payment intends to receive from the customer.
-     * The value usually matches the cart or order gross total.</p>
+     * <p>Money value the Payment intends to receive from the customer.
+     * The value typically matches the <a href="ctp:api:type:Cart">Cart</a> or <a href="ctp:api:type:Order">Order</a> gross total.</p>
      *
 
-     * @return null|TypedMoney
+     * @return null|CentPrecisionMoney
      */
     public function getAmountPlanned();
 
     /**
+     * <p>Information regarding the payment interface (for example, a PSP), and the specific payment method used.</p>
+     *
 
      * @return null|PaymentMethodInfo
      */
     public function getPaymentMethodInfo();
 
     /**
-     * <p>A list of financial transactions of different TransactionTypes
-     * with different TransactionStates.</p>
+     * <p>Financial transactions of the Payment. Each Transaction has a <a href="ctp:api:type:TransactionType">TransactionType</a> and a <a href="ctp:api:type:TransactionState">TransactionState</a>.</p>
      *
 
      * @return null|TransactionCollection
      */
     public function getTransactions();
 
     /**
+     * <p>Custom Fields defined for the Payment.</p>
+     *
 
      * @return null|CustomFields
      */
@@ -108,9 +113,9 @@ public function setCustomer(?CustomerReference $customer): void;
     public function setAnonymousId(?string $anonymousId): void;
 
     /**
-     * @param ?TypedMoney $amountPlanned
+     * @param ?CentPrecisionMoney $amountPlanned
      */
-    public function setAmountPlanned(?TypedMoney $amountPlanned): void;
+    public function setAmountPlanned(?CentPrecisionMoney $amountPlanned): void;
 
     /**
      * @param ?PaymentMethodInfo $paymentMethodInfo

lib/commercetools-api/src/Models/Me/MyPaymentAddTransactionAction.php

@@ -17,6 +17,8 @@ interface MyPaymentAddTransactionAction extends MyPaymentUpdateAction
     public const FIELD_TRANSACTION = 'transaction';
 
     /**
+     * <p>Transaction to add to the Payment.</p>
+     *
 
      * @return null|TransactionDraft
      */