feat(api): api update

.stats.yml

@@ -1,3 +1,3 @@
 configured_endpoints: 254
-openapi_spec_hash: b502688710d2e1e332c41ca7adc8aabf
+openapi_spec_hash: a6d6062cde69c6bab7fa00f29d8508d4
 config_hash: f0e1844d06c76a9e145f7986d993dda6

README.md

@@ -120,7 +120,7 @@ Error codes are as follows:
 
 Certain errors will be automatically retried 2 times by default, with a short exponential backoff.
 
-Connection errors (for example, due to a network connectivity problem), 408 Request Timeout, 409 Conflict, 429 Rate Limit, >=500 Internal errors, and timeouts will all be retried by default.
+Connection errors (for example, due to a network connectivity problem), 408 Request Timeout, 429 Rate Limit, >=500 Internal errors, and timeouts will all be retried by default.
 
 You can use the `maxRetries` option to configure or disable this:
 

src/CardPayments/CardPayment/Element/CardAuthorization/SchemeFee/FeeType.php

@@ -66,4 +66,6 @@ enum FeeType: string
     case VISA_PROCESSING_GUARANTEE_COMMERCIAL_CREDIT = 'visa_processing_guarantee_commercial_credit';
 
     case PULSE_SWITCH_FEE = 'pulse_switch_fee';
+
+    case PULSE_TOKENIZATION_FEE = 'pulse_tokenization_fee';
 }

src/CardPayments/CardPayment/Element/CardBalanceInquiry/SchemeFee/FeeType.php

@@ -66,4 +66,6 @@ enum FeeType: string
     case VISA_PROCESSING_GUARANTEE_COMMERCIAL_CREDIT = 'visa_processing_guarantee_commercial_credit';
 
     case PULSE_SWITCH_FEE = 'pulse_switch_fee';
+
+    case PULSE_TOKENIZATION_FEE = 'pulse_tokenization_fee';
 }

src/CardPayments/CardPayment/Element/CardDecline/SchemeFee/FeeType.php

@@ -66,4 +66,6 @@ enum FeeType: string
     case VISA_PROCESSING_GUARANTEE_COMMERCIAL_CREDIT = 'visa_processing_guarantee_commercial_credit';
 
     case PULSE_SWITCH_FEE = 'pulse_switch_fee';
+
+    case PULSE_TOKENIZATION_FEE = 'pulse_tokenization_fee';
 }

src/CardPayments/CardPayment/Element/CardFinancial/SchemeFee/FeeType.php

@@ -66,4 +66,6 @@ enum FeeType: string
     case VISA_PROCESSING_GUARANTEE_COMMERCIAL_CREDIT = 'visa_processing_guarantee_commercial_credit';
 
     case PULSE_SWITCH_FEE = 'pulse_switch_fee';
+
+    case PULSE_TOKENIZATION_FEE = 'pulse_tokenization_fee';
 }

src/CardPayments/CardPayment/Element/CardFuelConfirmation/SchemeFee/FeeType.php

@@ -66,4 +66,6 @@ enum FeeType: string
     case VISA_PROCESSING_GUARANTEE_COMMERCIAL_CREDIT = 'visa_processing_guarantee_commercial_credit';
 
     case PULSE_SWITCH_FEE = 'pulse_switch_fee';
+
+    case PULSE_TOKENIZATION_FEE = 'pulse_tokenization_fee';
 }

src/CardPayments/CardPayment/Element/CardIncrement/SchemeFee/FeeType.php

@@ -66,4 +66,6 @@ enum FeeType: string
     case VISA_PROCESSING_GUARANTEE_COMMERCIAL_CREDIT = 'visa_processing_guarantee_commercial_credit';
 
     case PULSE_SWITCH_FEE = 'pulse_switch_fee';
+
+    case PULSE_TOKENIZATION_FEE = 'pulse_tokenization_fee';
 }

src/CardPayments/CardPayment/Element/CardRefund/PurchaseDetails/PurchaseIdentifierFormat.php

@@ -18,4 +18,6 @@ enum PurchaseIdentifierFormat: string
     case HOTEL_FOLIO_NUMBER = 'hotel_folio_number';
 
     case INVOICE_NUMBER = 'invoice_number';
