feat(api): api update

.stats.yml

@@ -1,3 +1,3 @@
 configured_endpoints: 239
-openapi_spec_hash: 0af65087719d3a94ec028dea0f1f79dc
+openapi_spec_hash: 8962e37e30d3fbd03333290b09948b13
 config_hash: 1ca082e374ef7000e2a5971e8da740e0

src/ACHTransfers/ACHTransfer/Acknowledgement.php

@@ -11,7 +11,7 @@
 /**
  * After the transfer is acknowledged by FedACH, this will contain supplemental details. The Federal Reserve sends an acknowledgement message for each file that Increase submits.
  *
- * @phpstan-type AcknowledgementShape = array{acknowledgedAt: string}
+ * @phpstan-type AcknowledgementShape = array{acknowledgedAt: \DateTimeInterface}
  */
 final class Acknowledgement implements BaseModel
 {
@@ -22,7 +22,7 @@ final class Acknowledgement implements BaseModel
      * When the Federal Reserve acknowledged the submitted file containing this transfer.
      */
     #[Required('acknowledged_at')]
-    public string $acknowledgedAt;
+    public \DateTimeInterface $acknowledgedAt;
 
     /**
      * `new Acknowledgement()` is missing required properties by the API.
@@ -48,7 +48,7 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      */
-    public static function with(string $acknowledgedAt): self
+    public static function with(\DateTimeInterface $acknowledgedAt): self
     {
         $self = new self;
 
@@ -60,7 +60,7 @@ public static function with(string $acknowledgedAt): self
     /**
      * When the Federal Reserve acknowledged the submitted file containing this transfer.
      */
-    public function withAcknowledgedAt(string $acknowledgedAt): self
+    public function withAcknowledgedAt(\DateTimeInterface $acknowledgedAt): self
     {
         $self = clone $this;
         $self['acknowledgedAt'] = $acknowledgedAt;

src/CardPayments/CardPayment/Element/CardDecline/RealTimeDecisionReason.php

@@ -19,5 +19,7 @@ enum RealTimeDecisionReason: string
 
     case SUSPECTED_FRAUD = 'suspected_fraud';
 
+    case ADDITIONAL_CUSTOMER_AUTHENTICATION_REQUIRED = 'additional_customer_authentication_required';
+
     case OTHER = 'other';
 }

src/DeclinedTransactions/DeclinedTransaction/Source/CardDecline/RealTimeDecisionReason.php

@@ -19,5 +19,7 @@ enum RealTimeDecisionReason: string
 
     case SUSPECTED_FRAUD = 'suspected_fraud';
 
+    case ADDITIONAL_CUSTOMER_AUTHENTICATION_REQUIRED = 'additional_customer_authentication_required';
+
     case OTHER = 'other';
 }

src/DigitalWalletTokens/DigitalWalletToken/Decline/Reason.php

@@ -20,4 +20,10 @@ enum Reason: string
     case INCORRECT_CARD_VERIFICATION_CODE = 'incorrect_card_verification_code';
 
     case DECLINED_BY_TOKEN_REQUESTOR = 'declined_by_token_requestor';
+
+    case GROUP_LOCKED = 'group_locked';
+
+    case ACCOUNT_CLOSED = 'account_closed';
+
+    case ENTITY_NOT_ACTIVE = 'entity_not_active';
 }

src/Exports/Export/Category.php

