feat: API sync

CHANGELOG.md

@@ -12,6 +12,12 @@ Check our main [developer changelog](https://developer.paddle.com/?utm_source=dx
 
 - Added `traffic_source` property to `NotificationSetting` entity
 - Support notification settings `traffic_source` filter
+- Support new payment methods `offline`, `unknown`, `wire_transfer`
+- Support `tax_rates_used` property on `Adjustment` entity
+
+### Fixed
+
+- Dropped `receipt_data` on create and preview of a one-time charge for Subscriptions and Transactions
 
 # [1.3.1] - 2024-09-30
 

src/Entities/Adjustment.php

@@ -12,6 +12,7 @@
 namespace Paddle\SDK\Entities;
 
 use Paddle\SDK\Entities\Adjustment\AdjustmentItem;
+use Paddle\SDK\Entities\Adjustment\AdjustmentTaxRatesUsed;
 use Paddle\SDK\Entities\Shared\Action;
 use Paddle\SDK\Entities\Shared\AdjustmentStatus;
 use Paddle\SDK\Entities\Shared\AdjustmentTotals;
@@ -21,7 +22,8 @@
 class Adjustment implements Entity
 {
     /**
-     * @param array<AdjustmentItem> $items
+     * @param array<AdjustmentItem>         $items
+     * @param array<AdjustmentTaxRatesUsed> $taxRatesUsed
      */
     private function __construct(
         public string $id,
@@ -36,6 +38,7 @@ private function __construct(
         public array $items,
         public AdjustmentTotals $totals,
         public PayoutTotalsAdjustment|null $payoutTotals,
+        public array $taxRatesUsed,
         public \DateTimeInterface $createdAt,
         public \DateTimeInterface|null $updatedAt,
     ) {
@@ -56,6 +59,7 @@ public static function from(array $data): self
             items: array_map(fn (array $item): AdjustmentItem => AdjustmentItem::from($item), $data['items']),
             totals: AdjustmentTotals::from($data['totals']),
             payoutTotals: isset($data['payout_totals']) ? PayoutTotalsAdjustment::from($data['payout_totals']) : null,
+            taxRatesUsed: array_map(fn (array $taxRateUsed): AdjustmentTaxRatesUsed => AdjustmentTaxRatesUsed::from($taxRateUsed), $data['tax_rates_used'] ?? []),
             createdAt: DateTime::from($data['created_at']),
             updatedAt: DateTime::from($data['updated_at']),
         );

src/Entities/Adjustment/AdjustmentTaxRatesUsed.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * |------
+ * | ! Generated code !
+ * | Altering this code will result in changes being overwritten |
+ * |-------------------------------------------------------------|.
+ */
+
+namespace Paddle\SDK\Entities\Adjustment;
+
+class AdjustmentTaxRatesUsed
+{
+    private function __construct(
+        public string $taxRate,
+        public AdjustmentTaxRatesUsedTotals $totals,
+    ) {
+    }
+
+    public static function from(array $data): self
+    {
+        return new self(
+            $data['tax_rate'],
+            AdjustmentTaxRatesUsedTotals::from($data['totals']),
+        );
+    }
+}

src/Entities/Adjustment/AdjustmentTaxRatesUsedTotals.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * |------
+ * | ! Generated code !
+ * | Altering this code will result in changes being overwritten |
+ * |-------------------------------------------------------------|.
+ */
+
+namespace Paddle\SDK\Entities\Adjustment;
+
+class AdjustmentTaxRatesUsedTotals
+{
+    private function __construct(
+        public string $subtotal,
+        public string $tax,
+        public string $total,
+    ) {
+    }
+
+    public static function from(array $data): self
+    {
+        return new self(
+            $data['subtotal'],
+            $data['tax'],
+            $data['total'],
+        );
+    }
+}

src/Entities/Shared/AvailablePaymentMethods.php

@@ -20,7 +20,10 @@
  * @method static AvailablePaymentMethods Card()
  * @method static AvailablePaymentMethods GooglePay()
  * @method static AvailablePaymentMethods Ideal()
+ * @method static AvailablePaymentMethods Offline()
  * @method static AvailablePaymentMethods Paypal()
+ * @method static AvailablePaymentMethods Unknown()
+ * @method static AvailablePaymentMethods WireTransfer()
  */
 final class AvailablePaymentMethods extends PaddleEnum
 {
@@ -30,5 +33,8 @@ final class AvailablePaymentMethods extends PaddleEnum
     private const Card = 'card';
     private const GooglePay = 'google_pay';
     private const Ideal = 'ideal';
+    private const Offline = 'offline';
     private const Paypal = 'paypal';
+    private const Unknown = 'unknown';
+    private const WireTransfer = 'wire_transfer';
 }

src/Entities/Transaction.php

@@ -56,7 +56,6 @@ private function __construct(
         public \DateTimeInterface $createdAt,
         public \DateTimeInterface $updatedAt,
         public \DateTimeInterface|null $billedAt,
-        public string|null $receiptData,
         public Address|null $address,
         public array $adjustments,
         public TransactionAdjustmentsTotals|null $adjustmentsTotals,
@@ -92,7 +91,6 @@ public static function from(array $data): self
             createdAt: DateTime::from($data['created_at']),
             updatedAt: DateTime::from($data['updated_at']),
             billedAt: isset($data['billed_at']) ? DateTime::from($data['billed_at']) : null,
-            receiptData: $data['receipt_data'] ?? null,
             address: isset($data['address']) ? Address::from($data['address']) : null,
             adjustments: array_map(fn (array $adjustment): Adjustment => Adjustment::from($adjustment), $data['adjustments'] ?? []),
             adjustmentsTotals: isset($data['adjustments_totals']) ? TransactionAdjustmentsTotals::from($data['adjustments_totals']) : null,

src/Notifications/Entities/Adjustment.php

@@ -12,6 +12,7 @@
 namespace Paddle\SDK\Notifications\Entities;
 
 use Paddle\SDK\Notifications\Entities\Adjustment\AdjustmentItem;
+use Paddle\SDK\Notifications\Entities\Adjustment\AdjustmentTaxRatesUsed;
 use Paddle\SDK\Notifications\Entities\Shared\Action;
 use Paddle\SDK\Notifications\Entities\Shared\AdjustmentStatus;
 use Paddle\SDK\Notifications\Entities\Shared\AdjustmentTotals;
@@ -21,7 +22,8 @@
 class Adjustment implements Entity
 {
     /**
-     * @param array<AdjustmentItem> $items
+     * @param array<AdjustmentItem>         $items
+     * @param array<AdjustmentTaxRatesUsed> $taxRatesUsed
      */
     private function __construct(
         public string $id,
@@ -36,6 +38,7 @@ private function __construct(
         public array $items,
         public AdjustmentTotals $totals,
         public PayoutTotalsAdjustment|null $payoutTotals,
+        public array $taxRatesUsed,
         public \DateTimeInterface $createdAt,
         public \DateTimeInterface|null $updatedAt,
     ) {
@@ -56,6 +59,7 @@ public static function from(array $data): self
             items: array_map(fn (array $item): AdjustmentItem => AdjustmentItem::from($item), $data['items']),
             totals: AdjustmentTotals::from($data['totals']),
             payoutTotals: isset($data['payout_totals']) ? PayoutTotalsAdjustment::from($data['payout_totals']) : null,
+            taxRatesUsed: array_map(fn (array $taxRateUsed): AdjustmentTaxRatesUsed => AdjustmentTaxRatesUsed::from($taxRateUsed), $data['tax_rates_used'] ?? []),
             createdAt: DateTime::from($data['created_at']),
             updatedAt: isset($data['updated_at']) ? DateTime::from($data['updated_at']) : null,
         );

src/Notifications/Entities/Adjustment/AdjustmentTaxRatesUsed.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * |------
+ * | ! Generated code !
+ * | Altering this code will result in changes being overwritten |
+ * |-------------------------------------------------------------|.
+ */
+
+namespace Paddle\SDK\Notifications\Entities\Adjustment;
+
+class AdjustmentTaxRatesUsed
+{
+    private function __construct(
+        public string $taxRate,
+        public AdjustmentTaxRatesUsedTotals $totals,
+    ) {
+    }
+
+    public static function from(array $data): self
+    {
+        return new self(
+            $data['tax_rate'],
+            AdjustmentTaxRatesUsedTotals::from($data['totals']),
+        );
+    }
+}

src/Notifications/Entities/Adjustment/AdjustmentTaxRatesUsedTotals.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * |------
+ * | ! Generated code !
+ * | Altering this code will result in changes being overwritten |
+ * |-------------------------------------------------------------|.
+ */
+
+namespace Paddle\SDK\Notifications\Entities\Adjustment;
+
+class AdjustmentTaxRatesUsedTotals
+{
+    private function __construct(
+        public string $subtotal,
+        public string $tax,
+        public string $total,
+    ) {
+    }
+
+    public static function from(array $data): self
+    {
+        return new self(
+            $data['subtotal'],
+            $data['tax'],
+            $data['total'],
+        );
+    }
+}

src/Notifications/Entities/Transaction.php

@@ -52,7 +52,6 @@ private function __construct(
         public \DateTimeInterface $createdAt,
         public \DateTimeInterface $updatedAt,
         public \DateTimeInterface|null $billedAt,
-        public string|null $receiptData,
     ) {
     }
 
@@ -81,7 +80,6 @@ public static function from(array $data): self
             createdAt: DateTime::from($data['created_at']),
             updatedAt: DateTime::from($data['updated_at']),
             billedAt: isset($data['billed_at']) ? DateTime::from($data['billed_at']) : null,
-            receiptData: $data['receipt_data'] ?? null,
         );
     }
 }

src/Resources/Subscriptions/Operations/CreateOneTimeCharge.php

@@ -32,7 +32,6 @@ public function jsonSerialize(): array
             'effective_from' => $this->effectiveFrom,
             'items' => $this->items,
             'on_payment_failure' => $this->onPaymentFailure,
-            'receipt_data' => $this->receiptData,
         ]);
     }
 }