+
+    case VISA_RECURRENT_REFERENCE_IDENTIFIER = 'visa_recurrent_reference_identifier';
 }

src/CardPayments/CardPayment/Element/CardRefund/SchemeFee/FeeType.php

@@ -66,4 +66,6 @@ enum FeeType: string
     case VISA_PROCESSING_GUARANTEE_COMMERCIAL_CREDIT = 'visa_processing_guarantee_commercial_credit';
 
     case PULSE_SWITCH_FEE = 'pulse_switch_fee';
+
+    case PULSE_TOKENIZATION_FEE = 'pulse_tokenization_fee';
 }

src/CardPayments/CardPayment/Element/CardReversal/SchemeFee/FeeType.php

@@ -66,4 +66,6 @@ enum FeeType: string
     case VISA_PROCESSING_GUARANTEE_COMMERCIAL_CREDIT = 'visa_processing_guarantee_commercial_credit';
 
     case PULSE_SWITCH_FEE = 'pulse_switch_fee';
+
+    case PULSE_TOKENIZATION_FEE = 'pulse_tokenization_fee';
 }

src/CardPayments/CardPayment/Element/CardSettlement/PurchaseDetails/PurchaseIdentifierFormat.php

@@ -18,4 +18,6 @@ enum PurchaseIdentifierFormat: string
     case HOTEL_FOLIO_NUMBER = 'hotel_folio_number';
 
     case INVOICE_NUMBER = 'invoice_number';
+
+    case VISA_RECURRENT_REFERENCE_IDENTIFIER = 'visa_recurrent_reference_identifier';
 }

src/CardPayments/CardPayment/Element/CardSettlement/SchemeFee/FeeType.php

@@ -66,4 +66,6 @@ enum FeeType: string
     case VISA_PROCESSING_GUARANTEE_COMMERCIAL_CREDIT = 'visa_processing_guarantee_commercial_credit';
 
     case PULSE_SWITCH_FEE = 'pulse_switch_fee';
+
+    case PULSE_TOKENIZATION_FEE = 'pulse_tokenization_fee';
 }

src/CardPayments/CardPayment/Element/CardValidation/SchemeFee/FeeType.php

@@ -66,4 +66,6 @@ enum FeeType: string
     case VISA_PROCESSING_GUARANTEE_COMMERCIAL_CREDIT = 'visa_processing_guarantee_commercial_credit';
 
     case PULSE_SWITCH_FEE = 'pulse_switch_fee';
+
+    case PULSE_TOKENIZATION_FEE = 'pulse_tokenization_fee';
 }

src/CheckDeposits/CheckDeposit/DepositAdjustment/Reason.php

@@ -16,4 +16,6 @@ enum Reason: string
     case NON_CONFORMING_ITEM = 'non_conforming_item';
 
     case PAID = 'paid';
+
+    case DUPLICATE_ENTRY = 'duplicate_entry';
 }

src/Core/BaseClient.php

@@ -224,7 +224,7 @@ protected function shouldRetry(
         }
 
         $code = $rsp?->getStatusCode();
-        if (408 == $code || 409 == $code || 429 == $code || $code >= 500) {
+        if (408 == $code || 429 == $code || $code >= 500) {
             return true;
         }
 

src/DeclinedTransactions/DeclinedTransaction/Source/CardDecline/SchemeFee/FeeType.php

@@ -66,4 +66,6 @@ enum FeeType: string
     case VISA_PROCESSING_GUARANTEE_COMMERCIAL_CREDIT = 'visa_processing_guarantee_commercial_credit';
 
     case PULSE_SWITCH_FEE = 'pulse_switch_fee';
+
+    case PULSE_TOKENIZATION_FEE = 'pulse_tokenization_fee';
 }

src/EventSubscriptions/EventSubscription/SelectedEventCategory/EventCategory.php

@@ -85,6 +85,8 @@ enum EventCategory: string
 
     case DIGITAL_WALLET_TOKEN_UPDATED = 'digital_wallet_token.updated';
 
+    case DIGITAL_WALLET_TOKEN_REQUEST_CREATED = 'digital_wallet_token_request.created';
+
     case ENTITY_CREATED = 'entity.created';
 
     case ENTITY_UPDATED = 'entity.updated';

src/EventSubscriptions/EventSubscriptionCreateParams/SelectedEventCategory/EventCategory.php

