Merge pull request #2081 from stripe/latest-codegen-beta

Update generated code for beta

Author: stripe-openapi[bot]

API_VERSION

@@ -1 +1 @@
-0de52cdca31a7c51c6d11187fc88ab23ea3a1c5b
+577fcb57736b925392ea563c0284df9002c75ac9

OPENAPI_VERSION

@@ -1 +1 @@
-v2031
+v2099

src/main/java/com/stripe/events/V2BillingBillSettingUpdatedEvent.java

@@ -7,9 +7,22 @@
 import com.stripe.model.v2.core.Event.RelatedObject;
 import com.stripe.model.v2.moneymanagement.Transaction;
 import lombok.Getter;
+import lombok.Setter;
 
 @Getter
 public final class V2MoneyManagementTransactionCreatedEvent extends Event {
+  /** Data for the v2.money_management.transaction.created event. */
+  @SerializedName("data")
+  V2MoneyManagementTransactionCreatedEvent.EventData data;
+
+  @Getter
+  @Setter
+  public static final class EventData {
+    /** Id of the v1 Transaction corresponding to this Transaction. */
+    @SerializedName("v1_id")
+    String v1Id;
+  }
+
   @SerializedName("related_object")
 
   /** Object containing the reference to API resource relevant to the event. */

src/main/java/com/stripe/events/V2BillingBillSettingUpdatedEventNotification.java

@@ -6,7 +6,6 @@
 import com.stripe.events.V1BillingMeterErrorReportTriggeredEventNotification;
 import com.stripe.exception.StripeException;
 import com.stripe.model.billing.Meter;
-import com.stripe.model.v2.core.Event;
 import com.stripe.model.v2.core.EventNotification;
 import com.sun.net.httpserver.HttpExchange;
 import com.sun.net.httpserver.HttpHandler;
@@ -67,33 +66,39 @@ public void handle(HttpExchange exchange) throws IOException {
         String sigHeader = exchange.getRequestHeaders().getFirst("Stripe-Signature");
 
         try {
-          EventNotification eventNotif =
+          EventNotification notif =
               client.parseEventNotification(webhookBody, sigHeader, WEBHOOK_SECRET);
 
-          // determine what sort of event you have
-          if (eventNotif instanceof V1BillingMeterErrorReportTriggeredEventNotification) {
+          if (notif instanceof V1BillingMeterErrorReportTriggeredEventNotification) {
             V1BillingMeterErrorReportTriggeredEventNotification eventNotification =
-                (V1BillingMeterErrorReportTriggeredEventNotification) eventNotif;
+                (V1BillingMeterErrorReportTriggeredEventNotification) notif;
 
-            // after casting, can fetch the related object (which is correctly typed)
-            Meter meter = eventNotification.fetchRelatedObject();
-            System.out.println(meter.getId());
+            // there's basic info about the related object in the notification
+            System.out.println(
+                "Meter w/ id " + eventNotification.getRelatedObject().getId() + " had a problem");
 
+            // or you can fetch the full object form the API for more details
+            Meter meter = eventNotification.fetchRelatedObject();
+            StringBuilder sb = new StringBuilder();
+            sb.append("Meter ")
+                .append(meter.getDisplayName())
+                .append(" (")
+                .append(meter.getId())
+                .append(") had a problem");
+            System.out.println(sb.toString());
+
+            // And you can always fetch the full event:
             V1BillingMeterErrorReportTriggeredEvent event = eventNotification.fetchEvent();
-            System.out.println(event.getData().getDeveloperMessageSummary());
-
-            // add additional logic
-          }
-          // ... check other event types you know about
-          else if (eventNotif instanceof UnknownEventNotification) {
-            UnknownEventNotification unknownEvent = (UnknownEventNotification) eventNotif;
-            System.out.println("Received unknown event: " + unknownEvent.getId());
-            // can keep matching on the "type" field
-            // other helper methods still work, but you'll have to handle types yourself
+            System.out.println("More info: " + event.getData().getDeveloperMessageSummary());
+          } else if (notif instanceof UnknownEventNotification) {
+            // Events that were introduced after this SDK version release are
+            // represented as `UnknownEventNotification`s.
+            // They're valid, the SDK just doesn't have corresponding classes for them.
+            // You must match on the "type" property instead.
+            UnknownEventNotification unknownEvent = (UnknownEventNotification) notif;
             if (unknownEvent.getType().equals("some.new.event")) {
-              Event event = unknownEvent.fetchEvent();
-              System.out.println(event.getReason());
-              // handle
+              // you can still `.fetchEvent()` and `.fetchRelatedObject()`, but the latter may
+              // return `null` if that event type doesn't have a related object.
             }
           }
 

src/main/java/com/stripe/events/V2MoneyManagementTransactionCreatedEvent.java

@@ -6,7 +6,7 @@
 import com.stripe.model.StripeObject;
 import com.stripe.net.StripeResponseGetter;
 
-/** Information about the error that occurred. */
+/** Error returned when user tries to cancel an OutboundPayment that was already canceled. */
 public final class AlreadyCanceledException extends ApiException {
   private static final long serialVersionUID = 2L;
 

src/main/java/com/stripe/examples/EventNotificationWebhookHandler.java

@@ -6,7 +6,7 @@
 import com.stripe.model.StripeObject;
 import com.stripe.net.StripeResponseGetter;
 
-/** Information about the error that occurred. */
+/** The resource already exists. */
 public final class AlreadyExistsException extends ApiException {
   private static final long serialVersionUID = 2L;
 

src/main/java/com/stripe/exception/AlreadyCanceledException.java

@@ -6,7 +6,7 @@
 import com.stripe.model.StripeObject;
 import com.stripe.net.StripeResponseGetter;
 
-/** Information about the error that occurred. */
+/** Returned when the bank account cannot be added due to previous suspicious activity. */
 public final class BlockedByStripeException extends ApiException {
   private static final long serialVersionUID = 2L;
 

src/main/java/com/stripe/exception/AlreadyExistsException.java

@@ -6,7 +6,10 @@
 import com.stripe.model.StripeObject;
 import com.stripe.net.StripeResponseGetter;
 
-/** Information about the error that occurred. */
+/**
+ * Returned when the PayoutMethodBankAccount object is controlled by the Stripe Dashboard, and
+ * cannot be archived.
+ */
 public final class ControlledByDashboardException extends ApiException {
   private static final long serialVersionUID = 2L;