increase 0.1.0

package/resources/simulations/cards.ts

@@ -0,0 +1,979 @@
+// File generated from our OpenAPI spec by Stainless.
+
+import * as Core from '~/core';
+import { APIResource } from '~/resource';
+import * as Transactions from '~/resources/transactions';
+import * as Shared from '~/resources/shared';
+
+export class Cards extends APIResource {
+  /**
+   * Simulates a purchase authorization on a [Card](#cards). Depending on the balance
+   * available to the card and the `amount` submitted, the authorization activity
+   * will result in a [Pending Transaction](#pending-transactions) of type
+   * `card_authorization` or a [Declined Transaction](#declined-transactions) of type
+   * `card_decline`. You can pass either a Card id or a
+   * [Digital Wallet Token](#digital-wallet-tokens) id to simulate the two different
+   * ways purchases can be made.
+   */
+  authorize(
+    body: CardAuthorizeParams,
+    options?: Core.RequestOptions,
+  ): Promise<Core.APIResponse<CardAuthorizationSimulation>> {
+    return this.post('/simulations/card_authorizations', { body, ...options });
+  }
+
+  /**
+   * 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.
+   */
+  settlement(
+    body: CardSettlementParams,
+    options?: Core.RequestOptions,
+  ): Promise<Core.APIResponse<Transactions.Transaction>> {
+    return this.post('/simulations/card_settlements', { body, ...options });
+  }
+}
+
+/**
+ * The results of a Card Authorization simulation.
+ */
+export interface CardAuthorizationSimulation {
+  /**
+   * If the authorization attempt fails, this will contain the resulting
+   * [Declined Transaction](#declined-transactions) object. The Declined
+   * Transaction's `source` will be of `category: card_decline`.
+   */
+  declined_transaction: CardAuthorizationSimulation.DeclinedTransaction | null;
+
+  /**
+   * If the authorization attempt succeeds, this will contain the resulting Pending
+   * Transaction object. The Pending Transaction's `source` will be of
+   * `category: card_authorization`.
+   */
+  pending_transaction: CardAuthorizationSimulation.PendingTransaction | null;
+
+  /**
+   * A constant representing the object's type. For this resource it will always be
+   * `inbound_card_authorization_simulation_result`.
+   */
+  type: 'inbound_card_authorization_simulation_result';
+}
+
+export namespace CardAuthorizationSimulation {
+  export interface PendingTransaction {
+    /**
+     * The identifier for the account this Pending Transaction belongs to.
+     */
+    account_id: string;
+
+    /**
+     * The Pending Transaction amount in the minor unit of its currency. For dollars,
+     * for example, this is cents.
+     */
+    amount: number;
+
+    /**
+     * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date on which the Pending
+     * Transaction occured.
+     */
+    created_at: string;
+
+    /**
+     * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the Pending
+     * Transaction's currency. This will match the currency on the Pending
+     * Transcation's Account.
+     */
+    currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
+
+    /**
+     * For a Pending Transaction related to a transfer, this is the description you
+     * provide. For a Pending Transaction related to a payment, this is the description
+     * the vendor provides.
+     */
+    description: string;
+
+    /**
+     * The Pending Transaction identifier.
+     */
+    id: string;
+
+    /**
+     * The identifier for the route this Pending Transaction came through. Routes are
+     * things like cards and ACH details.
+     */
+    route_id: string | null;
+
+    /**
+     * The type of the route this Pending Transaction came through.
+     */
+    route_type: string | null;
+
+    /**
+     * This is an object giving more details on the network-level event that caused the
+     * Pending Transaction. For example, for a card transaction this lists the
+     * merchant's industry and location.
+     */
+    source: PendingTransaction.Source;
+
+    /**
+     * Whether the Pending Transaction has been confirmed and has an associated
+     * Transaction.
+     */
+    status: 'pending' | 'complete';
+
+    /**
+     * A constant representing the object's type. For this resource it will always be
+     * `pending_transaction`.
+     */
+    type: 'pending_transaction';
+  }
+
+  export namespace PendingTransaction {
+    export interface Source {
+      /**
+       * A Account Transfer Instruction object. This field will be present in the JSON
+       * response if and only if `category` is equal to `account_transfer_instruction`.
+       */
+      account_transfer_instruction: Source.AccountTransferInstruction | null;
+
+      /**
+       * A ACH Transfer Instruction object. This field will be present in the JSON
+       * response if and only if `category` is equal to `ach_transfer_instruction`.
+       */
+      ach_transfer_instruction: Source.ACHTransferInstruction | null;
+
+      /**
+       * A Card Authorization object. This field will be present in the JSON response if
+       * and only if `category` is equal to `card_authorization`.
+       */
+      card_authorization: Source.CardAuthorization | null;
+
+      /**
+       * A Deprecated Card Authorization object. This field will be present in the JSON
+       * response if and only if `category` is equal to `card_route_authorization`.
+       */
+      card_route_authorization: Source.CardRouteAuthorization | null;
+
+      /**
+       * The type of transaction that took place. We may add additional possible values
+       * for this enum over time; your application should be able to handle such
+       * additions gracefully.
+       */
+      category:
+        | 'account_transfer_instruction'
+        | 'ach_transfer_instruction'
+        | 'card_authorization'
+        | 'check_deposit_instruction'
+        | 'check_transfer_instruction'
+        | 'inbound_funds_hold'
+        | 'card_route_authorization'
+        | 'real_time_payments_transfer_instruction'
+        | 'wire_drawdown_payment_instruction'
+        | 'wire_transfer_instruction'
+        | 'other';
+
+      /**
+       * A Check Deposit Instruction object. This field will be present in the JSON
+       * response if and only if `category` is equal to `check_deposit_instruction`.
+       */
+      check_deposit_instruction: Source.CheckDepositInstruction | null;
+
+      /**
+       * A Check Transfer Instruction object. This field will be present in the JSON
+       * response if and only if `category` is equal to `check_transfer_instruction`.
+       */
+      check_transfer_instruction: Source.CheckTransferInstruction | null;
+
+      /**
+       * A Inbound Funds Hold object. This field will be present in the JSON response if
+       * and only if `category` is equal to `inbound_funds_hold`.
+       */
+      inbound_funds_hold: Source.InboundFundsHold | null;
+
+      /**
+       * A Wire Drawdown Payment Instruction object. This field will be present in the
+       * JSON response if and only if `category` is equal to
+       * `wire_drawdown_payment_instruction`.
+       */
+      wire_drawdown_payment_instruction: Source.WireDrawdownPaymentInstruction | null;
+
+      /**
+       * A Wire Transfer Instruction object. This field will be present in the JSON
+       * response if and only if `category` is equal to `wire_transfer_instruction`.
+       */
+      wire_transfer_instruction: Source.WireTransferInstruction | null;
+    }
+
+    export namespace Source {
+      export interface AccountTransferInstruction {
+        /**
+         * The pending amount in the minor unit of the transaction's currency. For dollars,
+         * for example, this is cents.
+         */
+        amount: number;
+
+        /**
+         * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the destination
+         * account currency.
+         */
+        currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
+
+        /**
+         * The identifier of the Account Transfer that led to this Pending Transaction.
+         */
+        transfer_id: string;
+      }
+
+      export interface ACHTransferInstruction {
+        /**
+         * The pending amount in the minor unit of the transaction's currency. For dollars,
+         * for example, this is cents.
+         */
+        amount: number;
+
+        /**
+         * The identifier of the ACH Transfer that led to this Pending Transaction.
+         */
+        transfer_id: string;
+      }
+
+      export interface CardAuthorization {
+        /**
+         * The pending amount in the minor unit of the transaction's currency. For dollars,
+         * for example, this is cents.
+         */
+        amount: number;
+
+        /**
+         * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the
+         * transaction's currency.
+         */
+        currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
+
+        /**
+         * If the authorization was made via a Digital Wallet Token (such as an Apple Pay
+         * purchase), the identifier of the token that was used.
+         */
+        digital_wallet_token_id: string | null;
+
+        /**
+         * The merchant identifier (commonly abbreviated as MID) of the merchant the card
+         * is transacting with.
+         */
+        merchant_acceptor_id: string;
+
+        /**
+         * The Merchant Category Code (commonly abbreviated as MCC) of the merchant the
+         * card is transacting with.
+         */
+        merchant_category_code: string | null;
+
+        /**
+         * The city the merchant resides in.
+         */
+        merchant_city: string | null;
+
+        /**
+         * The country the merchant resides in.
+         */
+        merchant_country: string | null;
+
+        /**
+         * The merchant descriptor of the merchant the card is transacting with.
+         */
+        merchant_descriptor: string;
+
+        /**
+         * The payment network used to process this card authorization
+         */
+        network: 'visa';
+
+        /**
+         * Fields specific to the `network`
+         */
+        network_details: CardAuthorization.NetworkDetails;
+
+        /**
+         * The identifier of the Real-Time Decision sent to approve or decline this
+         * transaction.
+         */
+        real_time_decision_id: string | null;
+      }
+
+      export namespace CardAuthorization {
+        export interface NetworkDetails {
+          /**
+           * Fields specific to the `visa` network
+           */
+          visa: NetworkDetails.Visa;
+        }
+
+        export namespace NetworkDetails {
+          export interface Visa {
+            /**
+             * For electronic commerce transactions, this identifies the level of security used
+             * in obtaining the customer's payment credential. For mail or telephone order
+             * transactions, identifies the type of mail or telephone order.
+             */
+            electronic_commerce_indicator:
+              | 'mail_phone_order'
+              | 'recurring'
+              | 'installment'
+              | 'unknown_mail_phone_order'
+              | 'secure_electronic_commerce'
+              | 'non_authenticated_security_transaction_at_3ds_capable_merchant'
+              | 'non_authenticated_security_transaction'
+              | 'non_secure_transaction'
+              | null;
+
+            /**
+             * The method used to enter the cardholder's primary account number and card
+             * expiration date
+             */
+            point_of_service_entry_mode: Shared.PointOfServiceEntryMode;
+          }
+        }
+      }
+
+      export interface CheckDepositInstruction {
+        /**
+         * The pending amount in the minor unit of the transaction's currency. For dollars,
+         * for example, this is cents.
+         */
+        amount: number;
+
+        /**
+         * The identifier of the File containing the image of the back of the check that
+         * was deposited.
+         */
+        back_image_file_id: string | null;
+
+        /**
+         * The identifier of the Check Deposit.
+         */
+        check_deposit_id: string | null;
+
+        /**
+         * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the
+         * transaction's currency.
+         */
+        currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
+
+        /**
+         * The identifier of the File containing the image of the front of the check that
+         * was deposited.
+         */
+        front_image_file_id: string;
+      }
+
+      export interface CheckTransferInstruction {
+        /**
+         * The pending amount in the minor unit of the transaction's currency. For dollars,
+         * for example, this is cents.
+         */
+        amount: number;
+
+        /**
+         * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the check's
+         * currency.
+         */
+        currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
+
+        /**
+         * The identifier of the Check Transfer that led to this Pending Transaction.
+         */
+        transfer_id: string;
+      }
+
+      export interface InboundFundsHold {
+        /**
+         * The held amount in the minor unit of the account's currency. For dollars, for
+         * example, this is cents.
+         */
+        amount: number;
+
+        /**
+         * When the hold will be released automatically. Certain conditions may cause it to
+         * be released before this time.
+         */
+        automatically_releases_at: string;
+
+        /**
+         * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the hold's
+         * currency.
+         */
+        currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
+
+        /**
+         * The ID of the Transaction for which funds were held.
+         */
+        held_transaction_id: string | null;
+
+        /**
+         * When the hold was released (if it has been released).
+         */
+        released_at: string | null;
+
+        /**
+         * The status of the hold.
+         */
+        status: 'held' | 'complete';
+      }
+
+      export interface CardRouteAuthorization {
+        /**
+         * The pending amount in the minor unit of the transaction's currency. For dollars,
+         * for example, this is cents.
+         */
+        amount: number;
+
+        /**
+         * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the
+         * transaction's currency.
+         */
+        currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
+
+        merchant_acceptor_id: string;
+
+        merchant_category_code: string;
+
+        merchant_city: string | null;
+
+        merchant_country: string;
+
+        merchant_descriptor: string;
+
+        merchant_state: string | null;
+      }
+
+      export interface WireDrawdownPaymentInstruction {
+        account_number: string;
+
+        /**
+         * The pending amount in the minor unit of the transaction's currency. For dollars,
+         * for example, this is cents.
+         */
+        amount: number;
+
+        message_to_recipient: string;
+
+        routing_number: string;
+      }
+
+      export interface WireTransferInstruction {
+        account_number: string;
+
+        /**
+         * The pending amount in the minor unit of the transaction's currency. For dollars,
+         * for example, this is cents.
+         */
+        amount: number;
+
+        message_to_recipient: string;
+
+        routing_number: string;
+
+        transfer_id: string;
+      }
+    }
+  }
+
+  export interface DeclinedTransaction {
+    /**
+     * The identifier for the Account the Declined Transaction belongs to.
+     */
+    account_id: string;
+
+    /**
+     * The Declined Transaction amount in the minor unit of its currency. For dollars,
+     * for example, this is cents.
+     */
+    amount: number;
+
+    /**
+     * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date on which the
+     * Transaction occured.
+     */
+    created_at: string;
+
+    /**
+     * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the Declined
+     * Transaction's currency. This will match the currency on the Declined
+     * Transcation's Account.
+     */
+    currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
+
+    /**
+     * This is the description the vendor provides.
+     */
+    description: string;
+
+    /**
+     * The Declined Transaction identifier.
+     */
+    id: string;
+
+    /**
+     * The identifier for the route this Declined Transaction came through. Routes are
+     * things like cards and ACH details.
+     */
+    route_id: string | null;
+
+    /**
+     * The type of the route this Declined Transaction came through.
+     */
+    route_type: string | null;
+
+    /**
+     * This is an object giving more details on the network-level event that caused the
+     * Declined Transaction. For example, for a card transaction this lists the
+     * merchant's industry and location. Note that for backwards compatibility reasons,
+     * additional undocumented keys may appear in this object. These should be treated
+     * as deprecated and will be removed in the future.
+     */
+    source: DeclinedTransaction.Source;
+
+    /**
+     * A constant representing the object's type. For this resource it will always be
+     * `declined_transaction`.
+     */
+    type: 'declined_transaction';
+  }
+
+  export namespace DeclinedTransaction {
+    export interface Source {
+      /**
+       * A ACH Decline object. This field will be present in the JSON response if and
+       * only if `category` is equal to `ach_decline`.
+       */
+      ach_decline: Source.ACHDecline | 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: Source.CardDecline | null;
+
+      /**
+       * A Deprecated Card Decline object. This field will be present in the JSON
+       * response if and only if `category` is equal to `card_route_decline`.
+       */
+      card_route_decline: Source.CardRouteDecline | null;
+
+      /**
+       * The type of decline that took place. We may add additional possible values for
+       * this enum over time; your application should be able to handle such additions
+       * gracefully.
+       */
+      category:
+        | 'ach_decline'
+        | 'card_decline'
+        | 'check_decline'
+        | 'inbound_real_time_payments_transfer_decline'
+        | 'international_ach_decline'
+        | 'card_route_decline'
+        | 'other';
+
+      /**
+       * A Check Decline object. This field will be present in the JSON response if and
+       * only if `category` is equal to `check_decline`.
+       */
+      check_decline: Source.CheckDecline | null;
+
+      /**
+       * A Inbound Real Time Payments Transfer Decline object. This field will be present
+       * in the JSON response if and only if `category` is equal to
+       * `inbound_real_time_payments_transfer_decline`.
+       */
+      inbound_real_time_payments_transfer_decline: Source.InboundRealTimePaymentsTransferDecline | null;
+
+      /**
+       * A International ACH Decline object. This field will be present in the JSON
+       * response if and only if `category` is equal to `international_ach_decline`.
+       */
+      international_ach_decline: Source.InternationalACHDecline | null;
+    }
+
+    export namespace Source {
+      export interface ACHDecline {
+        /**
+         * The declined amount in the minor unit of the destination account currency. For
+         * dollars, for example, this is cents.
+         */
+        amount: number;
+
+        originator_company_descriptive_date: string | null;
+
+        originator_company_discretionary_data: string | null;
+
+        originator_company_id: string;
+
+        originator_company_name: string;
+
+        /**
+         * Why the ACH transfer was declined.
+         */
+        reason:
+          | 'ach_route_canceled'
+          | 'ach_route_disabled'
+          | 'breaches_limit'
+          | 'credit_entry_refused_by_receiver'
+          | 'duplicate_return'
+          | 'entity_not_active'
+          | 'transaction_not_allowed'
+          | 'group_locked'
+          | 'insufficient_funds'
+          | 'no_ach_route'
+          | 'originator_request';
+
+        receiver_id_number: string | null;
+
+        receiver_name: string | null;
+
+        trace_number: string;
+      }
+
+      export interface CardDecline {
+        /**
+         * The declined amount in the minor unit of the destination account currency. For
+         * dollars, for example, this is cents.
+         */
+        amount: number;
+
+        /**
+         * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the destination
+         * account currency.
+         */
+        currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
+
+        /**
+         * If the authorization was attempted using a Digital Wallet Token (such as an
+         * Apple Pay purchase), the identifier of the token that was used.
+         */
+        digital_wallet_token_id: string | null;
+
+        /**
+         * The merchant identifier (commonly abbreviated as MID) of the merchant the card
+         * is transacting with.
+         */
+        merchant_acceptor_id: string;
+
+        /**
+         * The Merchant Category Code (commonly abbreviated as MCC) of the merchant the
+         * card is transacting with.
+         */
+        merchant_category_code: string | null;
+
+        /**
+         * The city the merchant resides in.
+         */
+        merchant_city: string | null;
+
+        /**
+         * The country the merchant resides in.
+         */
+        merchant_country: string | null;
+
+        /**
+         * The merchant descriptor of the merchant the card is transacting with.
+         */
+        merchant_descriptor: string;
+
+        /**
+         * The state the merchant resides in.
+         */
+        merchant_state: string | null;
+
+        /**
+         * The payment network used to process this card authorization
+         */
+        network: 'visa';
+
+        /**
+         * Fields specific to the `network`
+         */
+        network_details: CardDecline.NetworkDetails;
+
+        /**
+         * The identifier of the Real-Time Decision sent to approve or decline this
+         * transaction.
+         */
+        real_time_decision_id: string | null;
+
+        /**
+         * Why the transaction was declined.
+         */
+        reason:
+          | 'card_not_active'
+          | 'entity_not_active'
+          | 'group_locked'
+          | 'insufficient_funds'
+          | 'cvv2_mismatch'
+          | 'transaction_not_allowed'
+          | 'breaches_limit'
+          | 'webhook_declined'
+          | 'webhook_timed_out'
+          | 'declined_by_stand_in_processing';
+      }
+
+      export namespace CardDecline {
+        export interface NetworkDetails {
+          /**
+           * Fields specific to the `visa` network
+           */
+          visa: NetworkDetails.Visa;
+        }
+
+        export namespace NetworkDetails {
+          export interface Visa {
+            /**
+             * For electronic commerce transactions, this identifies the level of security used
+             * in obtaining the customer's payment credential. For mail or telephone order
+             * transactions, identifies the type of mail or telephone order.
+             */
+            electronic_commerce_indicator:
+              | 'mail_phone_order'
+              | 'recurring'
+              | 'installment'
+              | 'unknown_mail_phone_order'
+              | 'secure_electronic_commerce'
+              | 'non_authenticated_security_transaction_at_3ds_capable_merchant'
+              | 'non_authenticated_security_transaction'
+              | 'non_secure_transaction'
+              | null;
+
+            /**
+             * The method used to enter the cardholder's primary account number and card
+             * expiration date
+             */
+            point_of_service_entry_mode: Shared.PointOfServiceEntryMode;
+          }
+        }
+      }
+
+      export interface CheckDecline {
+        /**
+         * The declined amount in the minor unit of the destination account currency. For
+         * dollars, for example, this is cents.
+         */
+        amount: number;
+
+        auxiliary_on_us: string | null;
+
+        /**
+         * Why the check was declined.
+         */
+        reason:
+          | 'ach_route_canceled'
+          | 'ach_route_disabled'
+          | 'breaches_limit'
+          | 'entity_not_active'
+          | 'group_locked'
+          | 'insufficient_funds'
+          | 'unable_to_locate_account'
+          | 'unable_to_process'
+          | 'refer_to_image'
+          | 'stop_payment_requested'
+          | 'returned';
+      }
+
+      export interface InboundRealTimePaymentsTransferDecline {
+        /**
+         * The declined amount in the minor unit of the destination account currency. For
+         * dollars, for example, this is cents.
+         */
+        amount: number;
+
+        /**
+         * The name the sender of the transfer specified as the recipient of the transfer.
+         */
+        creditor_name: string;
+
+        /**
+         * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code of the declined
+         * transfer's currency. This will always be "USD" for a Real Time Payments
+         * transfer.
+         */
+        currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
+
+        /**
+         * The account number of the account that sent the transfer.
+         */
+        debtor_account_number: string;
+
+        /**
+         * The name provided by the sender of the transfer.
+         */
+        debtor_name: string;
+
+        /**
+         * The routing number of the account that sent the transfer.
+         */
+        debtor_routing_number: string;
+
+        /**
+         * Why the transfer was declined.
+         */
+        reason:
+          | 'account_number_canceled'
+          | 'account_number_disabled'
+          | 'group_locked'
+          | 'entity_not_active'
+          | 'real_time_payments_not_enabled';
+
+        /**
+         * Additional information included with the transfer.
+         */
+        remittance_information: string | null;
+
+        /**
+         * The Real Time Payments network identification of the declined transfer.
+         */
+        transaction_identification: string;
+      }
+
+      export interface InternationalACHDecline {
+        /**
+         * The declined amount in the minor unit of the destination account currency. For
+         * dollars, for example, this is cents.
+         */
+        amount: number;
+
+        destination_country_code: string;
+
+        destination_currency_code: string;
+
+        foreign_exchange_indicator: string;
+
+        foreign_exchange_reference: string | null;
+
+        foreign_exchange_reference_indicator: string;
+
+        foreign_payment_amount: number;
+
+        foreign_trace_number: string | null;
+
+        international_transaction_type_code: string;
+
+        originating_currency_code: string;
+
+        originating_depository_financial_institution_branch_country: string;
+
+        originating_depository_financial_institution_id: string;
+
+        originating_depository_financial_institution_id_qualifier: string;
+
+        originating_depository_financial_institution_name: string;
+
+        originator_city: string;
+
+        originator_company_entry_description: string;
+
+        originator_country: string;
+
+        originator_identification: string;
+
+        originator_name: string;
+
+        originator_postal_code: string | null;
+
+        originator_state_or_province: string | null;
+
+        originator_street_address: string;
+
+        payment_related_information: string | null;
+
+        payment_related_information2: string | null;
+
+        receiver_city: string;
+
+        receiver_country: string;
+
+        receiver_identification_number: string | null;
+
+        receiver_postal_code: string | null;
+
+        receiver_state_or_province: string | null;
+
+        receiver_street_address: string;
+
+        receiving_company_or_individual_name: string;
+
+        receiving_depository_financial_institution_country: string;
+
+        receiving_depository_financial_institution_id: string;
+
+        receiving_depository_financial_institution_id_qualifier: string;
+
+        receiving_depository_financial_institution_name: string;
+
+        trace_number: string;
+      }
+
+      export interface CardRouteDecline {
+        /**
+         * The declined amount in the minor unit of the destination account currency. For
+         * dollars, for example, this is cents.
+         */
+        amount: number;
+
+        /**
+         * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the destination
+         * account currency.
+         */
+        currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
+
+        merchant_acceptor_id: string;
+
+        merchant_category_code: string | null;
+
+        merchant_city: string | null;
+
+        merchant_country: string;
+
+        merchant_descriptor: string;
+
+        merchant_state: string | null;
+      }
+    }
+  }
+}
+
+export interface CardAuthorizeParams {
+  /**
+   * The authorization amount in cents.
+   */
+  amount: number;
+
+  /**
+   * The identifier of the Card to be authorized.
+   */
+  card_id?: string;
+
+  /**
+   * The identifier of the Digital Wallet Token to be authorized.
+   */
+  digital_wallet_token_id?: string;
+}
+
+export interface CardSettlementParams {
+  /**
+   * The identifier of the Card to create a settlement on.
+   */
+  card_id: string;
+
+  /**
+   * The identifier of the Pending Transaction for the Card Authorization you wish to
+   * settle.
+   */
+  pending_transaction_id: string;
+
+  /**
+   * The amount to be settled. This defaults to the amount of the Pending Transaction
+   * being settled.
+   */
+  amount?: number;
+}