@@ -85,6 +85,8 @@ enum EventCategory: string
 
     case DIGITAL_WALLET_TOKEN_UPDATED = 'digital_wallet_token.updated';
 
+    case DIGITAL_WALLET_TOKEN_REQUEST_CREATED = 'digital_wallet_token_request.created';
+
     case ENTITY_CREATED = 'entity.created';
 
     case ENTITY_UPDATED = 'entity.updated';

src/Events/Event/Category.php

@@ -85,6 +85,8 @@ enum Category: string
 
     case DIGITAL_WALLET_TOKEN_UPDATED = 'digital_wallet_token.updated';
 
+    case DIGITAL_WALLET_TOKEN_REQUEST_CREATED = 'digital_wallet_token_request.created';
+
     case ENTITY_CREATED = 'entity.created';
 
     case ENTITY_UPDATED = 'entity.updated';

src/Events/EventListParams.php

@@ -55,7 +55,7 @@ final class EventListParams implements BaseModel
     public ?string $cursor;
 
     /**
-     * Limit the size of the list that is returned. The default (and maximum) is 100 objects.
+     * Limit the size of the list that is returned. The default is 100 objects and the maximum is 1,000.
      *
      * Defaults to `100`.
      */
@@ -144,7 +144,7 @@ public function withCursor(string $cursor): self
     }
 
     /**
-     * Limit the size of the list that is returned. The default (and maximum) is 100 objects.
+     * Limit the size of the list that is returned. The default is 100 objects and the maximum is 1,000.
      *
      * Defaults to `100`.
      */

src/Events/EventListParams/Category/In.php

@@ -82,6 +82,8 @@ enum In: string
 
     case DIGITAL_WALLET_TOKEN_UPDATED = 'digital_wallet_token.updated';
 
+    case DIGITAL_WALLET_TOKEN_REQUEST_CREATED = 'digital_wallet_token_request.created';
+
     case ENTITY_CREATED = 'entity.created';
 
     case ENTITY_UPDATED = 'entity.updated';

src/Events/UnwrapWebhookEvent/Category.php

@@ -85,6 +85,8 @@ enum Category: string
 
     case DIGITAL_WALLET_TOKEN_UPDATED = 'digital_wallet_token.updated';
 
+    case DIGITAL_WALLET_TOKEN_REQUEST_CREATED = 'digital_wallet_token_request.created';
+
     case ENTITY_CREATED = 'entity.created';
 
     case ENTITY_UPDATED = 'entity.updated';

src/InboundCheckDeposits/InboundCheckDeposit.php

@@ -28,7 +28,7 @@
  *   adjustments: list<Adjustment|AdjustmentShape>,
  *   amount: int,
  *   automaticallyResolvesAt: \DateTimeInterface,
- *   backImageFileID: string|null,
+ *   backImageFileID: string,
  *   bankOfFirstDepositRoutingNumber: string|null,
  *   checkNumber: string|null,
  *   checkTransferID: string|null,
@@ -37,7 +37,7 @@
  *   declinedAt: \DateTimeInterface|null,
  *   declinedTransactionID: string|null,
  *   depositReturn: null|DepositReturn|DepositReturnShape,
- *   frontImageFileID: string|null,
+ *   frontImageFileID: string,
  *   payeeNameAnalysis: PayeeNameAnalysis|value-of<PayeeNameAnalysis>,
  *   status: Status|value-of<Status>,
  *   transactionID: string|null,
@@ -97,7 +97,7 @@ final class InboundCheckDeposit implements BaseModel
      * The ID for the File containing the image of the back of the check.
      */
     #[Required('back_image_file_id')]
-    public ?string $backImageFileID;
+    public string $backImageFileID;
 
     /**
      * The American Bankers' Association (ABA) Routing Transit Number (RTN) for the bank depositing this check. In some rare cases, this is not transmitted via Check 21 and the value will be null.
@@ -153,7 +153,7 @@ final class InboundCheckDeposit implements BaseModel
      * The ID for the File containing the image of the front of the check.
      */
     #[Required('front_image_file_id')]