tests/Functional/Resources/Adjustments/_fixtures/response/full_entity.json

@@ -50,6 +50,16 @@
             "earnings": "2029",
             "currency_code": "USD"
         },
+        "tax_rates_used": [
+            {
+                "tax_rate": "0.08875",
+                "totals": {
+                    "subtotal": "59900",
+                    "tax": "5315",
+                    "total": "65215"
+                }
+            }
+        ],
         "created_at": "2023-08-21T13:57:15.489634Z",
         "updated_at": "0001-01-01T00:00:00Z"
     },

tests/Functional/Resources/Adjustments/_fixtures/response/list_default.json

@@ -39,6 +39,16 @@
                 "earnings": "87",
                 "currency_code": "USD"
             },
+            "tax_rates_used": [
+                {
+                    "tax_rate": "0.08875",
+                    "totals": {
+                        "subtotal": "59900",
+                        "tax": "5315",
+                        "total": "65215"
+                    }
+                }
+            ],
             "created_at": "2023-08-21T13:57:15.489634Z",
             "updated_at": "2023-08-21T13:57:15.489634Z"
         },
@@ -88,6 +98,16 @@
                 "earnings": "141771",
                 "currency_code": "USD"
             },
+            "tax_rates_used": [
+                {
+                    "tax_rate": "0.08875",
+                    "totals": {
+                        "subtotal": "59900",
+                        "tax": "5315",
+                        "total": "65215"
+                    }
+                }
+            ],
             "created_at": "2023-08-21T11:25:13.138521Z",
             "updated_at": "2023-08-21T11:25:13.138521Z"
         },
