feat(api)!: add swift intermediary bic and inbound rtp request events

.stats.yml

@@ -1,3 +1,3 @@
 configured_endpoints: 238
-openapi_spec_hash: 244db0c7a39ae8fff699dccda50b79bd
+openapi_spec_hash: e4d952e002a6918c971f6b5a3702708a
 config_hash: 2ae0d8aaecf01b38cbf9f9e112822c23

src/CheckTransfers/CheckTransfer/PhysicalCheck.php

@@ -114,7 +114,7 @@ final class PhysicalCheck implements BaseModel
     public Signature $signature;
 
     /**
-     * Tracking updates relating to the physical check's delivery.
+     * Tracking updates relating to the physical check's delivery. Sorted by `created_at` in ascending order.
      *
      * @var list<TrackingUpdate> $trackingUpdates
      */
@@ -345,7 +345,7 @@ public function withSignature(Signature|array $signature): self
     }
 
     /**
-     * Tracking updates relating to the physical check's delivery.
+     * Tracking updates relating to the physical check's delivery. Sorted by `created_at` in ascending order.
      *
      * @param list<TrackingUpdate|TrackingUpdateShape> $trackingUpdates
      */

src/Client.php

@@ -401,7 +401,7 @@ public function __construct(
             'Accept' => 'application/json',
             'User-Agent' => sprintf('increase/PHP %s', VERSION),
             'X-Stainless-Lang' => 'php',
-            'X-Stainless-Package-Version' => '0.138.0',
+            'X-Stainless-Package-Version' => '0.139.0',
             'X-Stainless-Arch' => Util::machtype(),
             'X-Stainless-OS' => Util::ostype(),
             'X-Stainless-Runtime' => php_sapi_name(),

src/EventSubscriptions/EventSubscription/SelectedEventCategory/EventCategory.php

@@ -131,6 +131,10 @@ enum EventCategory: string
 
     case INBOUND_MAIL_ITEM_UPDATED = 'inbound_mail_item.updated';
 
+    case INBOUND_REAL_TIME_PAYMENTS_REQUEST_FOR_PAYMENT_CREATED = 'inbound_real_time_payments_request_for_payment.created';
+
+    case INBOUND_REAL_TIME_PAYMENTS_REQUEST_FOR_PAYMENT_UPDATED = 'inbound_real_time_payments_request_for_payment.updated';
+
     case INBOUND_REAL_TIME_PAYMENTS_TRANSFER_CREATED = 'inbound_real_time_payments_transfer.created';
 
     case INBOUND_REAL_TIME_PAYMENTS_TRANSFER_UPDATED = 'inbound_real_time_payments_transfer.updated';

src/EventSubscriptions/EventSubscriptionCreateParams/SelectedEventCategory/EventCategory.php

@@ -131,6 +131,10 @@ enum EventCategory: string
 
     case INBOUND_MAIL_ITEM_UPDATED = 'inbound_mail_item.updated';
 
+    case INBOUND_REAL_TIME_PAYMENTS_REQUEST_FOR_PAYMENT_CREATED = 'inbound_real_time_payments_request_for_payment.created';
+
+    case INBOUND_REAL_TIME_PAYMENTS_REQUEST_FOR_PAYMENT_UPDATED = 'inbound_real_time_payments_request_for_payment.updated';
+
     case INBOUND_REAL_TIME_PAYMENTS_TRANSFER_CREATED = 'inbound_real_time_payments_transfer.created';
 
     case INBOUND_REAL_TIME_PAYMENTS_TRANSFER_UPDATED = 'inbound_real_time_payments_transfer.updated';

src/Events/Event/Category.php

@@ -131,6 +131,10 @@ enum Category: string
 
     case INBOUND_MAIL_ITEM_UPDATED = 'inbound_mail_item.updated';
 
+    case INBOUND_REAL_TIME_PAYMENTS_REQUEST_FOR_PAYMENT_CREATED = 'inbound_real_time_payments_request_for_payment.created';
+
+    case INBOUND_REAL_TIME_PAYMENTS_REQUEST_FOR_PAYMENT_UPDATED = 'inbound_real_time_payments_request_for_payment.updated';
+
     case INBOUND_REAL_TIME_PAYMENTS_TRANSFER_CREATED = 'inbound_real_time_payments_transfer.created';
 
     case INBOUND_REAL_TIME_PAYMENTS_TRANSFER_UPDATED = 'inbound_real_time_payments_transfer.updated';

src/Events/EventListParams/Category/In.php

@@ -128,6 +128,10 @@ enum In: string
 
     case INBOUND_MAIL_ITEM_UPDATED = 'inbound_mail_item.updated';
 
+    case INBOUND_REAL_TIME_PAYMENTS_REQUEST_FOR_PAYMENT_CREATED = 'inbound_real_time_payments_request_for_payment.created';
+
+    case INBOUND_REAL_TIME_PAYMENTS_REQUEST_FOR_PAYMENT_UPDATED = 'inbound_real_time_payments_request_for_payment.updated';
+
     case INBOUND_REAL_TIME_PAYMENTS_TRANSFER_CREATED = 'inbound_real_time_payments_transfer.created';
 
     case INBOUND_REAL_TIME_PAYMENTS_TRANSFER_UPDATED = 'inbound_real_time_payments_transfer.updated';

src/Events/UnwrapWebhookEvent/Category.php

@@ -131,6 +131,10 @@ enum Category: string
 
     case INBOUND_MAIL_ITEM_UPDATED = 'inbound_mail_item.updated';
 
+    case INBOUND_REAL_TIME_PAYMENTS_REQUEST_FOR_PAYMENT_CREATED = 'inbound_real_time_payments_request_for_payment.created';
+
+    case INBOUND_REAL_TIME_PAYMENTS_REQUEST_FOR_PAYMENT_UPDATED = 'inbound_real_time_payments_request_for_payment.updated';
+
     case INBOUND_REAL_TIME_PAYMENTS_TRANSFER_CREATED = 'inbound_real_time_payments_transfer.created';
 
     case INBOUND_REAL_TIME_PAYMENTS_TRANSFER_UPDATED = 'inbound_real_time_payments_transfer.updated';

src/InboundWireTransfers/InboundWireTransfer.php

@@ -29,10 +29,12 @@
  *   creditorAddressLine2: string|null,
  *   creditorAddressLine3: string|null,
  *   creditorName: string|null,
+ *   debtorAccountNumber: string|null,
  *   debtorAddressLine1: string|null,
  *   debtorAddressLine2: string|null,
  *   debtorAddressLine3: string|null,
  *   debtorName: string|null,
+ *   debtorRoutingNumber: string|null,
  *   description: string,
  *   endToEndIdentification: string|null,
  *   inputMessageAccountabilityData: string|null,
@@ -112,6 +114,12 @@ final class InboundWireTransfer implements BaseModel
     #[Required('creditor_name')]
     public ?string $creditorName;
 
+    /**
+     * The account number of the sender.
+     */
+    #[Required('debtor_account_number')]
+    public ?string $debtorAccountNumber;
+
     /**
      * A free-form address field set by the sender.
      */
@@ -136,6 +144,12 @@ final class InboundWireTransfer implements BaseModel
     #[Required('debtor_name')]
     public ?string $debtorName;
 
+    /**
+     * The American Banking Association (ABA) routing number of the sender.
+     */
+    #[Required('debtor_routing_number')]
+    public ?string $debtorRoutingNumber;
+
     /**
      * An Increase-constructed description of the transfer.
      */
@@ -228,10 +242,12 @@ final class InboundWireTransfer implements BaseModel
      *   creditorAddressLine2: ...,
      *   creditorAddressLine3: ...,
      *   creditorName: ...,
+     *   debtorAccountNumber: ...,
      *   debtorAddressLine1: ...,
      *   debtorAddressLine2: ...,
      *   debtorAddressLine3: ...,
      *   debtorName: ...,
+     *   debtorRoutingNumber: ...,
      *   description: ...,
      *   endToEndIdentification: ...,
      *   inputMessageAccountabilityData: ...,
@@ -261,10 +277,12 @@ final class InboundWireTransfer implements BaseModel
      *   ->withCreditorAddressLine2(...)
      *   ->withCreditorAddressLine3(...)
      *   ->withCreditorName(...)
+     *   ->withDebtorAccountNumber(...)
      *   ->withDebtorAddressLine1(...)
      *   ->withDebtorAddressLine2(...)
      *   ->withDebtorAddressLine3(...)
      *   ->withDebtorName(...)
+     *   ->withDebtorRoutingNumber(...)
      *   ->withDescription(...)
      *   ->withEndToEndIdentification(...)
      *   ->withInputMessageAccountabilityData(...)
@@ -305,10 +323,12 @@ public static function with(
         ?string $creditorAddressLine2,
         ?string $creditorAddressLine3,
         ?string $creditorName,
+        ?string $debtorAccountNumber,
         ?string $debtorAddressLine1,
         ?string $debtorAddressLine2,
         ?string $debtorAddressLine3,
         ?string $debtorName,
+        ?string $debtorRoutingNumber,
         string $description,
         ?string $endToEndIdentification,
         ?string $inputMessageAccountabilityData,
@@ -334,10 +354,12 @@ public static function with(
         $self['creditorAddressLine2'] = $creditorAddressLine2;
         $self['creditorAddressLine3'] = $creditorAddressLine3;
         $self['creditorName'] = $creditorName;
+        $self['debtorAccountNumber'] = $debtorAccountNumber;
         $self['debtorAddressLine1'] = $debtorAddressLine1;
         $self['debtorAddressLine2'] = $debtorAddressLine2;
         $self['debtorAddressLine3'] = $debtorAddressLine3;
         $self['debtorName'] = $debtorName;
+        $self['debtorRoutingNumber'] = $debtorRoutingNumber;
         $self['description'] = $description;
         $self['endToEndIdentification'] = $endToEndIdentification;
         $self['inputMessageAccountabilityData'] = $inputMessageAccountabilityData;
@@ -469,6 +491,17 @@ public function withCreditorName(?string $creditorName): self
         return $self;
     }
 
+    /**
+     * The account number of the sender.
+     */
+    public function withDebtorAccountNumber(?string $debtorAccountNumber): self
+    {
+        $self = clone $this;
+        $self['debtorAccountNumber'] = $debtorAccountNumber;
+
+        return $self;
+    }
+
     /**
      * A free-form address field set by the sender.
      */
@@ -513,6 +546,17 @@ public function withDebtorName(?string $debtorName): self
         return $self;
     }
 
+    /**
+     * The American Banking Association (ABA) routing number of the sender.
+     */
+    public function withDebtorRoutingNumber(?string $debtorRoutingNumber): self
+    {
+        $self = clone $this;
+        $self['debtorRoutingNumber'] = $debtorRoutingNumber;
+
+        return $self;
+    }
+
     /**
      * An Increase-constructed description of the transfer.
      */

src/ServiceContracts/Simulations/CardSettlementsContract.php

@@ -17,16 +17,16 @@ interface CardSettlementsContract
      * @api
      *
      * @param string $cardID the identifier of the Card to create a settlement on
-     * @param string $pendingTransactionID the identifier of the Pending Transaction for the Card Authorization you wish to settle
-     * @param int $amount The amount to be settled. This defaults to the amount of the Pending Transaction being settled.
+     * @param int $amount The amount to be settled. This defaults to the amount of the Pending Transaction being settled, or a random amount if `pending_transaction_id` is not provided.
+     * @param string $pendingTransactionID The identifier of the Pending Transaction for the Card Authorization you wish to settle. If not provided, the settlement will be force posted without a Card Authorization.
      * @param RequestOpts|null $requestOptions
      *
      * @throws APIException
      */
     public function create(
         string $cardID,
-        string $pendingTransactionID,
         ?int $amount = null,
+        ?string $pendingTransactionID = null,
         RequestOptions|array|null $requestOptions = null,
     ): Transaction;
 }