-    public ?string $frontImageFileID;
+    public string $frontImageFileID;
 
     /**
      * Whether the details on the check match the recipient name of the check transfer. This is an optional feature, contact sales to enable.
@@ -267,7 +267,7 @@ public static function with(
         array $adjustments,
         int $amount,
         \DateTimeInterface $automaticallyResolvesAt,
-        ?string $backImageFileID,
+        string $backImageFileID,
         ?string $bankOfFirstDepositRoutingNumber,
         ?string $checkNumber,
         ?string $checkTransferID,
@@ -276,7 +276,7 @@ public static function with(
         ?\DateTimeInterface $declinedAt,
         ?string $declinedTransactionID,
         DepositReturn|array|null $depositReturn,
-        ?string $frontImageFileID,
+        string $frontImageFileID,
         PayeeNameAnalysis|string $payeeNameAnalysis,
         Status|string $status,
         ?string $transactionID,
@@ -392,7 +392,7 @@ public function withAutomaticallyResolvesAt(
     /**
      * The ID for the File containing the image of the back of the check.
      */
-    public function withBackImageFileID(?string $backImageFileID): self
+    public function withBackImageFileID(string $backImageFileID): self
     {
         $self = clone $this;
         $self['backImageFileID'] = $backImageFileID;
@@ -498,7 +498,7 @@ public function withDepositReturn(
     /**
      * The ID for the File containing the image of the front of the check.
      */
-    public function withFrontImageFileID(?string $frontImageFileID): self
+    public function withFrontImageFileID(string $frontImageFileID): self
     {
         $self = clone $this;
         $self['frontImageFileID'] = $frontImageFileID;

src/InboundCheckDeposits/InboundCheckDeposit/Adjustment/Reason.php

@@ -12,4 +12,6 @@ enum Reason: string
     case LATE_RETURN = 'late_return';
 
     case WRONG_PAYEE_CREDIT = 'wrong_payee_credit';
+
+    case DUPLICATE_ENTRY = 'duplicate_entry';
 }

src/PendingTransactions/PendingTransaction.php

@@ -52,7 +52,7 @@ final class PendingTransaction implements BaseModel
     public string $accountID;
 
     /**
-     * The Pending Transaction amount in the minor unit of its currency. 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`.
+     * The Pending Transaction amount in the minor unit of its currency. For dollars, for example, this is cents. For a card authorization this is the amount still held: it decreases when the merchant reverses or partially settles the authorization. The amount that settled is available on the resulting Transaction and on the Card Payment's `state.settled_amount`.
      */
     #[Required]
     public int $amount;
@@ -239,7 +239,7 @@ public function withAccountID(string $accountID): self
     }
 
     /**
-     * The Pending Transaction amount in the minor unit of its currency. 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`.
+     * The Pending Transaction amount in the minor unit of its currency. For dollars, for example, this is cents. For a card authorization this is the amount still held: it decreases when the merchant reverses or partially settles the authorization. The amount that settled is available on the resulting Transaction and on the Card Payment's `state.settled_amount`.
      */
     public function withAmount(int $amount): self
     {

src/PendingTransactions/PendingTransaction/Source/CardAuthorization/SchemeFee/FeeType.php

@@ -66,4 +66,6 @@ enum FeeType: string
     case VISA_PROCESSING_GUARANTEE_COMMERCIAL_CREDIT = 'visa_processing_guarantee_commercial_credit';
 
     case PULSE_SWITCH_FEE = 'pulse_switch_fee';
+
+    case PULSE_TOKENIZATION_FEE = 'pulse_tokenization_fee';
 }

src/ServiceContracts/EventsContract.php

@@ -42,7 +42,7 @@ public function retrieve(
      * @param Category|CategoryShape $category
      * @param CreatedAt|CreatedAtShape $createdAt
      * @param string $cursor return the page of entries after this one
-     * @param int $limit Limit the size of the list that is returned. The default (and maximum) is 100 objects.
+     * @param int $limit Limit the size of the list that is returned. The default is 100 objects and the maximum is 1,000.
      *
      * Defaults to `100`.
      * @param OrderBy|OrderByShape $orderBy

src/Services/EventsService.php

@@ -70,7 +70,7 @@ public function retrieve(
      * @param Category|CategoryShape $category
      * @param CreatedAt|CreatedAtShape $createdAt
      * @param string $cursor return the page of entries after this one
-     * @param int $limit Limit the size of the list that is returned. The default (and maximum) is 100 objects.
+     * @param int $limit Limit the size of the list that is returned. The default is 100 objects and the maximum is 1,000.
      *
      * Defaults to `100`.
      * @param OrderBy|OrderByShape $orderBy

src/Simulations/CheckDeposits/CheckDepositAdjustmentParams/Reason.php

@@ -18,4 +18,6 @@ enum Reason: string
     case NON_CONFORMING_ITEM = 'non_conforming_item';
 
     case PAID = 'paid';
+
+    case DUPLICATE_ENTRY = 'duplicate_entry';
 }

src/Simulations/InboundCheckDeposits/InboundCheckDepositAdjustmentParams/Reason.php

@@ -12,4 +12,6 @@ enum Reason: string
     case LATE_RETURN = 'late_return';
 
     case WRONG_PAYEE_CREDIT = 'wrong_payee_credit';
+
+    case DUPLICATE_ENTRY = 'duplicate_entry';
 }

src/Transactions/Transaction/Source/CardFinancial/SchemeFee/FeeType.php

@@ -66,4 +66,6 @@ enum FeeType: string
     case VISA_PROCESSING_GUARANTEE_COMMERCIAL_CREDIT = 'visa_processing_guarantee_commercial_credit';
 
     case PULSE_SWITCH_FEE = 'pulse_switch_fee';
+
+    case PULSE_TOKENIZATION_FEE = 'pulse_tokenization_fee';
 }