@@ -137,6 +157,16 @@
                 "earnings": "56356",
                 "currency_code": "USD"
             },
+            "tax_rates_used": [
+                {
+                    "tax_rate": "0.08875",
+                    "totals": {
+                        "subtotal": "59900",
+                        "tax": "5315",
+                        "total": "65215"
+                    }
+                }
+            ],
             "created_at": "2023-08-11T14:46:04.811464Z",
             "updated_at": "2023-08-11T14:46:05.13404Z"
         },
@@ -186,6 +216,16 @@
                 "earnings": "28151",
                 "currency_code": "USD"
             },
+            "tax_rates_used": [
+                {
+                    "tax_rate": "0.08875",
+                    "totals": {
+                        "subtotal": "59900",
+                        "tax": "5315",
+                        "total": "65215"
+                    }
+                }
+            ],
             "created_at": "2023-08-11T14:15:01.225381Z",
             "updated_at": "2023-08-11T14:15:03.54843Z"
         },
@@ -253,6 +293,16 @@
                 "earnings": "42608",
                 "currency_code": "USD"
             },
+            "tax_rates_used": [
+                {
+                    "tax_rate": "0.08875",
+                    "totals": {
+                        "subtotal": "59900",
+                        "tax": "5315",
+                        "total": "65215"
+                    }
+                }
+            ],
             "created_at": "2023-06-30T13:46:24.240375Z",
             "updated_at": "2023-06-30T13:46:24.240376Z"
         }

tests/Functional/Resources/Adjustments/_fixtures/response/minimal_entity.json

@@ -38,6 +38,16 @@
             "earnings": "87",
             "currency_code": "USD"
         },
+        "tax_rates_used": [
+            {
+                "tax_rate": "0.08875",
+                "totals": {
+                    "subtotal": "59900",
+                    "tax": "5315",
+                    "total": "65215"
+                }
+            }
+        ],
         "created_at": "2023-08-21T13:57:15.489634Z",
         "updated_at": "0001-01-01T00:00:00Z"
     },