Bump stripe-php from 16.4.0 to 17.2.1

2025-05-22 12:37:35 -04:00
parent 5361391b3b
commit 6a368840fa
332 changed files with 4978 additions and 4624 deletions
--- a/plugins/stripe-php/lib/Service/Terminal/ConfigurationService.php
+++ b/plugins/stripe-php/lib/Service/Terminal/ConfigurationService.php
@@ -6,6 +6,7 @@ namespace Stripe\Service\Terminal;

 /**
 * @phpstan-import-type RequestOptionsArray from \Stripe\Util\RequestOptions
+ *
 * @psalm-import-type RequestOptionsArray from \Stripe\Util\RequestOptions
 */
 class ConfigurationService extends \Stripe\Service\AbstractService
@@ -13,12 +14,12 @@ class ConfigurationService extends \Stripe\Service\AbstractService
    /**
     * Returns a list of <code>Configuration</code> objects.
     *
-     * @param null|array $params
+     * @param null|array{ending_before?: string, expand?: string[], is_account_default?: bool, limit?: int, starting_after?: string} $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Collection<\Stripe\Terminal\Configuration>
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function all($params = null, $opts = null)
    {
@@ -28,12 +29,12 @@ class ConfigurationService extends \Stripe\Service\AbstractService
    /**
     * Creates a new <code>Configuration</code> object.
     *
-     * @param null|array $params
+     * @param null|array{bbpos_wisepos_e?: array{splashscreen?: null|string}, expand?: string[], name?: string, offline?: null|array{enabled: bool}, reboot_window?: array{end_hour: int, start_hour: int}, stripe_s700?: array{splashscreen?: null|string}, tipping?: null|array{aud?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, cad?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, chf?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, czk?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, dkk?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, eur?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, gbp?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, hkd?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, jpy?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, myr?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, nok?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, nzd?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, pln?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, sek?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, sgd?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, usd?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}}, verifone_p400?: array{splashscreen?: null|string}, wifi?: null|array{enterprise_eap_peap?: array{ca_certificate_file?: string, password: string, ssid: string, username: string}, enterprise_eap_tls?: array{ca_certificate_file?: string, client_certificate_file: string, private_key_file: string, private_key_file_password?: string, ssid: string}, personal_psk?: array{password: string, ssid: string}, type: string}} $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Terminal\Configuration
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function create($params = null, $opts = null)
    {
@@ -47,9 +48,9 @@ class ConfigurationService extends \Stripe\Service\AbstractService
     * @param null|array $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Terminal\Configuration
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function delete($id, $params = null, $opts = null)
    {
@@ -60,12 +61,12 @@ class ConfigurationService extends \Stripe\Service\AbstractService
     * Retrieves a <code>Configuration</code> object.
     *
     * @param string $id
-     * @param null|array $params
+     * @param null|array{expand?: string[]} $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Terminal\Configuration
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function retrieve($id, $params = null, $opts = null)
    {
@@ -76,12 +77,12 @@ class ConfigurationService extends \Stripe\Service\AbstractService
     * Updates a new <code>Configuration</code> object.
     *
     * @param string $id
-     * @param null|array $params
+     * @param null|array{bbpos_wisepos_e?: null|array{splashscreen?: null|string}, expand?: string[], name?: string, offline?: null|array{enabled: bool}, reboot_window?: null|array{end_hour: int, start_hour: int}, stripe_s700?: null|array{splashscreen?: null|string}, tipping?: null|array{aud?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, cad?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, chf?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, czk?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, dkk?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, eur?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, gbp?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, hkd?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, jpy?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, myr?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, nok?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, nzd?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, pln?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, sek?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, sgd?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}, usd?: array{fixed_amounts?: int[], percentages?: int[], smart_tip_threshold?: int}}, verifone_p400?: null|array{splashscreen?: null|string}, wifi?: null|array{enterprise_eap_peap?: array{ca_certificate_file?: string, password: string, ssid: string, username: string}, enterprise_eap_tls?: array{ca_certificate_file?: string, client_certificate_file: string, private_key_file: string, private_key_file_password?: string, ssid: string}, personal_psk?: array{password: string, ssid: string}, type: string}} $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Terminal\Configuration
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function update($id, $params = null, $opts = null)
    {
--- a/plugins/stripe-php/lib/Service/Terminal/ConnectionTokenService.php
+++ b/plugins/stripe-php/lib/Service/Terminal/ConnectionTokenService.php
@@ -6,6 +6,7 @@ namespace Stripe\Service\Terminal;

 /**
 * @phpstan-import-type RequestOptionsArray from \Stripe\Util\RequestOptions
+ *
 * @psalm-import-type RequestOptionsArray from \Stripe\Util\RequestOptions
 */
 class ConnectionTokenService extends \Stripe\Service\AbstractService
