increase 0.419.0 → 0.430.0

package/src/resources/ach-transfers.ts

@@ -273,12 +273,21 @@ export interface ACHTransfer {
   settlement: ACHTransfer.Settlement | null;
 
   /**
-   * The Standard Entry Class (SEC) code to use for the transfer.
+   * The
+   * [Standard Entry Class (SEC) code](/documentation/ach-standard-entry-class-codes)
+   * to use for the transfer.
    *
-   * - `corporate_credit_or_debit` - Corporate Credit and Debit (CCD).
-   * - `corporate_trade_exchange` - Corporate Trade Exchange (CTX).
-   * - `prearranged_payments_and_deposit` - Prearranged Payments and Deposits (PPD).
-   * - `internet_initiated` - Internet Initiated (WEB).
+   * - `corporate_credit_or_debit` - Corporate Credit and Debit (CCD) is used for
+   *   business-to-business payments.
+   * - `corporate_trade_exchange` - Corporate Trade Exchange (CTX) allows for
+   *   including extensive remittance information with business-to-business payments.
+   * - `prearranged_payments_and_deposit` - Prearranged Payments and Deposits (PPD)
+   *   is used for credits or debits originated by an organization to a consumer,
+   *   such as payroll direct deposits.
+   * - `internet_initiated` - Internet Initiated (WEB) is used for consumer payments
+   *   initiated or authorized via the Internet. Debits can only be initiated by
+   *   non-consumers to debit a consumer’s account. Credits can only be used for
+   *   consumer to consumer transactions.
    */
   standard_entry_class_code:
     | 'corporate_credit_or_debit'
@@ -375,13 +384,13 @@ export namespace ACHTransfer {
     /**
      * Unstructured `payment_related_information` passed through with the transfer.
      */
-    freeform: Addenda.Freeform | null;
+    freeform?: Addenda.Freeform | null;
 
     /**
      * Structured ASC X12 820 remittance advice records. Please reach out to
      * [support@increase.com](mailto:support@increase.com) for more information.
      */
-    payment_order_remittance_advice: Addenda.PaymentOrderRemittanceAdvice | null;
+    payment_order_remittance_advice?: Addenda.PaymentOrderRemittanceAdvice | null;
   }
 
   export namespace Addenda {
@@ -471,11 +480,6 @@ export namespace ACHTransfer {
    * What object created the transfer, either via the API or the dashboard.
    */
   export interface CreatedBy {
-    /**
-     * If present, details about the API key that created the transfer.
-     */
-    api_key: CreatedBy.APIKey | null;
-
     /**
      * The type of object that created this transfer.
      *
@@ -487,15 +491,20 @@ export namespace ACHTransfer {
      */
     category: 'api_key' | 'oauth_application' | 'user';
 
+    /**
+     * If present, details about the API key that created the transfer.
+     */
+    api_key?: CreatedBy.APIKey | null;
+
     /**
      * If present, details about the OAuth Application that created the transfer.
      */
-    oauth_application: CreatedBy.OAuthApplication | null;
+    oauth_application?: CreatedBy.OAuthApplication | null;
 
     /**
      * If present, details about the User that created the transfer.
      */
-    user: CreatedBy.User | null;
+    user?: CreatedBy.User | null;
   }
 
   export namespace CreatedBy {
@@ -717,24 +726,28 @@ export namespace ACHTransfer {
      * bank back to Increase.
      *
      * - `insufficient_fund` - Code R01. Insufficient funds in the receiving account.
-     *   Sometimes abbreviated to NSF.
+     *   Sometimes abbreviated to "NSF."
      * - `no_account` - Code R03. The account does not exist or the receiving bank was
      *   unable to locate it.
      * - `account_closed` - Code R02. The account is closed at the receiving bank.
      * - `invalid_account_number_structure` - Code R04. The account number is invalid
      *   at the receiving bank.
-     * - `account_frozen_entry_returned_per_ofac_instruction` - Code R16. The account
-     *   at the receiving bank was frozen per the Office of Foreign Assets Control.
-     * - `credit_entry_refused_by_receiver` - Code R23. The receiving bank account
-     *   refused a credit transfer.
+     * - `account_frozen_entry_returned_per_ofac_instruction` - Code R16. This return
+     *   code has two separate meanings. (1) The receiving bank froze the account or
+     *   (2) the Office of Foreign Assets Control (OFAC) instructed the receiving bank
+     *   to return the entry.
+     * - `credit_entry_refused_by_receiver` - Code R23. The receiving bank refused the
+     *   credit transfer.
      * - `unauthorized_debit_to_consumer_account_using_corporate_sec_code` - Code R05.
      *   The receiving bank rejected because of an incorrect Standard Entry Class code.
+     *   Consumer accounts cannot be debited as `corporate_credit_or_debit` or
+     *   `corporate_trade_exchange`.
      * - `corporate_customer_advised_not_authorized` - Code R29. The corporate customer
      *   at the receiving bank reversed the transfer.
      * - `payment_stopped` - Code R08. The receiving bank stopped payment on this
      *   transfer.
-     * - `non_transaction_account` - Code R20. The receiving bank account does not
-     *   perform transfers.
+     * - `non_transaction_account` - Code R20. The account is not eligible for ACH,
+     *   such as a savings account with transaction limits.
      * - `uncollected_funds` - Code R09. The receiving bank account does not have
      *   enough available balance for the transfer.
      * - `routing_number_check_digit_error` - Code R28. The routing number is
@@ -742,14 +755,13 @@ export namespace ACHTransfer {
      * - `customer_advised_unauthorized_improper_ineligible_or_incomplete` - Code R10.
      *   The customer at the receiving bank reversed the transfer.
      * - `amount_field_error` - Code R19. The amount field is incorrect or too large.
-     * - `authorization_revoked_by_customer` - Code R07. The customer at the receiving
-     *   institution informed their bank that they have revoked authorization for a
-     *   previously authorized transfer.
+     * - `authorization_revoked_by_customer` - Code R07. The customer revoked their
+     *   authorization for a previously authorized transfer.
      * - `invalid_ach_routing_number` - Code R13. The routing number is invalid.
      * - `file_record_edit_criteria` - Code R17. The receiving bank is unable to
      *   process a field in the transfer.
-     * - `enr_invalid_individual_name` - Code R45. The individual name field was
-     *   invalid.
+     * - `enr_invalid_individual_name` - Code R45. A rare return reason. The individual
+     *   name field was invalid.
      * - `returned_per_odfi_request` - Code R06. The originating financial institution
      *   asked for this transfer to be returned. The receiving bank is complying with
      *   the request.
@@ -844,8 +856,8 @@ export namespace ACHTransfer {
      *   a malformed credit entry.
      * - `return_of_improper_debit_entry` - Code R35. A rare return reason. Return of a
      *   malformed debit entry.
-     * - `return_of_xck_entry` - Code R33. A rare return reason. Return of a Destroyed
-     *   Check ("XKC") entry.
+     * - `return_of_xck_entry` - Code R33. A rare return reason. Return of a destroyed
+     *   check ("XCK") entry.
      * - `source_document_presented_for_payment` - Code R37. A rare return reason. The
      *   source document related to this ACH, usually an ACH check conversion, was
      *   presented to the bank.
@@ -1076,8 +1088,9 @@ export interface ACHTransferCreateParams {
   company_discretionary_data?: string;
 
   /**
-   * A description of the transfer. This is included in the transfer data sent to the
-   * receiving bank.
+   * A description of the transfer, included in the transfer data sent to the
+   * receiving bank. Standardized formatting may be required, for example `PAYROLL`
+   * for payroll-related Prearranged Payments and Deposits (PPD) credit transfers.
    */
   company_entry_description?: string;
 
@@ -1143,12 +1156,21 @@ export interface ACHTransferCreateParams {
   routing_number?: string;
 
   /**
-   * The Standard Entry Class (SEC) code to use for the transfer.
+   * The
+   * [Standard Entry Class (SEC) code](/documentation/ach-standard-entry-class-codes)
+   * to use for the transfer.
    *
-   * - `corporate_credit_or_debit` - Corporate Credit and Debit (CCD).
-   * - `corporate_trade_exchange` - Corporate Trade Exchange (CTX).
-   * - `prearranged_payments_and_deposit` - Prearranged Payments and Deposits (PPD).
-   * - `internet_initiated` - Internet Initiated (WEB).
+   * - `corporate_credit_or_debit` - Corporate Credit and Debit (CCD) is used for
+   *   business-to-business payments.
+   * - `corporate_trade_exchange` - Corporate Trade Exchange (CTX) allows for
+   *   including extensive remittance information with business-to-business payments.
+   * - `prearranged_payments_and_deposit` - Prearranged Payments and Deposits (PPD)
+   *   is used for credits or debits originated by an organization to a consumer,
+   *   such as payroll direct deposits.
+   * - `internet_initiated` - Internet Initiated (WEB) is used for consumer payments
+   *   initiated or authorized via the Internet. Debits can only be initiated by
+   *   non-consumers to debit a consumer’s account. Credits can only be used for
+   *   consumer to consumer transactions.
    */
   standard_entry_class_code?:
     | 'corporate_credit_or_debit'

package/src/resources/card-disputes.ts

@@ -326,6 +326,17 @@ export namespace CardDispute {
         | 'user_prearbitration_timed_out'
         | 'user_withdrawal_submitted';
 
+      /**
+       * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
+       * the Visa Card Dispute Network Event was created.
+       */
+      created_at: string;
+
+      /**
+       * The dispute financial transaction that resulted from the network event, if any.
+       */
+      dispute_financial_transaction_id: string | null;
+
       /**
        * A Card Dispute Chargeback Accepted Visa Network Event object. This field will be
        * present in the JSON response if and only if `category` is equal to
@@ -333,7 +344,7 @@ export namespace CardDispute {
        * Visa Card Dispute Network Event, which represents that a chargeback has been
        * accepted by the merchant.
        */
-      chargeback_accepted: NetworkEvent.ChargebackAccepted | null;
+      chargeback_accepted?: NetworkEvent.ChargebackAccepted | null;
 
       /**
        * A Card Dispute Chargeback Submitted Visa Network Event object. This field will
@@ -342,7 +353,7 @@ export namespace CardDispute {
        * Visa Card Dispute Network Event, which represents that a chargeback has been
        * submitted to the network.
        */
-      chargeback_submitted: NetworkEvent.ChargebackSubmitted | null;
+      chargeback_submitted?: NetworkEvent.ChargebackSubmitted | null;
 
       /**
        * A Card Dispute Chargeback Timed Out Visa Network Event object. This field will
@@ -351,18 +362,7 @@ export namespace CardDispute {
        * Visa Card Dispute Network Event, which represents that the chargeback has timed
        * out in the user's favor.
        */
-      chargeback_timed_out: NetworkEvent.ChargebackTimedOut | null;
-
-      /**
-       * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
-       * the Visa Card Dispute Network Event was created.
-       */
-      created_at: string;
-
-      /**
-       * The dispute financial transaction that resulted from the network event, if any.
-       */
-      dispute_financial_transaction_id: string | null;
+      chargeback_timed_out?: NetworkEvent.ChargebackTimedOut | null;
 
       /**
        * A Card Dispute Merchant Pre-Arbitration Decline Submitted Visa Network Event
@@ -372,7 +372,7 @@ export namespace CardDispute {
        * Dispute Network Event, which represents that the user has declined the
        * merchant's request for a prearbitration request decision in their favor.
        */
-      merchant_prearbitration_decline_submitted: NetworkEvent.MerchantPrearbitrationDeclineSubmitted | null;
+      merchant_prearbitration_decline_submitted?: NetworkEvent.MerchantPrearbitrationDeclineSubmitted | null;
 
       /**
        * A Card Dispute Merchant Pre-Arbitration Received Visa Network Event object. This
@@ -381,7 +381,7 @@ export namespace CardDispute {
        * prearbitration received Visa Card Dispute Network Event, which represents that
        * the merchant has issued a prearbitration request in the user's favor.
        */
-      merchant_prearbitration_received: NetworkEvent.MerchantPrearbitrationReceived | null;
+      merchant_prearbitration_received?: NetworkEvent.MerchantPrearbitrationReceived | null;
 
       /**
        * A Card Dispute Merchant Pre-Arbitration Timed Out Visa Network Event object.
@@ -391,7 +391,7 @@ export namespace CardDispute {
        * represents that the user has timed out responding to the merchant's
        * prearbitration request.
        */
-      merchant_prearbitration_timed_out: NetworkEvent.MerchantPrearbitrationTimedOut | null;
+      merchant_prearbitration_timed_out?: NetworkEvent.MerchantPrearbitrationTimedOut | null;
 
       /**
        * A Card Dispute Re-presented Visa Network Event object. This field will be
@@ -400,7 +400,7 @@ export namespace CardDispute {
        * Network Event, which represents that the merchant has declined the user's
        * chargeback and has re-presented the payment.
        */
-      represented: NetworkEvent.Represented | null;
+      represented?: NetworkEvent.Represented | null;
 
       /**
        * A Card Dispute Re-presentment Timed Out Visa Network Event object. This field
@@ -409,7 +409,7 @@ export namespace CardDispute {
        * time-out Visa Card Dispute Network Event, which represents that the user did not
        * respond to the re-presentment by the merchant within the time limit.
        */
-      representment_timed_out: NetworkEvent.RepresentmentTimedOut | null;
+      representment_timed_out?: NetworkEvent.RepresentmentTimedOut | null;
 
       /**
        * A Card Dispute User Pre-Arbitration Accepted Visa Network Event object. This
@@ -418,7 +418,7 @@ export namespace CardDispute {
        * prearbitration accepted Visa Card Dispute Network Event, which represents that
        * the merchant has accepted the user's prearbitration request in the user's favor.
        */
-      user_prearbitration_accepted: NetworkEvent.UserPrearbitrationAccepted | null;
+      user_prearbitration_accepted?: NetworkEvent.UserPrearbitrationAccepted | null;
 
       /**
        * A Card Dispute User Pre-Arbitration Declined Visa Network Event object. This
@@ -427,7 +427,7 @@ export namespace CardDispute {
        * prearbitration declined Visa Card Dispute Network Event, which represents that
        * the merchant has declined the user's prearbitration request.
        */
-      user_prearbitration_declined: NetworkEvent.UserPrearbitrationDeclined | null;
+      user_prearbitration_declined?: NetworkEvent.UserPrearbitrationDeclined | null;
 
       /**
        * A Card Dispute User Pre-Arbitration Submitted Visa Network Event object. This
@@ -436,7 +436,7 @@ export namespace CardDispute {
        * prearbitration submitted Visa Card Dispute Network Event, which represents that
        * the user's request for prearbitration has been submitted to the network.
        */
-      user_prearbitration_submitted: NetworkEvent.UserPrearbitrationSubmitted | null;
+      user_prearbitration_submitted?: NetworkEvent.UserPrearbitrationSubmitted | null;
 
       /**
        * A Card Dispute User Pre-Arbitration Timed Out Visa Network Event object. This
@@ -445,7 +445,7 @@ export namespace CardDispute {
        * prearbitration timed out Visa Card Dispute Network Event, which represents that
        * the merchant has timed out responding to the user's prearbitration request.
        */
-      user_prearbitration_timed_out: NetworkEvent.UserPrearbitrationTimedOut | null;
+      user_prearbitration_timed_out?: NetworkEvent.UserPrearbitrationTimedOut | null;
 
       /**
        * A Card Dispute User Withdrawal Submitted Visa Network Event object. This field
@@ -454,7 +454,7 @@ export namespace CardDispute {
        * submitted Visa Card Dispute Network Event, which represents that the user's
        * request to withdraw the dispute has been submitted to the network.
        */
-      user_withdrawal_submitted: NetworkEvent.UserWithdrawalSubmitted | null;
+      user_withdrawal_submitted?: NetworkEvent.UserWithdrawalSubmitted | null;
     }
 
     export namespace NetworkEvent {
@@ -1129,14 +1129,6 @@ export namespace CardDispute {
        */
       category: 'chargeback' | 'merchant_prearbitration_decline' | 'user_prearbitration';
 
-      /**
-       * A Visa Card Dispute Chargeback User Submission Chargeback Details object. This
-       * field will be present in the JSON response if and only if `category` is equal to
-       * `chargeback`. Contains the details specific to a Visa chargeback User Submission
-       * for a Card Dispute.
-       */
-      chargeback: UserSubmission.Chargeback | null;
-
       /**
        * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
        * the Visa Card Dispute User Submission was created.
@@ -1161,14 +1153,6 @@ export namespace CardDispute {
        */
       further_information_requested_reason: string | null;
 
-      /**
-       * A Visa Card Dispute Merchant Pre-Arbitration Decline User Submission object.
-       * This field will be present in the JSON response if and only if `category` is
-       * equal to `merchant_prearbitration_decline`. Contains the details specific to a
-       * merchant prearbitration decline Visa Card Dispute User Submission.
-       */
-      merchant_prearbitration_decline: UserSubmission.MerchantPrearbitrationDecline | null;
-
       /**
        * The status of the Visa Card Dispute User Submission.
        *
@@ -1186,13 +1170,29 @@ export namespace CardDispute {
        */
       updated_at: string;
 
+      /**
+       * A Visa Card Dispute Chargeback User Submission Chargeback Details object. This
+       * field will be present in the JSON response if and only if `category` is equal to
+       * `chargeback`. Contains the details specific to a Visa chargeback User Submission
+       * for a Card Dispute.
+       */
+      chargeback?: UserSubmission.Chargeback | null;
+
+      /**
+       * A Visa Card Dispute Merchant Pre-Arbitration Decline User Submission object.
+       * This field will be present in the JSON response if and only if `category` is
+       * equal to `merchant_prearbitration_decline`. Contains the details specific to a
+       * merchant prearbitration decline Visa Card Dispute User Submission.
+       */
+      merchant_prearbitration_decline?: UserSubmission.MerchantPrearbitrationDecline | null;
+
       /**
        * A Visa Card Dispute User-Initiated Pre-Arbitration User Submission object. This
        * field will be present in the JSON response if and only if `category` is equal to
        * `user_prearbitration`. Contains the details specific to a user-initiated
        * pre-arbitration Visa Card Dispute User Submission.
        */
-      user_prearbitration: UserSubmission.UserPrearbitration | null;
+      user_prearbitration?: UserSubmission.UserPrearbitration | null;
     }
 
     export namespace UserSubmission {

package/src/resources/card-payments.ts

@@ -97,12 +97,62 @@ export interface CardPayment {
 
 export namespace CardPayment {
   export interface Element {
+    /**
+     * The type of the resource. We may add additional possible values for this enum
+     * over time; your application should be able to handle such additions gracefully.
+     *
+     * - `card_authorization` - Card Authorization: details will be under the
+     *   `card_authorization` object.
+     * - `card_authentication` - Card Authentication: details will be under the
+     *   `card_authentication` object.
+     * - `card_balance_inquiry` - Card Balance Inquiry: details will be under the
+     *   `card_balance_inquiry` object.
+     * - `card_validation` - Inbound Card Validation: details will be under the
+     *   `card_validation` object.
+     * - `card_decline` - Card Decline: details will be under the `card_decline`
+     *   object.
+     * - `card_reversal` - Card Reversal: details will be under the `card_reversal`
+     *   object.
+     * - `card_authorization_expiration` - Card Authorization Expiration: details will
+     *   be under the `card_authorization_expiration` object.
+     * - `card_increment` - Card Increment: details will be under the `card_increment`
+     *   object.
+     * - `card_settlement` - Card Settlement: details will be under the
+     *   `card_settlement` object.
+     * - `card_refund` - Card Refund: details will be under the `card_refund` object.
+     * - `card_fuel_confirmation` - Card Fuel Confirmation: details will be under the
+     *   `card_fuel_confirmation` object.
+     * - `card_financial` - Card Financial: details will be under the `card_financial`
+     *   object.
+     * - `other` - Unknown card payment element.
+     */
+    category:
+      | 'card_authorization'
+      | 'card_authentication'
+      | 'card_balance_inquiry'
+      | 'card_validation'
+      | 'card_decline'
+      | 'card_reversal'
+      | 'card_authorization_expiration'
+      | 'card_increment'
+      | 'card_settlement'
+      | 'card_refund'
+      | 'card_fuel_confirmation'
+      | 'card_financial'
+      | 'other';
+
+    /**
+     * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
+     * the card payment element was created.
+     */
+    created_at: string;
+
     /**
      * A Card Authentication object. This field will be present in the JSON response if
      * and only if `category` is equal to `card_authentication`. Card Authentications
      * are attempts to authenticate a transaction or a card with 3DS.
      */
-    card_authentication: Element.CardAuthentication | null;
+    card_authentication?: Element.CardAuthentication | null;
 
     /**
      * A Card Authorization object. This field will be present in the JSON response if
@@ -110,7 +160,7 @@ export namespace CardPayment {
      * temporary holds placed on a customers funds with the intent to later clear a
      * transaction.
      */
-    card_authorization: Element.CardAuthorization | null;
+    card_authorization?: Element.CardAuthorization | null;
 
     /**
      * A Card Authorization Expiration object. This field will be present in the JSON
@@ -118,7 +168,7 @@ export namespace CardPayment {
      * Card Authorization Expirations are cancellations of authorizations that were
      * never settled by the acquirer.
      */
-    card_authorization_expiration: Element.CardAuthorizationExpiration | null;
+    card_authorization_expiration?: Element.CardAuthorizationExpiration | null;
 
     /**
      * A Card Balance Inquiry object. This field will be present in the JSON response
@@ -127,20 +177,20 @@ export namespace CardPayment {
      * on a card without placing a hold on funds, commonly used when a customer
      * requests their balance at an ATM.
      */
-    card_balance_inquiry: Element.CardBalanceInquiry | null;
+    card_balance_inquiry?: Element.CardBalanceInquiry | null;
 
     /**
      * A Card Decline object. This field will be present in the JSON response if and
      * only if `category` is equal to `card_decline`.
      */
-    card_decline: Element.CardDecline | null;
+    card_decline?: Element.CardDecline | null;
 
     /**
      * A Card Financial object. This field will be present in the JSON response if and
      * only if `category` is equal to `card_financial`. Card Financials are temporary
      * holds placed on a customers funds with the intent to later clear a transaction.
      */
-    card_financial: Element.CardFinancial | null;
+    card_financial?: Element.CardFinancial | null;
 
     /**
      * A Card Fuel Confirmation object. This field will be present in the JSON response
@@ -148,14 +198,14 @@ export namespace CardPayment {
      * Confirmations update the amount of a Card Authorization after a fuel pump
      * transaction is completed.
      */
-    card_fuel_confirmation: Element.CardFuelConfirmation | null;
+    card_fuel_confirmation?: Element.CardFuelConfirmation | null;
 
     /**
      * A Card Increment object. This field will be present in the JSON response if and
      * only if `category` is equal to `card_increment`. Card Increments increase the
      * pending amount of an authorized transaction.
      */
-    card_increment: Element.CardIncrement | null;
+    card_increment?: Element.CardIncrement | null;
 
     /**
      * A Card Refund object. This field will be present in the JSON response if and
@@ -164,14 +214,14 @@ export namespace CardPayment {
      * acquirer can also refund money directly to a card without relation to a
      * transaction.
      */
-    card_refund: Element.CardRefund | null;
+    card_refund?: Element.CardRefund | null;
 
     /**
      * A Card Reversal object. This field will be present in the JSON response if and
      * only if `category` is equal to `card_reversal`. Card Reversals cancel parts of
      * or the entirety of an existing Card Authorization.
      */
-    card_reversal: Element.CardReversal | null;
+    card_reversal?: Element.CardReversal | null;
 
     /**
      * A Card Settlement object. This field will be present in the JSON response if and
@@ -180,7 +230,7 @@ export namespace CardPayment {
      * preceded by an authorization, an acquirer can also directly clear a transaction
      * without first authorizing it.
      */
-    card_settlement: Element.CardSettlement | null;
+    card_settlement?: Element.CardSettlement | null;
 
     /**
      * An Inbound Card Validation object. This field will be present in the JSON
@@ -188,63 +238,13 @@ export namespace CardPayment {
      * Validations are requests from a merchant to verify that a card number and
      * optionally its address and/or Card Verification Value are valid.
      */
-    card_validation: Element.CardValidation | null;
-
-    /**
-     * The type of the resource. We may add additional possible values for this enum
-     * over time; your application should be able to handle such additions gracefully.
-     *
-     * - `card_authorization` - Card Authorization: details will be under the
-     *   `card_authorization` object.
-     * - `card_authentication` - Card Authentication: details will be under the
-     *   `card_authentication` object.
-     * - `card_balance_inquiry` - Card Balance Inquiry: details will be under the
-     *   `card_balance_inquiry` object.
-     * - `card_validation` - Inbound Card Validation: details will be under the
-     *   `card_validation` object.
-     * - `card_decline` - Card Decline: details will be under the `card_decline`
-     *   object.
-     * - `card_reversal` - Card Reversal: details will be under the `card_reversal`
-     *   object.
-     * - `card_authorization_expiration` - Card Authorization Expiration: details will
-     *   be under the `card_authorization_expiration` object.
-     * - `card_increment` - Card Increment: details will be under the `card_increment`
-     *   object.
-     * - `card_settlement` - Card Settlement: details will be under the
-     *   `card_settlement` object.
-     * - `card_refund` - Card Refund: details will be under the `card_refund` object.
-     * - `card_fuel_confirmation` - Card Fuel Confirmation: details will be under the
-     *   `card_fuel_confirmation` object.
-     * - `card_financial` - Card Financial: details will be under the `card_financial`
-     *   object.
-     * - `other` - Unknown card payment element.
-     */
-    category:
-      | 'card_authorization'
-      | 'card_authentication'
-      | 'card_balance_inquiry'
-      | 'card_validation'
-      | 'card_decline'
-      | 'card_reversal'
-      | 'card_authorization_expiration'
-      | 'card_increment'
-      | 'card_settlement'
-      | 'card_refund'
-      | 'card_fuel_confirmation'
-      | 'card_financial'
-      | 'other';
-
-    /**
-     * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
-     * the card payment element was created.
-     */
-    created_at: string;
+    card_validation?: Element.CardValidation | null;
 
     /**
      * If the category of this Transaction source is equal to `other`, this field will
      * contain an empty object, otherwise it will contain null.
      */
-    other: Element.Other | null;
+    other?: Element.Other | null;
   }
 
   export namespace Element {

package/src/resources/card-push-transfers.ts

@@ -395,11 +395,6 @@ export namespace CardPushTransfer {
    * What object created the transfer, either via the API or the dashboard.
    */
   export interface CreatedBy {
-    /**
-     * If present, details about the API key that created the transfer.
-     */
-    api_key: CreatedBy.APIKey | null;
-
     /**
      * The type of object that created this transfer.
      *
@@ -411,15 +406,20 @@ export namespace CardPushTransfer {
      */
     category: 'api_key' | 'oauth_application' | 'user';
 
+    /**
+     * If present, details about the API key that created the transfer.
+     */
+    api_key?: CreatedBy.APIKey | null;
+
     /**
      * If present, details about the OAuth Application that created the transfer.
      */
-    oauth_application: CreatedBy.OAuthApplication | null;
+    oauth_application?: CreatedBy.OAuthApplication | null;
 
     /**
      * If present, details about the User that created the transfer.
      */
-    user: CreatedBy.User | null;
+    user?: CreatedBy.User | null;
   }
 
   export namespace CreatedBy {

package/src/resources/card-validations.ts

@@ -289,11 +289,6 @@ export namespace CardValidation {
    * What object created the validation, either via the API or the dashboard.
    */
   export interface CreatedBy {
-    /**
-     * If present, details about the API key that created the transfer.
-     */
-    api_key: CreatedBy.APIKey | null;
-
     /**
      * The type of object that created this transfer.
      *
@@ -305,15 +300,20 @@ export namespace CardValidation {
      */
     category: 'api_key' | 'oauth_application' | 'user';
 
+    /**
+     * If present, details about the API key that created the transfer.
+     */
+    api_key?: CreatedBy.APIKey | null;
+
     /**
      * If present, details about the OAuth Application that created the transfer.
      */
-    oauth_application: CreatedBy.OAuthApplication | null;
+    oauth_application?: CreatedBy.OAuthApplication | null;
 
     /**
      * If present, details about the User that created the transfer.
      */
-    user: CreatedBy.User | null;
+    user?: CreatedBy.User | null;
   }
 
   export namespace CreatedBy {