src/Transactions/Transaction/Source/CardRefund/PurchaseDetails/PurchaseIdentifierFormat.php

@@ -18,4 +18,6 @@ enum PurchaseIdentifierFormat: string
     case HOTEL_FOLIO_NUMBER = 'hotel_folio_number';
 
     case INVOICE_NUMBER = 'invoice_number';
+
+    case VISA_RECURRENT_REFERENCE_IDENTIFIER = 'visa_recurrent_reference_identifier';
 }

src/Transactions/Transaction/Source/CardRefund/SchemeFee/FeeType.php

@@ -66,4 +66,6 @@ enum FeeType: string
     case VISA_PROCESSING_GUARANTEE_COMMERCIAL_CREDIT = 'visa_processing_guarantee_commercial_credit';
 
     case PULSE_SWITCH_FEE = 'pulse_switch_fee';
+
+    case PULSE_TOKENIZATION_FEE = 'pulse_tokenization_fee';
 }

src/Transactions/Transaction/Source/CardSettlement/PurchaseDetails/PurchaseIdentifierFormat.php

@@ -18,4 +18,6 @@ enum PurchaseIdentifierFormat: string
     case HOTEL_FOLIO_NUMBER = 'hotel_folio_number';
 
     case INVOICE_NUMBER = 'invoice_number';
+
+    case VISA_RECURRENT_REFERENCE_IDENTIFIER = 'visa_recurrent_reference_identifier';
 }

src/Transactions/Transaction/Source/CardSettlement/SchemeFee/FeeType.php

@@ -66,4 +66,6 @@ enum FeeType: string
     case VISA_PROCESSING_GUARANTEE_COMMERCIAL_CREDIT = 'visa_processing_guarantee_commercial_credit';
 
     case PULSE_SWITCH_FEE = 'pulse_switch_fee';
+
+    case PULSE_TOKENIZATION_FEE = 'pulse_tokenization_fee';
 }

src/Transactions/Transaction/Source/InboundCheckAdjustment/Reason.php

@@ -18,4 +18,6 @@ enum Reason: string
     case NON_CONFORMING_ITEM = 'non_conforming_item';
 
     case PAID = 'paid';
+
+    case DUPLICATE_ENTRY = 'duplicate_entry';
 }

tests/Services/SwiftTransfersTest.php

@@ -84,7 +84,7 @@ public function testCreateWithOptionalParams(): void
             instructedCurrency: 'USD',
             sourceAccountNumberID: 'account_number_v18nkfqm6afpsrvy82b2',
             unstructuredRemittanceInformation: 'New Swift transfer',
-            intermediaryBankIdentificationCode: 'SEWBFL97',
+            intermediaryBankIdentificationCode: 'SEWBFL3A',
             requireApproval: true,
             routingNumber: 'sq',
         );