@@ -15,12 +16,12 @@ class ConnectionTokenService extends \Stripe\Service\AbstractService
     * connection token from Stripe, proxied through your server. On your backend, add
     * an endpoint that creates and returns a connection token.
     *
-     * @param null|array $params
+     * @param null|array{expand?: string[], location?: string} $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Terminal\ConnectionToken
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function create($params = null, $opts = null)
    {
--- a/plugins/stripe-php/lib/Service/Terminal/LocationService.php
+++ b/plugins/stripe-php/lib/Service/Terminal/LocationService.php
@@ -6,6 +6,7 @@ namespace Stripe\Service\Terminal;

 /**
 * @phpstan-import-type RequestOptionsArray from \Stripe\Util\RequestOptions
+ *
 * @psalm-import-type RequestOptionsArray from \Stripe\Util\RequestOptions
 */
 class LocationService extends \Stripe\Service\AbstractService
@@ -13,12 +14,12 @@ class LocationService extends \Stripe\Service\AbstractService
    /**
     * Returns a list of <code>Location</code> objects.
     *
-     * @param null|array $params
+     * @param null|array{ending_before?: string, expand?: string[], limit?: int, starting_after?: string} $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Collection<\Stripe\Terminal\Location>
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function all($params = null, $opts = null)
    {
@@ -30,12 +31,12 @@ class LocationService extends \Stripe\Service\AbstractService
     * address fields are required in each country, see the <a
     * href="/docs/terminal/fleet/locations">Manage locations</a> guide.
     *
-     * @param null|array $params
+     * @param null|array{address: array{city?: string, country: string, line1?: string, line2?: string, postal_code?: string, state?: string}, configuration_overrides?: string, display_name: string, expand?: string[], metadata?: null|array<string, string>} $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Terminal\Location
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function create($params = null, $opts = null)
    {
@@ -49,9 +50,9 @@ class LocationService extends \Stripe\Service\AbstractService
     * @param null|array $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Terminal\Location
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function delete($id, $params = null, $opts = null)
    {
@@ -62,12 +63,12 @@ class LocationService extends \Stripe\Service\AbstractService
     * Retrieves a <code>Location</code> object.
     *
     * @param string $id
-     * @param null|array $params
+     * @param null|array{expand?: string[]} $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Terminal\Location
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function retrieve($id, $params = null, $opts = null)
    {
@@ -79,12 +80,12 @@ class LocationService extends \Stripe\Service\AbstractService
     * passed. Any parameters not provided will be left unchanged.
     *
     * @param string $id
-     * @param null|array $params
+     * @param null|array{address?: array{city?: string, country?: string, line1?: string, line2?: string, postal_code?: string, state?: string}, configuration_overrides?: null|string, display_name?: string, expand?: string[], metadata?: null|array<string, string>} $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Terminal\Location
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function update($id, $params = null, $opts = null)
    {
--- a/plugins/stripe-php/lib/Service/Terminal/ReaderService.php
+++ b/plugins/stripe-php/lib/Service/Terminal/ReaderService.php
@@ -6,6 +6,7 @@ namespace Stripe\Service\Terminal;

 /**
 * @phpstan-import-type RequestOptionsArray from \Stripe\Util\RequestOptions
+ *
 * @psalm-import-type RequestOptionsArray from \Stripe\Util\RequestOptions
 */
 class ReaderService extends \Stripe\Service\AbstractService
@@ -13,12 +14,12 @@ class ReaderService extends \Stripe\Service\AbstractService
    /**
     * Returns a list of <code>Reader</code> objects.
     *
-     * @param null|array $params
+     * @param null|array{device_type?: string, ending_before?: string, expand?: string[], limit?: int, location?: string, serial_number?: string, starting_after?: string, status?: string} $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Collection<\Stripe\Terminal\Reader>
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function all($params = null, $opts = null)
    {
@@ -29,12 +30,12 @@ class ReaderService extends \Stripe\Service\AbstractService
     * Cancels the current reader action.
     *
     * @param string $id
-     * @param null|array $params
+     * @param null|array{expand?: string[]} $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Terminal\Reader
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function cancelAction($id, $params = null, $opts = null)
    {
@@ -44,12 +45,12 @@ class ReaderService extends \Stripe\Service\AbstractService
    /**
     * Creates a new <code>Reader</code> object.
     *
-     * @param null|array $params
+     * @param null|array{expand?: string[], label?: string, location?: string, metadata?: null|array<string, string>, registration_code: string} $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Terminal\Reader
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function create($params = null, $opts = null)
    {
@@ -63,9 +64,9 @@ class ReaderService extends \Stripe\Service\AbstractService
     * @param null|array $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Terminal\Reader
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function delete($id, $params = null, $opts = null)
    {
@@ -76,12 +77,12 @@ class ReaderService extends \Stripe\Service\AbstractService
     * Initiates a payment flow on a Reader.
     *
     * @param string $id
-     * @param null|array $params
+     * @param null|array{expand?: string[], payment_intent: string, process_config?: array{allow_redisplay?: string, enable_customer_cancellation?: bool, skip_tipping?: bool, tipping?: array{amount_eligible?: int}}} $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Terminal\Reader
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function processPaymentIntent($id, $params = null, $opts = null)
    {
@@ -92,12 +93,12 @@ class ReaderService extends \Stripe\Service\AbstractService
     * Initiates a setup intent flow on a Reader.
     *
     * @param string $id
-     * @param null|array $params
+     * @param null|array{allow_redisplay: string, expand?: string[], process_config?: array{enable_customer_cancellation?: bool}, setup_intent: string} $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Terminal\Reader
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function processSetupIntent($id, $params = null, $opts = null)
    {
@@ -108,12 +109,12 @@ class ReaderService extends \Stripe\Service\AbstractService
     * Initiates a refund on a Reader.
     *
     * @param string $id
-     * @param null|array $params
+     * @param null|array{amount?: int, charge?: string, expand?: string[], metadata?: array<string, string>, payment_intent?: string, refund_application_fee?: bool, refund_payment_config?: array{enable_customer_cancellation?: bool}, reverse_transfer?: bool} $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Terminal\Reader
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function refundPayment($id, $params = null, $opts = null)
    {
@@ -124,12 +125,12 @@ class ReaderService extends \Stripe\Service\AbstractService
     * Retrieves a <code>Reader</code> object.
     *
     * @param string $id
-     * @param null|array $params
+     * @param null|array{expand?: string[]} $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Terminal\Reader
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function retrieve($id, $params = null, $opts = null)
    {
@@ -140,12 +141,12 @@ class ReaderService extends \Stripe\Service\AbstractService
     * Sets reader display to show cart details.
     *
     * @param string $id
-     * @param null|array $params
+     * @param null|array{cart?: array{currency: string, line_items: array{amount: int, description: string, quantity: int}[], tax?: int, total: int}, expand?: string[], type: string} $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Terminal\Reader
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function setReaderDisplay($id, $params = null, $opts = null)
    {
@@ -157,12 +158,12 @@ class ReaderService extends \Stripe\Service\AbstractService
     * passed. Any parameters not provided will be left unchanged.
     *
     * @param string $id
-     * @param null|array $params
+     * @param null|array{expand?: string[], label?: null|string, metadata?: null|array<string, string>} $params
     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
     *
-     * @throws \Stripe\Exception\ApiErrorException if the request fails
-     *
     * @return \Stripe\Terminal\Reader
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
     */
    public function update($id, $params = null, $opts = null)
    {