increase 0.322.0 → 0.324.0

package/src/resources/index.ts

@@ -68,6 +68,14 @@ export {
   type BookkeepingEntrySetCreateParams,
   type BookkeepingEntrySetListParams,
 } from './bookkeeping-entry-sets';
+export {
+  CardDisputesPage,
+  CardDisputes,
+  type CardDispute,
+  type CardDisputeCreateParams,
+  type CardDisputeListParams,
+  type CardDisputeSubmitUserSubmissionParams,
+} from './card-disputes';
 export {
   CardPaymentsPage,
   CardPayments,

package/src/resources/simulations/card-disputes.ts

@@ -0,0 +1,170 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../resource';
+import * as Core from '../../core';
+import * as CardDisputesAPI from '../card-disputes';
+
+export class CardDisputes extends APIResource {
+  /**
+   * After a [Card Dispute](#card-disputes) is created in production, the dispute
+   * will initially be in a `pending_user_submission_reviewing` state. Since no
+   * review or further action happens in sandbox, this endpoint simulates moving a
+   * Card Dispute through its various states.
+   *
+   * @example
+   * ```ts
+   * const cardDispute =
+   *   await client.simulations.cardDisputes.action(
+   *     'card_dispute_h9sc95nbl1cgltpp7men',
+   *     { network: 'visa' },
+   *   );
+   * ```
+   */
+  action(
+    cardDisputeId: string,
+    body: CardDisputeActionParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<CardDisputesAPI.CardDispute> {
+    return this._client.post(`/simulations/card_disputes/${cardDisputeId}/action`, { body, ...options });
+  }
+}
+
+export interface CardDisputeActionParams {
+  /**
+   * The network of the Card Dispute. Details specific to the network are required
+   * under the sub-object with the same identifier as the network.
+   *
+   * - `visa` - Visa
+   */
+  network: 'visa';
+
+  /**
+   * The Visa-specific parameters for the taking action on the dispute. Required if
+   * and only if `network` is `visa`.
+   */
+  visa?: CardDisputeActionParams.Visa;
+}
+
+export namespace CardDisputeActionParams {
+  /**
+   * The Visa-specific parameters for the taking action on the dispute. Required if
+   * and only if `network` is `visa`.
+   */
+  export interface Visa {
+    /**
+     * The action to take. Details specific to the action are required under the
+     * sub-object with the same identifier as the action.
+     *
+     * - `accept_chargeback` - Simulate the merchant accepting the chargeback. This
+     *   will move the dispute to a `won` state.
+     * - `accept_user_submission` - Accept the user's submission and transmit it to the
+     *   network. This will move the dispute to a `pending_response` state.
+     * - `decline_user_prearbitration` - Simulate the merchant declining the user's
+     *   pre-arbitration. This will move the dispute to a `lost` state.
+     * - `receive_merchant_prearbitration` - Simulate the merchant issuing
+     *   pre-arbitration. This will move the dispute to a `user_submission_required`
+     *   state.
+     * - `represent` - Simulate the merchant re-presenting the dispute. This will move
+     *   the dispute to a `user_submission_required` state.
+     * - `request_further_information` - Simulate further information being requested
+     *   from the user. This will move the dispute to a `user_submission_required`
+     *   state.
+     * - `time_out_chargeback` - Simulate the merchant timing out responding to the
+     *   chargeback. This will move the dispute to a `won` state.
+     * - `time_out_merchant_prearbitration` - Simulate the user timing out responding
+     *   to a merchant pre-arbitration. This will move the dispute to a `lost` state.
+     * - `time_out_representment` - Simulate the user timing out responding to a
+     *   merchant re-presentment. This will move the dispute to a `lost` state.
+     * - `time_out_user_prearbitration` - Simulate the merchant timing out responding
+     *   to a user pre-arbitration. This will move the dispute to a `win` state.
+     */
+    action:
+      | 'accept_chargeback'
+      | 'accept_user_submission'
+      | 'decline_user_prearbitration'
+      | 'receive_merchant_prearbitration'
+      | 'represent'
+      | 'request_further_information'
+      | 'time_out_chargeback'
+      | 'time_out_merchant_prearbitration'
+      | 'time_out_representment'
+      | 'time_out_user_prearbitration';
+
+    /**
+     * The parameters for accepting the chargeback. Required if and only if `action` is
+     * `accept_chargeback`.
+     */
+    accept_chargeback?: unknown;
+
+    /**
+     * The parameters for accepting the user submission. Required if and only if
+     * `action` is `accept_user_submission`.
+     */
+    accept_user_submission?: unknown;
+
+    /**
+     * The parameters for declining the prearbitration. Required if and only if
+     * `action` is `decline_user_prearbitration`.
+     */
+    decline_user_prearbitration?: unknown;
+
+    /**
+     * The parameters for receiving the prearbitration. Required if and only if
+     * `action` is `receive_merchant_prearbitration`.
+     */
+    receive_merchant_prearbitration?: unknown;
+
+    /**
+     * The parameters for re-presenting the dispute. Required if and only if `action`
+     * is `represent`.
+     */
+    represent?: unknown;
+
+    /**
+     * The parameters for requesting further information from the user. Required if and
+     * only if `action` is `request_further_information`.
+     */
+    request_further_information?: Visa.RequestFurtherInformation;
+
+    /**
+     * The parameters for timing out the chargeback. Required if and only if `action`
+     * is `time_out_chargeback`.
+     */
+    time_out_chargeback?: unknown;
+
+    /**
+     * The parameters for timing out the merchant prearbitration. Required if and only
+     * if `action` is `time_out_merchant_prearbitration`.
+     */
+    time_out_merchant_prearbitration?: unknown;
+
+    /**
+     * The parameters for timing out the re-presentment. Required if and only if
+     * `action` is `time_out_representment`.
+     */
+    time_out_representment?: unknown;
+
+    /**
+     * The parameters for timing out the user prearbitration. Required if and only if
+     * `action` is `time_out_user_prearbitration`.
+     */
+    time_out_user_prearbitration?: unknown;
+  }
+
+  export namespace Visa {
+    /**
+     * The parameters for requesting further information from the user. Required if and
+     * only if `action` is `request_further_information`.
+     */
+    export interface RequestFurtherInformation {
+      /**
+       * The reason for requesting further information from the user.
+       */
+      reason: string;
+    }
+  }
+}
+
+export declare namespace CardDisputes {
+  export { type CardDisputeActionParams as CardDisputeActionParams };
+}

package/src/resources/simulations/index.ts

@@ -17,6 +17,7 @@ export {
   type CardAuthorizationCreateResponse,
   type CardAuthorizationCreateParams,
 } from './card-authorizations';
+export { CardDisputes, type CardDisputeActionParams } from './card-disputes';
 export { CardFuelConfirmations, type CardFuelConfirmationCreateParams } from './card-fuel-confirmations';
 export { CardIncrements, type CardIncrementCreateParams } from './card-increments';
 export { CardRefunds, type CardRefundCreateParams } from './card-refunds';

package/src/resources/simulations/simulations.ts

@@ -23,6 +23,8 @@ import {
   CardAuthorizationCreateResponse,
   CardAuthorizations,
 } from './card-authorizations';
+import * as CardDisputesAPI from './card-disputes';
+import { CardDisputeActionParams, CardDisputes } from './card-disputes';
 import * as CardFuelConfirmationsAPI from './card-fuel-confirmations';
 import { CardFuelConfirmationCreateParams, CardFuelConfirmations } from './card-fuel-confirmations';
 import * as CardIncrementsAPI from './card-increments';
@@ -101,6 +103,7 @@ export class Simulations extends APIResource {
   cardFuelConfirmations: CardFuelConfirmationsAPI.CardFuelConfirmations =
     new CardFuelConfirmationsAPI.CardFuelConfirmations(this._client);
   cardRefunds: CardRefundsAPI.CardRefunds = new CardRefundsAPI.CardRefunds(this._client);
+  cardDisputes: CardDisputesAPI.CardDisputes = new CardDisputesAPI.CardDisputes(this._client);
   physicalCards: PhysicalCardsAPI.PhysicalCards = new PhysicalCardsAPI.PhysicalCards(this._client);
   digitalWalletTokenRequests: DigitalWalletTokenRequestsAPI.DigitalWalletTokenRequests =
     new DigitalWalletTokenRequestsAPI.DigitalWalletTokenRequests(this._client);
@@ -144,6 +147,7 @@ Simulations.CardReversals = CardReversals;
 Simulations.CardIncrements = CardIncrements;
 Simulations.CardFuelConfirmations = CardFuelConfirmations;
 Simulations.CardRefunds = CardRefunds;
+Simulations.CardDisputes = CardDisputes;
 Simulations.PhysicalCards = PhysicalCards;
 Simulations.DigitalWalletTokenRequests = DigitalWalletTokenRequests;
 Simulations.PendingTransactions = PendingTransactions;
@@ -199,6 +203,8 @@ export declare namespace Simulations {
 
   export { CardRefunds as CardRefunds, type CardRefundCreateParams as CardRefundCreateParams };
 
+  export { CardDisputes as CardDisputes, type CardDisputeActionParams as CardDisputeActionParams };
+
   export {
     PhysicalCards as PhysicalCards,
     type PhysicalCardCreateParams as PhysicalCardCreateParams,

package/src/resources/transactions.ts

@@ -179,7 +179,7 @@ export namespace Transaction {
     ach_transfer_return: Source.ACHTransferReturn | null;
 
     /**
-     * A Card Dispute Acceptance object. This field will be present in the JSON
+     * A Legacy Card Dispute Acceptance object. This field will be present in the JSON
      * response if and only if `category` is equal to `card_dispute_acceptance`.
      * Contains the details of a successful Card Dispute.
      */
@@ -193,9 +193,9 @@ export namespace Transaction {
     card_dispute_financial: Source.CardDisputeFinancial | null;
 
     /**
-     * A Card Dispute Loss object. This field will be present in the JSON response if
-     * and only if `category` is equal to `card_dispute_loss`. Contains the details of
-     * a lost Card Dispute.
+     * A Legacy Card Dispute Loss object. This field will be present in the JSON
+     * response if and only if `category` is equal to `card_dispute_loss`. Contains the
+     * details of a lost Card Dispute.
      */
     card_dispute_loss: Source.CardDisputeLoss | null;
 
@@ -261,11 +261,11 @@ export namespace Transaction {
      *   `ach_transfer_return` object.
      * - `cashback_payment` - Cashback Payment: details will be under the
      *   `cashback_payment` object.
-     * - `card_dispute_acceptance` - Card Dispute Acceptance: details will be under the
-     *   `card_dispute_acceptance` object.
+     * - `card_dispute_acceptance` - Legacy Card Dispute Acceptance: details will be
+     *   under the `card_dispute_acceptance` object.
      * - `card_dispute_financial` - Card Dispute Financial: details will be under the
      *   `card_dispute_financial` object.
-     * - `card_dispute_loss` - Card Dispute Loss: details will be under the
+     * - `card_dispute_loss` - Legacy Card Dispute Loss: details will be under the
      *   `card_dispute_loss` object.
      * - `card_refund` - Card Refund: details will be under the `card_refund` object.
      * - `card_settlement` - Card Settlement: details will be under the
@@ -925,7 +925,7 @@ export namespace Transaction {
     }
 
     /**
-     * A Card Dispute Acceptance object. This field will be present in the JSON
+     * A Legacy Card Dispute Acceptance object. This field will be present in the JSON
      * response if and only if `category` is equal to `card_dispute_acceptance`.
      * Contains the details of a successful Card Dispute.
      */
@@ -1008,9 +1008,9 @@ export namespace Transaction {
     }
 
     /**
-     * A Card Dispute Loss object. This field will be present in the JSON response if
-     * and only if `category` is equal to `card_dispute_loss`. Contains the details of
-     * a lost Card Dispute.
+     * A Legacy Card Dispute Loss object. This field will be present in the JSON
+     * response if and only if `category` is equal to `card_dispute_loss`. Contains the
+     * details of a lost Card Dispute.
      */
     export interface CardDisputeLoss {
       /**

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.322.0'; // x-release-please-version
+export const VERSION = '0.324.0'; // x-release-please-version

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.322.0";
+export declare const VERSION = "0.324.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.322.0'; // x-release-please-version
+exports.VERSION = '0.324.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.322.0'; // x-release-please-version
+export const VERSION = '0.324.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map