feat(issuing): add scheduled_revocation_date, last_activated_on and update-card status (#674)

* feat(issuing): add scheduled_revocation_date, last_activated_on and update-card status

Swagger 2026-09-17: add-card-request and update-card-request gain
scheduled_revocation_date (replaces deprecated revocation_date); update-card-request
gains status to reactivate an inactive/suspended card; activate-card-response,
add-card-response and get-card-response gain last_activated_on; update-card-response
drops encrypted_cvv (last_modified_date and _links stay). activateCard/activateCardSync
now return a typed ActivateCardResponse instead of VoidResponse.

* fix(issuing): add isSingleUse to update-card-response for virtual cards

Swagger 2026-09-23 split update-card-response into a virtual/physical
discriminator; the virtual variant adds is_single_use (specifies whether the
card is set to expire after a single use). Physical cards never send it.

Author: armando-rodriguez-cko

src/main/java/com/checkout/issuing/IssuingClient.java

@@ -20,6 +20,7 @@
 import com.checkout.issuing.cards.requests.update.UpdateCardRequest;
 import com.checkout.issuing.cards.responses.CardDetailsResponse;
 import com.checkout.issuing.cards.responses.CardResponse;
+import com.checkout.issuing.cards.responses.activate.ActivateCardResponse;
 import com.checkout.issuing.cards.responses.GetDigitalCardResponse;
 import com.checkout.issuing.cards.responses.credentials.CardCredentialsResponse;
 import com.checkout.issuing.cards.responses.enrollment.ThreeDSEnrollmentDetailsResponse;
@@ -87,7 +88,7 @@ public interface IssuingClient {
 
     CompletableFuture<ThreeDSEnrollmentDetailsResponse> getCardThreeDSDetails(String cardId);
 
-    CompletableFuture<VoidResponse> activateCard(String cardId);
+    CompletableFuture<ActivateCardResponse> activateCard(String cardId);
 
     CompletableFuture<CardCredentialsResponse> getCardCredentials(final String cardId, final CardCredentialsQuery queryFilter);
 
@@ -229,7 +230,7 @@ CompletableFuture<CardAuthorizationReversalResponse> simulateReversal(
 
     ThreeDSEnrollmentDetailsResponse getCardThreeDSDetailsSync(String cardId);
 
-    VoidResponse activateCardSync(String cardId);
+    ActivateCardResponse activateCardSync(String cardId);
 
     CardCredentialsResponse getCardCredentialsSync(String cardId, CardCredentialsQuery queryFilter);
 

src/main/java/com/checkout/issuing/IssuingClientImpl.java

@@ -25,6 +25,7 @@
 import com.checkout.issuing.cards.requests.update.UpdateCardRequest;
 import com.checkout.issuing.cards.responses.CardDetailsResponse;
 import com.checkout.issuing.cards.responses.CardResponse;
+import com.checkout.issuing.cards.responses.activate.ActivateCardResponse;
 import com.checkout.issuing.cards.responses.credentials.CardCredentialsResponse;
 import com.checkout.issuing.cards.responses.enrollment.ThreeDSEnrollmentDetailsResponse;
 import com.checkout.issuing.cards.responses.enrollment.ThreeDSEnrollmentResponse;
@@ -254,12 +255,12 @@ public CompletableFuture<ThreeDSEnrollmentDetailsResponse> getCardThreeDSDetails
     }
 
     @Override
-    public CompletableFuture<VoidResponse> activateCard(final String cardId) {
+    public CompletableFuture<ActivateCardResponse> activateCard(final String cardId) {
         validateParams("cardId", cardId);
         return apiClient.postAsync(
                 buildPath(ISSUING_PATH, CARDS_PATH, cardId, ACTIVATE_PATH),
                 sdkAuthorization(),
-                VoidResponse.class,
+                ActivateCardResponse.class,
                 null,
                 null
         );
@@ -845,12 +846,12 @@ public ThreeDSEnrollmentDetailsResponse getCardThreeDSDetailsSync(final String c
     }
 
     @Override
-    public VoidResponse activateCardSync(final String cardId) {
+    public ActivateCardResponse activateCardSync(final String cardId) {
         validateCardId(cardId);
         return apiClient.post(
                 buildPath(ISSUING_PATH, CARDS_PATH, cardId, ACTIVATE_PATH),
                 sdkAuthorization(),
-                VoidResponse.class,
+                ActivateCardResponse.class,
                 null,
                 null
         );

src/main/java/com/checkout/issuing/cards/requests/create/CardRequest.java

@@ -49,11 +49,23 @@ public abstract class CardRequest {
      * <p>
      * [Optional]
      * </p>
-     * Format: date (YYYY-MM-DD, time is midnight UTC)
-     * Example: 2027-03-12
+     * Format: yyyy-MM-dd
+     *
+     * @deprecated Use {@link #scheduledRevocationDate} instead. If both fields are provided,
+     * {@code scheduledRevocationDate} overrides this value.
      */
+    @Deprecated
     private LocalDate revocationDate;
 
+    /**
+     * The card will be revoked at midnight UTC on the date specified.
+     * <p>
+     * [Optional]
+     * </p>
+     * Format: yyyy-MM-dd
+     */
+    private LocalDate scheduledRevocationDate;
+
     /**
      * Date scheduling the card's first activation. Only applies to the initial activation of a
      * card. Two formats are supported: date only (YYYY-MM-DD, treated as midnight UTC), or date

src/main/java/com/checkout/issuing/cards/requests/create/PhysicalCardRequest.java

@@ -32,11 +32,13 @@ private PhysicalCardRequest(final String cardholderId,
                                 final ShippingInstruction shippingInstructions,
                                 final IssuingCardMetadata metadata,
                                 final LocalDate revocationDate,
+                                final LocalDate scheduledRevocationDate,
                                 final String scheduledActivationDate) {
         super(CardType.PHYSICAL, cardholderId, lifetime, reference, cardProductId, displayName, activateCard);
         this.shippingInstructions = shippingInstructions;
         setMetadata(metadata);
         setRevocationDate(revocationDate);
+        setScheduledRevocationDate(scheduledRevocationDate);
         setScheduledActivationDate(scheduledActivationDate);
     }
 

src/main/java/com/checkout/issuing/cards/requests/create/VirtualCardRequest.java

@@ -53,6 +53,7 @@ private VirtualCardRequest(final String cardholderId,
                                final Boolean isSingleUse,
                                final IssuingCardMetadata metadata,
                                final LocalDate revocationDate,
+                               final LocalDate scheduledRevocationDate,
                                final String scheduledActivationDate,
                                final List<ReturnCredentialsType> returnCredentials,
                                final List<String> controlProfiles,
@@ -64,6 +65,7 @@ private VirtualCardRequest(final String cardholderId,
         this.controls = controls;
         setMetadata(metadata);
         setRevocationDate(revocationDate);
+        setScheduledRevocationDate(scheduledRevocationDate);
         setScheduledActivationDate(scheduledActivationDate);
     }
 }

src/main/java/com/checkout/issuing/cards/requests/update/UpdateCardRequest.java

@@ -1,5 +1,6 @@
 package com.checkout.issuing.cards.requests.update;
 
+import com.checkout.issuing.cards.CardStatus;
 import lombok.AllArgsConstructor;
 import lombok.Builder;
 import lombok.Data;
@@ -13,6 +14,17 @@
 @AllArgsConstructor
 public final class UpdateCardRequest {
 
+    /**
+     * Set the card's status to {@code ACTIVE} to reactivate an {@code INACTIVE} or
+     * {@code SUSPENDED} card. The API only accepts {@code active} for this field.
+     * <p>
+     * [Optional]
+     * </p>
+     * Mutually exclusive with {@link #scheduledActivationDate}: submitting both results in the
+     * API error {@code scheduled_activation_date_conflicts_with_activation}.
+     */
+    private CardStatus status;
+
     /**
      * Your reference.
      * [Optional]
@@ -58,8 +70,20 @@ public final class UpdateCardRequest {
      * <p>
      * [Optional]
      * </p>
-     * Format: date (YYYY-MM-DD, time is midnight UTC)
-     * Example: 2027-03-12
+     * Format: yyyy-MM-dd
+     *
+     * @deprecated Use {@link #scheduledRevocationDate} instead. If both fields are provided,
+     * {@code scheduledRevocationDate} overrides this value.
      */
+    @Deprecated
     private LocalDate revocationDate;
+
+    /**
+     * The card will be revoked at midnight UTC on the date specified.
+     * <p>
+     * [Optional]
+     * </p>
+     * Format: yyyy-MM-dd
+     */
+    private LocalDate scheduledRevocationDate;
 }

src/main/java/com/checkout/issuing/cards/responses/CardDetailsResponse.java

@@ -164,11 +164,31 @@ public abstract class CardDetailsResponse extends Resource {
      * <p>
      * [Optional]
      * </p>
-     * Format: date (YYYY-MM-DD, time is midnight UTC)
-     * Example: 2027-03-12
+     * Format: yyyy-MM-dd
+     *
+     * @deprecated Use {@link #scheduledRevocationDate} instead.
      */
+    @Deprecated
     protected LocalDate revocationDate;
 
+    /**
+     * The card will be revoked at midnight UTC on the date specified.
+     * <p>
+     * [Optional]
+     * </p>
+     * Format: yyyy-MM-dd
+     */
+    protected LocalDate scheduledRevocationDate;
+
+    /**
+     * The date and time the card was last activated.
+     * <p>
+     * [Optional, nullable, read only]
+     * </p>
+     * Returns {@code null} if the card has never been activated.
+     */
+    protected Instant lastActivatedOn;
+
     /**
      * When a card is renewed, the unique identifier of the first card in the renewal history.
      * [Optional]

src/main/java/com/checkout/issuing/cards/responses/CardResponse.java

@@ -31,4 +31,13 @@ public final class CardResponse extends Resource {
     protected String reference;
 
     protected Instant createdDate;
+
+    /**
+     * The date and time the card was last activated.
+     * <p>
+     * [Optional, nullable, read only]
+     * </p>
+     * Returns {@code null} if the card has never been activated.
+     */
+    protected Instant lastActivatedOn;
 }

src/main/java/com/checkout/issuing/cards/responses/activate/ActivateCardResponse.java

@@ -0,0 +1,25 @@
+package com.checkout.issuing.cards.responses.activate;
+
+import com.checkout.common.Resource;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.time.Instant;
+
+/**
+ * Response returned when activating a card.
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public final class ActivateCardResponse extends Resource {
+
+    /**
+     * The time the card was activated.
+     * <p>
+     * [Required]
+     * </p>
+     */
+    private Instant lastActivatedOn;
+}