@@ -9,33 +9,33 @@
  */
 enum Category: string
 {
-    case ACCOUNT_STATEMENT_OFX = 'account_statement_ofx';
-
     case ACCOUNT_STATEMENT_BAI2 = 'account_statement_bai2';
 
-    case TRANSACTION_CSV = 'transaction_csv';
+    case ACCOUNT_STATEMENT_OFX = 'account_statement_ofx';
+
+    case ACCOUNT_VERIFICATION_LETTER = 'account_verification_letter';
 
     case BALANCE_CSV = 'balance_csv';
 
     case BOOKKEEPING_ACCOUNT_BALANCE_CSV = 'bookkeeping_account_balance_csv';
 
-    case ENTITY_CSV = 'entity_csv';
-
-    case VENDOR_CSV = 'vendor_csv';
+    case DAILY_ACCOUNT_BALANCE_CSV = 'daily_account_balance_csv';
 
     case DASHBOARD_TABLE_CSV = 'dashboard_table_csv';
 
-    case ACCOUNT_VERIFICATION_LETTER = 'account_verification_letter';
+    case ENTITY_CSV = 'entity_csv';
 
-    case FUNDING_INSTRUCTIONS = 'funding_instructions';
+    case FEE_CSV = 'fee_csv';
 
     case FORM_1099_INT = 'form_1099_int';
 
     case FORM_1099_MISC = 'form_1099_misc';
 
-    case FEE_CSV = 'fee_csv';
+    case FUNDING_INSTRUCTIONS = 'funding_instructions';
 
-    case VOIDED_CHECK = 'voided_check';
+    case TRANSACTION_CSV = 'transaction_csv';
 
-    case DAILY_ACCOUNT_BALANCE_CSV = 'daily_account_balance_csv';
+    case VENDOR_CSV = 'vendor_csv';
+
+    case VOIDED_CHECK = 'voided_check';
 }

src/Exports/ExportCreateParams/Category.php

@@ -9,27 +9,27 @@
  */
 enum Category: string
 {
-    case ACCOUNT_STATEMENT_OFX = 'account_statement_ofx';
-
     case ACCOUNT_STATEMENT_BAI2 = 'account_statement_bai2';
 
-    case TRANSACTION_CSV = 'transaction_csv';
+    case ACCOUNT_STATEMENT_OFX = 'account_statement_ofx';
+
+    case ACCOUNT_VERIFICATION_LETTER = 'account_verification_letter';
 
     case BALANCE_CSV = 'balance_csv';
 
     case BOOKKEEPING_ACCOUNT_BALANCE_CSV = 'bookkeeping_account_balance_csv';
 
-    case ENTITY_CSV = 'entity_csv';
+    case DAILY_ACCOUNT_BALANCE_CSV = 'daily_account_balance_csv';
 
-    case VENDOR_CSV = 'vendor_csv';
+    case ENTITY_CSV = 'entity_csv';
 
-    case ACCOUNT_VERIFICATION_LETTER = 'account_verification_letter';
+    case FEE_CSV = 'fee_csv';
 
     case FUNDING_INSTRUCTIONS = 'funding_instructions';
 
-    case FEE_CSV = 'fee_csv';
+    case TRANSACTION_CSV = 'transaction_csv';
 
-    case VOIDED_CHECK = 'voided_check';
+    case VENDOR_CSV = 'vendor_csv';
 
-    case DAILY_ACCOUNT_BALANCE_CSV = 'daily_account_balance_csv';
+    case VOIDED_CHECK = 'voided_check';
 }

src/Exports/ExportListParams/Category.php

@@ -9,33 +9,33 @@
  */
 enum Category: string
 {
-    case ACCOUNT_STATEMENT_OFX = 'account_statement_ofx';
-
     case ACCOUNT_STATEMENT_BAI2 = 'account_statement_bai2';
 
-    case TRANSACTION_CSV = 'transaction_csv';
+    case ACCOUNT_STATEMENT_OFX = 'account_statement_ofx';
+
+    case ACCOUNT_VERIFICATION_LETTER = 'account_verification_letter';
 
     case BALANCE_CSV = 'balance_csv';
 
     case BOOKKEEPING_ACCOUNT_BALANCE_CSV = 'bookkeeping_account_balance_csv';
 
-    case ENTITY_CSV = 'entity_csv';
-
-    case VENDOR_CSV = 'vendor_csv';
+    case DAILY_ACCOUNT_BALANCE_CSV = 'daily_account_balance_csv';
 
     case DASHBOARD_TABLE_CSV = 'dashboard_table_csv';
 
-    case ACCOUNT_VERIFICATION_LETTER = 'account_verification_letter';
+    case ENTITY_CSV = 'entity_csv';
 
-    case FUNDING_INSTRUCTIONS = 'funding_instructions';
+    case FEE_CSV = 'fee_csv';
 
     case FORM_1099_INT = 'form_1099_int';
 
     case FORM_1099_MISC = 'form_1099_misc';
 
-    case FEE_CSV = 'fee_csv';
+    case FUNDING_INSTRUCTIONS = 'funding_instructions';
 
-    case VOIDED_CHECK = 'voided_check';
+    case TRANSACTION_CSV = 'transaction_csv';
 
-    case DAILY_ACCOUNT_BALANCE_CSV = 'daily_account_balance_csv';
+    case VENDOR_CSV = 'vendor_csv';
+
+    case VOIDED_CHECK = 'voided_check';
 }