src/ServiceContracts/SwiftTransfersContract.php

@@ -37,6 +37,7 @@ interface SwiftTransfersContract
      * @param InstructedCurrency|value-of<InstructedCurrency> $instructedCurrency The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the instructed amount.
      * @param string $sourceAccountNumberID the Account Number to include in the transfer as the debtor's account number
      * @param string $unstructuredRemittanceInformation unstructured remittance information to include in the transfer
+     * @param string $intermediaryBankIdentificationCode the bank identification code (BIC) of the intermediary bank, if the transfer should be routed through one
      * @param bool $requireApproval whether the transfer requires explicit approval via the dashboard or API
      * @param string $routingNumber The creditor's bank account routing or transit number. Required in certain countries.
      * @param RequestOpts|null $requestOptions
@@ -55,6 +56,7 @@ public function create(
         InstructedCurrency|string $instructedCurrency,
         string $sourceAccountNumberID,
         string $unstructuredRemittanceInformation,
+        ?string $intermediaryBankIdentificationCode = null,
         ?bool $requireApproval = null,
         ?string $routingNumber = null,
         RequestOptions|array|null $requestOptions = null,

src/Services/Simulations/CardSettlementsRawService.php

@@ -29,7 +29,7 @@ public function __construct(private Client $client) {}
      * Simulates the settlement of an authorization by a card acquirer. After a card authorization is created, the merchant will eventually send a settlement. This simulates that event, which may occur many days after the purchase in production. The amount settled can be different from the amount originally authorized, for example, when adding a tip to a restaurant bill.
      *
      * @param array{
-     *   cardID: string, pendingTransactionID: string, amount?: int
+     *   cardID: string, amount?: int, pendingTransactionID?: string
      * }|CardSettlementCreateParams $params
      * @param RequestOpts|null $requestOptions
      *

src/Services/Simulations/CardSettlementsService.php

@@ -35,23 +35,23 @@ public function __construct(private Client $client)
      * Simulates the settlement of an authorization by a card acquirer. After a card authorization is created, the merchant will eventually send a settlement. This simulates that event, which may occur many days after the purchase in production. The amount settled can be different from the amount originally authorized, for example, when adding a tip to a restaurant bill.
      *
      * @param string $cardID the identifier of the Card to create a settlement on
-     * @param string $pendingTransactionID the identifier of the Pending Transaction for the Card Authorization you wish to settle
-     * @param int $amount The amount to be settled. This defaults to the amount of the Pending Transaction being settled.
+     * @param int $amount The amount to be settled. This defaults to the amount of the Pending Transaction being settled, or a random amount if `pending_transaction_id` is not provided.
+     * @param string $pendingTransactionID The identifier of the Pending Transaction for the Card Authorization you wish to settle. If not provided, the settlement will be force posted without a Card Authorization.
      * @param RequestOpts|null $requestOptions
      *
      * @throws APIException
      */
     public function create(
         string $cardID,
-        string $pendingTransactionID,
         ?int $amount = null,
+        ?string $pendingTransactionID = null,
         RequestOptions|array|null $requestOptions = null,
     ): Transaction {
         $params = Util::removeNulls(
             [
                 'cardID' => $cardID,
-                'pendingTransactionID' => $pendingTransactionID,
                 'amount' => $amount,
+                'pendingTransactionID' => $pendingTransactionID,
             ],
         );
 

src/Services/SwiftTransfersRawService.php

@@ -52,6 +52,7 @@ public function __construct(private Client $client) {}
      *   instructedCurrency: InstructedCurrency|value-of<InstructedCurrency>,
      *   sourceAccountNumberID: string,
      *   unstructuredRemittanceInformation: string,
+     *   intermediaryBankIdentificationCode?: string,
      *   requireApproval?: bool,
      *   routingNumber?: string,
      * }|SwiftTransferCreateParams $params

src/Services/SwiftTransfersService.php

@@ -55,6 +55,7 @@ public function __construct(private Client $client)
      * @param InstructedCurrency|value-of<InstructedCurrency> $instructedCurrency The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the instructed amount.
      * @param string $sourceAccountNumberID the Account Number to include in the transfer as the debtor's account number
      * @param string $unstructuredRemittanceInformation unstructured remittance information to include in the transfer
+     * @param string $intermediaryBankIdentificationCode the bank identification code (BIC) of the intermediary bank, if the transfer should be routed through one
      * @param bool $requireApproval whether the transfer requires explicit approval via the dashboard or API
      * @param string $routingNumber The creditor's bank account routing or transit number. Required in certain countries.
      * @param RequestOpts|null $requestOptions
@@ -73,6 +74,7 @@ public function create(
         InstructedCurrency|string $instructedCurrency,
         string $sourceAccountNumberID,
         string $unstructuredRemittanceInformation,
+        ?string $intermediaryBankIdentificationCode = null,
         ?bool $requireApproval = null,
         ?string $routingNumber = null,
         RequestOptions|array|null $requestOptions = null,
@@ -90,6 +92,7 @@ public function create(
                 'instructedCurrency' => $instructedCurrency,
                 'sourceAccountNumberID' => $sourceAccountNumberID,
                 'unstructuredRemittanceInformation' => $unstructuredRemittanceInformation,
+                'intermediaryBankIdentificationCode' => $intermediaryBankIdentificationCode,
                 'requireApproval' => $requireApproval,
                 'routingNumber' => $routingNumber,
             ],