src/InboundWireTransfers/InboundWireTransfer.php

@@ -39,6 +39,7 @@
  *   endToEndIdentification: string|null,
  *   inputMessageAccountabilityData: string|null,
  *   instructingAgentRoutingNumber: string|null,
+ *   instructionForCreditorAgent: string|null,
  *   instructionIdentification: string|null,
  *   purpose: string|null,
  *   reversal: null|Reversal|ReversalShape,
@@ -174,6 +175,12 @@ final class InboundWireTransfer implements BaseModel
     #[Required('instructing_agent_routing_number')]
     public ?string $instructingAgentRoutingNumber;
 
+    /**
+     * A free-form instruction for the receiving bank set by the sender.
+     */
+    #[Required('instruction_for_creditor_agent')]
+    public ?string $instructionForCreditorAgent;
+
     /**
      * The sending bank's identifier for the wire transfer.
      */
@@ -252,6 +259,7 @@ final class InboundWireTransfer implements BaseModel
      *   endToEndIdentification: ...,
      *   inputMessageAccountabilityData: ...,
      *   instructingAgentRoutingNumber: ...,
+     *   instructionForCreditorAgent: ...,
      *   instructionIdentification: ...,
      *   purpose: ...,
      *   reversal: ...,
@@ -287,6 +295,7 @@ final class InboundWireTransfer implements BaseModel
      *   ->withEndToEndIdentification(...)
      *   ->withInputMessageAccountabilityData(...)
      *   ->withInstructingAgentRoutingNumber(...)
+     *   ->withInstructionForCreditorAgent(...)
      *   ->withInstructionIdentification(...)
      *   ->withPurpose(...)
      *   ->withReversal(...)
@@ -333,6 +342,7 @@ public static function with(
         ?string $endToEndIdentification,
         ?string $inputMessageAccountabilityData,
         ?string $instructingAgentRoutingNumber,
+        ?string $instructionForCreditorAgent,
         ?string $instructionIdentification,
         ?string $purpose,
         Reversal|array|null $reversal,
@@ -364,6 +374,7 @@ public static function with(
         $self['endToEndIdentification'] = $endToEndIdentification;
         $self['inputMessageAccountabilityData'] = $inputMessageAccountabilityData;
         $self['instructingAgentRoutingNumber'] = $instructingAgentRoutingNumber;
+        $self['instructionForCreditorAgent'] = $instructionForCreditorAgent;
         $self['instructionIdentification'] = $instructionIdentification;
         $self['purpose'] = $purpose;
         $self['reversal'] = $reversal;
@@ -604,6 +615,18 @@ public function withInstructingAgentRoutingNumber(
         return $self;
     }
 
+    /**
+     * A free-form instruction for the receiving bank set by the sender.
+     */
+    public function withInstructionForCreditorAgent(
+        ?string $instructionForCreditorAgent
+    ): self {
+        $self = clone $this;
+        $self['instructionForCreditorAgent'] = $instructionForCreditorAgent;
+
+        return $self;
+    }
+
     /**
      * The sending bank's identifier for the wire transfer.
      */

src/RealTimeDecisions/RealTimeDecision/CardAuthorization/Decline/Reason.php

@@ -19,5 +19,7 @@ enum Reason: string
 
     case SUSPECTED_FRAUD = 'suspected_fraud';
 
+    case ADDITIONAL_CUSTOMER_AUTHENTICATION_REQUIRED = 'additional_customer_authentication_required';
+
     case OTHER = 'other';
 }

src/RealTimeDecisions/RealTimeDecisionActionParams/CardAuthorization/Decline/Reason.php

@@ -19,5 +19,7 @@ enum Reason: string
 
     case SUSPECTED_FRAUD = 'suspected_fraud';
 
+    case ADDITIONAL_CUSTOMER_AUTHENTICATION_REQUIRED = 'additional_customer_authentication_required';
+
     case OTHER = 'other';
 }

src/Simulations/DigitalWalletTokenRequests/DigitalWalletTokenRequestNewResponse/DeclineReason.php

@@ -20,4 +20,10 @@ enum DeclineReason: string
     case INCORRECT_CARD_VERIFICATION_CODE = 'incorrect_card_verification_code';
 
     case DECLINED_BY_TOKEN_REQUESTOR = 'declined_by_token_requestor';
+
+    case GROUP_LOCKED = 'group_locked';
+
+    case ACCOUNT_CLOSED = 'account_closed';
+
+    case ENTITY_NOT_ACTIVE = 'entity_not_active';
 }

src/Transactions/Transaction/Source/InboundWireTransfer.php

@@ -25,6 +25,7 @@
  *   endToEndIdentification: string|null,
  *   inputMessageAccountabilityData: string|null,
  *   instructingAgentRoutingNumber: string|null,
+ *   instructionForCreditorAgent: string|null,
  *   instructionIdentification: string|null,
  *   purpose: string|null,
  *   transferID: string,
@@ -115,6 +116,12 @@ final class InboundWireTransfer implements BaseModel
     #[Required('instructing_agent_routing_number')]
     public ?string $instructingAgentRoutingNumber;
 
+    /**
+     * A free-form instruction for the receiving bank set by the sender.
+     */
+    #[Required('instruction_for_creditor_agent')]
+    public ?string $instructionForCreditorAgent;
+
     /**
      * The sending bank's identifier for the wire transfer.
      */
@@ -164,6 +171,7 @@ final class InboundWireTransfer implements BaseModel
      *   endToEndIdentification: ...,
      *   inputMessageAccountabilityData: ...,
      *   instructingAgentRoutingNumber: ...,
+     *   instructionForCreditorAgent: ...,
      *   instructionIdentification: ...,
      *   purpose: ...,
      *   transferID: ...,
@@ -189,6 +197,7 @@ final class InboundWireTransfer implements BaseModel
      *   ->withEndToEndIdentification(...)
      *   ->withInputMessageAccountabilityData(...)
      *   ->withInstructingAgentRoutingNumber(...)
+     *   ->withInstructionForCreditorAgent(...)
      *   ->withInstructionIdentification(...)
      *   ->withPurpose(...)
      *   ->withTransferID(...)
@@ -220,6 +229,7 @@ public static function with(
         ?string $endToEndIdentification,
         ?string $inputMessageAccountabilityData,
         ?string $instructingAgentRoutingNumber,
+        ?string $instructionForCreditorAgent,
         ?string $instructionIdentification,
         ?string $purpose,
         string $transferID,
@@ -241,6 +251,7 @@ public static function with(
         $self['endToEndIdentification'] = $endToEndIdentification;
         $self['inputMessageAccountabilityData'] = $inputMessageAccountabilityData;
         $self['instructingAgentRoutingNumber'] = $instructingAgentRoutingNumber;
+        $self['instructionForCreditorAgent'] = $instructionForCreditorAgent;
         $self['instructionIdentification'] = $instructionIdentification;
         $self['purpose'] = $purpose;
         $self['transferID'] = $transferID;
@@ -399,6 +410,18 @@ public function withInstructingAgentRoutingNumber(
         return $self;
     }
 
+    /**
+     * A free-form instruction for the receiving bank set by the sender.
+     */
+    public function withInstructionForCreditorAgent(
+        ?string $instructionForCreditorAgent
+    ): self {
+        $self = clone $this;
+        $self['instructionForCreditorAgent'] = $instructionForCreditorAgent;
+
+        return $self;
+    }
+
     /**
      * The sending bank's identifier for the wire transfer.
      */