increase 0.2.0 → 0.4.0

package/resources/simulations/real-time-payments-transfers.ts

@@ -2,9 +2,26 @@
 
 import * as Core from '~/core';
 import { APIResource } from '~/resource';
+import * as RealTimePaymentsTransfers_ from '~/resources/real-time-payments-transfers';
 import * as Shared from '~/resources/shared';
 
 export class RealTimePaymentsTransfers extends APIResource {
+  /**
+   * Simulates submission of a Real Time Payments transfer and handling the response
+   * from the destination financial institution. This transfer must first have a
+   * `status` of `pending_submission`.
+   */
+  complete(
+    realTimePaymentsTransferId: string,
+    body: RealTimePaymentsTransferCompleteParams,
+    options?: Core.RequestOptions,
+  ): Promise<Core.APIResponse<RealTimePaymentsTransfers_.RealTimePaymentsTransfer>> {
+    return this.post(`/simulations/real_time_payments_transfers/${realTimePaymentsTransferId}/complete`, {
+      body,
+      ...options,
+    });
+  }
+
   /**
    * Simulates an inbound Real Time Payments transfer to your account. Real Time
    * Payments are a beta feature.
@@ -44,6 +61,11 @@ export interface InboundRealTimePaymentsTransferSimulationResult {
 }
 
 export namespace InboundRealTimePaymentsTransferSimulationResult {
+  /**
+   * If the Real Time Payments Transfer attempt succeeds, this will contain the
+   * resulting [Transaction](#transactions) object. The Transaction's `source` will
+   * be of `category: inbound_real_time_payments_transfer_confirmation`.
+   */
   export interface Transaction {
     /**
      * The identifier for the Account the Transaction belongs to.
@@ -90,7 +112,7 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
     /**
      * The type of the route this Transaction came through.
      */
-    route_type: string | null;
+    route_type: 'account_number' | 'card' | null;
 
     /**
      * This is an object giving more details on the network-level event that caused the
@@ -108,6 +130,12 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
   }
 
   export namespace Transaction {
+    /**
+     * This is an object giving more details on the network-level event that caused the
+     * Transaction. 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.
+     */
     export interface Source {
       /**
        * A Account Transfer Intention object. This field will be present in the JSON
@@ -115,18 +143,6 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
        */
       account_transfer_intention: Source.AccountTransferIntention | null;
 
-      /**
-       * A ACH Check Conversion object. This field will be present in the JSON response
-       * if and only if `category` is equal to `ach_check_conversion`.
-       */
-      ach_check_conversion: Source.ACHCheckConversion | null;
-
-      /**
-       * A ACH Check Conversion Return object. This field will be present in the JSON
-       * response if and only if `category` is equal to `ach_check_conversion_return`.
-       */
-      ach_check_conversion_return: Source.ACHCheckConversionReturn | null;
-
       /**
        * A ACH Transfer Intention object. This field will be present in the JSON response
        * if and only if `category` is equal to `ach_transfer_intention`.
@@ -158,16 +174,10 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
       card_refund: Source.CardRefund | null;
 
       /**
-       * A Deprecated Card Refund object. This field will be present in the JSON response
-       * if and only if `category` is equal to `card_route_refund`.
+       * A Card Revenue Payment object. This field will be present in the JSON response
+       * if and only if `category` is equal to `card_revenue_payment`.
        */
-      card_route_refund: Source.CardRouteRefund | null;
-
-      /**
-       * A Deprecated Card Settlement object. This field will be present in the JSON
-       * response if and only if `category` is equal to `card_route_settlement`.
-       */
-      card_route_settlement: Source.CardRouteSettlement | null;
+      card_revenue_payment: Source.CardRevenuePayment | null;
 
       /**
        * A Card Settlement object. This field will be present in the JSON response if and
@@ -182,22 +192,20 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
        */
       category:
         | 'account_transfer_intention'
-        | 'ach_check_conversion_return'
-        | 'ach_check_conversion'
         | 'ach_transfer_intention'
         | 'ach_transfer_rejection'
         | 'ach_transfer_return'
         | 'card_dispute_acceptance'
         | 'card_refund'
         | 'card_settlement'
+        | 'card_revenue_payment'
         | 'check_deposit_acceptance'
         | 'check_deposit_return'
         | 'check_transfer_intention'
         | 'check_transfer_return'
         | 'check_transfer_rejection'
         | 'check_transfer_stop_payment_request'
-        | 'dispute_resolution'
-        | 'empyreal_cash_deposit'
+        | 'fee_payment'
         | 'inbound_ach_transfer'
         | 'inbound_ach_transfer_return_intention'
         | 'inbound_check'
@@ -208,14 +216,9 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         | 'inbound_wire_reversal'
         | 'inbound_wire_transfer'
         | 'interest_payment'
-        | 'internal_general_ledger_transaction'
         | 'internal_source'
-        | 'card_route_refund'
-        | 'card_route_settlement'
         | 'real_time_payments_transfer_acknowledgement'
         | 'sample_funds'
-        | 'wire_drawdown_payment_intention'
-        | 'wire_drawdown_payment_rejection'
         | 'wire_transfer_intention'
         | 'wire_transfer_rejection'
         | 'other';
@@ -258,16 +261,10 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
       check_transfer_stop_payment_request: Source.CheckTransferStopPaymentRequest | null;
 
       /**
-       * A Dispute Resolution object. This field will be present in the JSON response if
-       * and only if `category` is equal to `dispute_resolution`.
+       * A Fee Payment object. This field will be present in the JSON response if and
+       * only if `category` is equal to `fee_payment`.
        */
-      dispute_resolution: Source.DisputeResolution | null;
-
-      /**
-       * A Empyreal Cash Deposit object. This field will be present in the JSON response
-       * if and only if `category` is equal to `empyreal_cash_deposit`.
-       */
-      empyreal_cash_deposit: Source.EmpyrealCashDeposit | null;
+      fee_payment: Source.FeePayment | null;
 
       /**
        * A Inbound ACH Transfer object. This field will be present in the JSON response
@@ -333,24 +330,17 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
       internal_source: Source.InternalSource | null;
 
       /**
-       * A Sample Funds object. This field will be present in the JSON response if and
-       * only if `category` is equal to `sample_funds`.
-       */
-      sample_funds: Source.SampleFunds | null;
-
-      /**
-       * A Wire Drawdown Payment Intention object. This field will be present in the JSON
-       * response if and only if `category` is equal to
-       * `wire_drawdown_payment_intention`.
+       * A Real Time Payments Transfer Acknowledgement object. This field will be present
+       * in the JSON response if and only if `category` is equal to
+       * `real_time_payments_transfer_acknowledgement`.
        */
-      wire_drawdown_payment_intention: Source.WireDrawdownPaymentIntention | null;
+      real_time_payments_transfer_acknowledgement: Source.RealTimePaymentsTransferAcknowledgement | null;
 
       /**
-       * A Wire Drawdown Payment Rejection object. This field will be present in the JSON
-       * response if and only if `category` is equal to
-       * `wire_drawdown_payment_rejection`.
+       * A Sample Funds object. This field will be present in the JSON response if and
+       * only if `category` is equal to `sample_funds`.
        */
-      wire_drawdown_payment_rejection: Source.WireDrawdownPaymentRejection | null;
+      sample_funds: Source.SampleFunds | null;
 
       /**
        * A Wire Transfer Intention object. This field will be present in the JSON
@@ -366,6 +356,10 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
     }
 
     export namespace Source {
+      /**
+       * A Account Transfer Intention object. This field will be present in the JSON
+       * response if and only if `category` is equal to `account_transfer_intention`.
+       */
       export interface AccountTransferIntention {
         /**
          * The pending amount in the minor unit of the transaction's currency. For dollars,
@@ -400,32 +394,10 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         transfer_id: string;
       }
 
-      export interface ACHCheckConversionReturn {
-        /**
-         * The amount in the minor unit of the transaction's currency. For dollars, for
-         * example, this is cents.
-         */
-        amount: number;
-
-        /**
-         * Why the transfer was returned.
-         */
-        return_reason_code: string;
-      }
-
-      export interface ACHCheckConversion {
-        /**
-         * The 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 an image of the returned check.
-         */
-        file_id: string;
-      }
-
+      /**
+       * A ACH Transfer Intention object. This field will be present in the JSON response
+       * if and only if `category` is equal to `ach_transfer_intention`.
+       */
       export interface ACHTransferIntention {
         account_number: string;
 
@@ -445,6 +417,10 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         transfer_id: string;
       }
 
+      /**
+       * A ACH Transfer Rejection object. This field will be present in the JSON response
+       * if and only if `category` is equal to `ach_transfer_rejection`.
+       */
       export interface ACHTransferRejection {
         /**
          * The identifier of the ACH Transfer that led to this Transaction.
@@ -452,6 +428,10 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         transfer_id: string;
       }
 
+      /**
+       * A ACH Transfer Return object. This field will be present in the JSON response if
+       * and only if `category` is equal to `ach_transfer_return`.
+       */
       export interface ACHTransferReturn {
         /**
          * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
@@ -459,6 +439,11 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
          */
         created_at: string;
 
+        /**
+         * The three character ACH return code, in the range R01 to R85.
+         */
+        raw_return_reason_code: string;
+
         /**
          * Why the ACH Transfer was returned.
          */
@@ -482,10 +467,58 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
           | 'file_record_edit_criteria'
           | 'enr_invalid_individual_name'
           | 'returned_per_odfi_request'
-          | 'addenda_error'
           | 'limited_participation_dfi'
           | 'incorrectly_coded_outbound_international_payment'
-          | 'other';
+          | 'other'
+          | 'account_sold_to_another_dfi'
+          | 'addenda_error'
+          | 'beneficiary_or_account_holder_deceased'
+          | 'customer_advised_not_within_authorization_terms'
+          | 'corrected_return'
+          | 'duplicate_entry'
+          | 'duplicate_return'
+          | 'enr_duplicate_enrollment'
+          | 'enr_invalid_dfi_account_number'
+          | 'enr_invalid_individual_id_number'
+          | 'enr_invalid_representative_payee_indicator'
+          | 'enr_invalid_transaction_code'
+          | 'enr_return_of_enr_entry'
+          | 'enr_routing_number_check_digit_error'
+          | 'entry_not_processed_by_gateway'
+          | 'field_error'
+          | 'foreign_receiving_dfi_unable_to_settle'
+          | 'iat_entry_coding_error'
+          | 'improper_effective_entry_date'
+          | 'improper_source_document_source_document_presented'
+          | 'invalid_company_id'
+          | 'invalid_foreign_receiving_dfi_identification'
+          | 'invalid_individual_id_number'
+          | 'item_and_rck_entry_presented_for_payment'
+          | 'item_related_to_rck_entry_is_ineligible'
+          | 'mandatory_field_error'
+          | 'misrouted_dishonored_return'
+          | 'misrouted_return'
+          | 'no_errors_found'
+          | 'non_acceptance_of_r62_dishonored_return'
+          | 'non_participant_in_iat_program'
+          | 'permissible_return_entry'
+          | 'permissible_return_entry_not_accepted'
+          | 'rdfi_non_settlement'
+          | 'rdfi_participant_in_check_truncation_program'
+          | 'representative_payee_deceased_or_unable_to_continue_in_that_capacity'
+          | 'return_not_a_duplicate'
+          | 'return_of_erroneous_or_reversing_debit'
+          | 'return_of_improper_credit_entry'
+          | 'return_of_improper_debit_entry'
+          | 'return_of_xck_entry'
+          | 'source_document_presented_for_payment'
+          | 'state_law_affecting_rck_acceptance'
+          | 'stop_payment_on_item_related_to_rck_entry'
+          | 'stop_payment_on_source_document'
+          | 'timely_original_return'
+          | 'trace_number_error'
+          | 'untimely_dishonored_return'
+          | 'untimely_return';
 
         /**
          * The identifier of the Tranasaction associated with this return.
@@ -498,6 +531,10 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         transfer_id: string;
       }
 
+      /**
+       * A Card Dispute Acceptance object. This field will be present in the JSON
+       * response if and only if `category` is equal to `card_dispute_acceptance`.
+       */
       export interface CardDisputeAcceptance {
         /**
          * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
@@ -514,9 +551,13 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
          * The identifier of the Transaction that was created to return the disputed funds
          * to your account.
          */
-        transaction_id: string | null;
+        transaction_id: string;
       }
 
+      /**
+       * A Card Refund object. This field will be present in the JSON response if and
+       * only if `category` is equal to `card_refund`.
+       */
       export interface CardRefund {
         /**
          * The pending amount in the minor unit of the transaction's currency. For dollars,
@@ -524,17 +565,48 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
          */
         amount: number;
 
-        /**
-         * The identifier for the Transaction this refunds, if any.
-         */
-        card_settlement_transaction_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 Card Refund identifier.
+         */
+        id: string;
+
+        /**
+         * The merchant identifier (commonly abbreviated as MID) of the merchant the card
+         * is transacting with.
+         */
+        merchant_acceptor_id: string | null;
+
+        /**
+         * The 4-digit MCC describing the merchant's business.
+         */
+        merchant_category_code: string;
+
+        /**
+         * The city the merchant resides in.
+         */
+        merchant_city: string | null;
+
+        /**
+         * The country the merchant resides in.
+         */
+        merchant_country: string;
+
+        /**
+         * The name of the merchant.
+         */
+        merchant_name: string | null;
+
+        /**
+         * The state the merchant resides in.
+         */
+        merchant_state: string | null;
+
         /**
          * A constant representing the object's type. For this resource it will always be
          * `card_refund`.
@@ -542,6 +614,10 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         type: 'card_refund';
       }
 
+      /**
+       * A Card Settlement object. This field will be present in the JSON response if and
+       * only if `category` is equal to `card_settlement`.
+       */
       export interface CardSettlement {
         /**
          * The amount in the minor unit of the transaction's settlement currency. For
@@ -549,20 +625,52 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
          */
         amount: number;
 
+        /**
+         * The Card Authorization that was created prior to this Card Settlement, if on
+         * exists.
+         */
+        card_authorization: string | null;
+
         /**
          * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the
          * transaction's settlement currency.
          */
         currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
 
+        /**
+         * The Card Settlement identifier.
+         */
+        id: string;
+
+        /**
+         * The merchant identifier (commonly abbreviated as MID) of the merchant the card
+         * is transacting with.
+         */
+        merchant_acceptor_id: string | null;
+
+        /**
+         * The 4-digit MCC describing the merchant's business.
+         */
         merchant_category_code: string;
 
+        /**
+         * The city the merchant resides in.
+         */
         merchant_city: string | null;
 
+        /**
+         * The country the merchant resides in.
+         */
         merchant_country: string;
 
+        /**
+         * The name of the merchant.
+         */
         merchant_name: string | null;
 
+        /**
+         * The state the merchant resides in.
+         */
         merchant_state: string | null;
 
         /**
@@ -588,6 +696,43 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         type: 'card_settlement';
       }
 
+      /**
+       * A Card Revenue Payment object. This field will be present in the JSON response
+       * if and only if `category` is equal to `card_revenue_payment`.
+       */
+      export interface CardRevenuePayment {
+        /**
+         * The 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
+         * currency.
+         */
+        currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
+
+        /**
+         * The end of the period for which this transaction paid interest.
+         */
+        period_end: string;
+
+        /**
+         * The start of the period for which this transaction paid interest.
+         */
+        period_start: string;
+
+        /**
+         * The account the card belonged to.
+         */
+        transacted_on_account_id: string | null;
+      }
+
+      /**
+       * A Check Deposit Acceptance object. This field will be present in the JSON
+       * response if and only if `category` is equal to `check_deposit_acceptance`.
+       */
       export interface CheckDepositAcceptance {
         /**
          * The account number printed on the check.
@@ -629,6 +774,10 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         serial_number: string | null;
       }
 
+      /**
+       * A Check Deposit Return object. This field will be present in the JSON response
+       * if and only if `category` is equal to `check_deposit_return`.
+       */
       export interface CheckDepositReturn {
         /**
          * The amount in the minor unit of the transaction's currency. For dollars, for
@@ -658,7 +807,8 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
           | 'stop_payment'
           | 'unknown_reason'
           | 'unmatched_details'
-          | 'unreadable_image';
+          | 'unreadable_image'
+          | 'endorsement_irregular';
 
         /**
          * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
@@ -673,6 +823,10 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         transaction_id: string;
       }
 
+      /**
+       * A Check Transfer Intention object. This field will be present in the JSON
+       * response if and only if `category` is equal to `check_transfer_intention`.
+       */
       export interface CheckTransferIntention {
         /**
          * The city of the check's destination.
@@ -721,18 +875,43 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         transfer_id: string;
       }
 
+      /**
+       * A Check Transfer Return object. This field will be present in the JSON response
+       * if and only if `category` is equal to `check_transfer_return`.
+       */
       export interface CheckTransferReturn {
         /**
          * If available, a document with additional information about the return.
          */
         file_id: string | null;
 
+        /**
+         * The reason why the check was returned.
+         */
+        reason: 'mail_delivery_failure' | 'refused_by_recipient' | 'returned_not_authorized';
+
+        /**
+         * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
+         * the check was returned.
+         */
+        returned_at: string;
+
+        /**
+         * The identifier of the Transaction that was created to credit you for the
+         * returned check.
+         */
+        transaction_id: string | null;
+
         /**
          * The identifier of the returned Check Transfer.
          */
         transfer_id: string;
       }
 
+      /**
+       * A Check Transfer Rejection object. This field will be present in the JSON
+       * response if and only if `category` is equal to `check_transfer_rejection`.
+       */
       export interface CheckTransferRejection {
         /**
          * The identifier of the Check Transfer that led to this Transaction.
@@ -740,6 +919,11 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         transfer_id: string;
       }
 
+      /**
+       * A Check Transfer Stop Payment Request object. This field will be present in the
+       * JSON response if and only if `category` is equal to
+       * `check_transfer_stop_payment_request`.
+       */
       export interface CheckTransferStopPaymentRequest {
         /**
          * The time the stop-payment was requested.
@@ -763,7 +947,11 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         type: 'check_transfer_stop_payment_request';
       }
 
-      export interface DisputeResolution {
+      /**
+       * A Fee Payment object. This field will be present in the JSON response if and
+       * only if `category` is equal to `fee_payment`.
+       */
+      export interface FeePayment {
         /**
          * The amount in the minor unit of the transaction's currency. For dollars, for
          * example, this is cents.
@@ -771,29 +959,16 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         amount: number;
 
         /**
-         * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the
-         * transaction's currency.
+         * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transaction
+         * currency.
          */
         currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
-
-        /**
-         * The identifier of the Transaction that was disputed.
-         */
-        disputed_transaction_id: string;
-      }
-
-      export interface EmpyrealCashDeposit {
-        /**
-         * The amount in the minor unit of the transaction's currency. For dollars, for
-         * example, this is cents.
-         */
-        amount: number;
-
-        bag_id: string;
-
-        deposit_date: string;
       }
 
+      /**
+       * A Inbound ACH Transfer object. This field will be present in the JSON response
+       * if and only if `category` is equal to `inbound_ach_transfer`.
+       */
       export interface InboundACHTransfer {
         /**
          * The amount in the minor unit of the destination account currency. For dollars,
@@ -818,6 +993,10 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         trace_number: string;
       }
 
+      /**
+       * A Inbound Check object. This field will be present in the JSON response if and
+       * only if `category` is equal to `inbound_check`.
+       */
       export interface InboundCheck {
         /**
          * The amount in the minor unit of the destination account currency. For dollars,
@@ -838,6 +1017,11 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
       }
 
+      /**
+       * A Inbound International ACH Transfer object. This field will be present in the
+       * JSON response if and only if `category` is equal to
+       * `inbound_international_ach_transfer`.
+       */
       export interface InboundInternationalACHTransfer {
         /**
          * The amount in the minor unit of the destination account currency. For dollars,
@@ -916,6 +1100,11 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         trace_number: string;
       }
 
+      /**
+       * A Inbound Real Time Payments Transfer Confirmation object. This field will be
+       * present in the JSON response if and only if `category` is equal to
+       * `inbound_real_time_payments_transfer_confirmation`.
+       */
       export interface InboundRealTimePaymentsTransferConfirmation {
         /**
          * The amount in the minor unit of the transfer's currency. For dollars, for
@@ -960,6 +1149,11 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         transaction_identification: string;
       }
 
+      /**
+       * A Inbound Wire Drawdown Payment Reversal object. This field will be present in
+       * the JSON response if and only if `category` is equal to
+       * `inbound_wire_drawdown_payment_reversal`.
+       */
       export interface InboundWireDrawdownPaymentReversal {
         /**
          * The amount that was reversed.
@@ -1012,6 +1206,10 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         previous_message_input_source: string;
       }
 
+      /**
+       * A Inbound Wire Drawdown Payment object. This field will be present in the JSON
+       * response if and only if `category` is equal to `inbound_wire_drawdown_payment`.
+       */
       export interface InboundWireDrawdownPayment {
         /**
          * The amount in the minor unit of the transaction's currency. For dollars, for
@@ -1044,12 +1242,22 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         originator_to_beneficiary_information: string | null;
       }
 
+      /**
+       * A Inbound Wire Reversal object. This field will be present in the JSON response
+       * if and only if `category` is equal to `inbound_wire_reversal`.
+       */
       export interface InboundWireReversal {
         /**
          * The amount that was reversed.
          */
         amount: number;
 
+        /**
+         * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
+         * the reversal was created.
+         */
+        created_at: string;
+
         /**
          * The description on the reversal message from Fedwire.
          */
@@ -1105,8 +1313,22 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
          * institution.
          */
         receiver_financial_institution_information: string | null;
+
+        /**
+         * The ID for the Transaction associated with the transfer reversal.
+         */
+        transaction_id: string | null;
+
+        /**
+         * The ID for the Wire Transfer that is being reversed.
+         */
+        wire_transfer_id: string;
       }
 
+      /**
+       * A Inbound Wire Transfer object. This field will be present in the JSON response
+       * if and only if `category` is equal to `inbound_wire_transfer`.
+       */
       export interface InboundWireTransfer {
         /**
          * The amount in the minor unit of the transaction's currency. For dollars, for
@@ -1147,6 +1369,10 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         originator_to_beneficiary_information_line4: string | null;
       }
 
+      /**
+       * A Interest Payment object. This field will be present in the JSON response if
+       * and only if `category` is equal to `interest_payment`.
+       */
       export interface InterestPayment {
         /**
          * The account on which the interest was accrued.
@@ -1176,6 +1402,10 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         period_start: string;
       }
 
+      /**
+       * A Internal Source object. This field will be present in the JSON response if and
+       * only if `category` is equal to `internal_source`.
+       */
       export interface InternalSource {
         /**
          * The amount in the minor unit of the transaction's currency. For dollars, for
@@ -1190,69 +1420,56 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
 
         reason:
+          | 'account_closure'
           | 'bank_migration'
           | 'cashback'
+          | 'collection_receivable'
           | 'empyreal_adjustment'
           | 'error'
           | 'error_correction'
           | 'fees'
           | 'interest'
+          | 'negative_balance_forgiveness'
           | 'sample_funds'
           | 'sample_funds_return';
       }
 
-      export interface CardRouteRefund {
+      /**
+       * A Real Time Payments Transfer Acknowledgement object. This field will be present
+       * in the JSON response if and only if `category` is equal to
+       * `real_time_payments_transfer_acknowledgement`.
+       */
+      export interface RealTimePaymentsTransferAcknowledgement {
         /**
-         * The refunded amount in the minor unit of the refunded currency. For dollars, for
-         * example, this is cents.
+         * The transfer amount in USD cents.
          */
         amount: number;
 
         /**
-         * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the refund
-         * currency.
+         * The destination account number.
          */
-        currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
-
-        merchant_acceptor_id: string;
-
-        merchant_category_code: string | null;
-
-        merchant_city: string | null;
+        destination_account_number: string;
 
-        merchant_country: string;
-
-        merchant_descriptor: string;
-
-        merchant_state: string | null;
-      }
-
-      export interface CardRouteSettlement {
         /**
-         * The settled amount in the minor unit of the settlement currency. For dollars,
-         * for example, this is cents.
+         * The American Bankers' Association (ABA) Routing Transit Number (RTN).
          */
-        amount: number;
+        destination_routing_number: string;
 
         /**
-         * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the settlement
-         * currency.
+         * Unstructured information that will show on the recipient's bank statement.
          */
-        currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
-
-        merchant_acceptor_id: string;
+        remittance_information: string;
 
-        merchant_category_code: string | null;
-
-        merchant_city: string | null;
-
-        merchant_country: string | null;
-
-        merchant_descriptor: string;
-
-        merchant_state: string | null;
+        /**
+         * The identifier of the Real Time Payments Transfer that led to this Transaction.
+         */
+        transfer_id: string;
       }
 
+      /**
+       * A Sample Funds object. This field will be present in the JSON response if and
+       * only if `category` is equal to `sample_funds`.
+       */
       export interface SampleFunds {
         /**
          * Where the sample funds came from.
@@ -1260,25 +1477,10 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         originator: string;
       }
 
-      export interface WireDrawdownPaymentIntention {
-        account_number: string;
-
-        /**
-         * The transfer amount in USD cents.
-         */
-        amount: number;
-
-        message_to_recipient: string;
-
-        routing_number: string;
-
-        transfer_id: string;
-      }
-
-      export interface WireDrawdownPaymentRejection {
-        transfer_id: string;
-      }
-
+      /**
+       * A Wire Transfer Intention object. This field will be present in the JSON
+       * response if and only if `category` is equal to `wire_transfer_intention`.
+       */
       export interface WireTransferIntention {
         /**
          * The destination account number.
@@ -1303,12 +1505,22 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         transfer_id: string;
       }
 
+      /**
+       * A Wire Transfer Rejection object. This field will be present in the JSON
+       * response if and only if `category` is equal to `wire_transfer_rejection`.
+       */
       export interface WireTransferRejection {
         transfer_id: string;
       }
     }
   }
 
+  /**
+   * If the Real Time Payments Transfer attempt fails, this will contain the
+   * resulting [Declined Transaction](#declined-transactions) object. The Declined
+   * Transaction's `source` will be of
+   * `category: inbound_real_time_payments_transfer_decline`.
+   */
   export interface DeclinedTransaction {
     /**
      * The identifier for the Account the Declined Transaction belongs to.
@@ -1353,7 +1565,7 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
     /**
      * The type of the route this Declined Transaction came through.
      */
-    route_type: string | null;
+    route_type: 'account_number' | 'card' | null;
 
     /**
      * This is an object giving more details on the network-level event that caused the
@@ -1372,6 +1584,13 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
   }
 
   export namespace DeclinedTransaction {
+    /**
+     * 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.
+     */
     export interface Source {
       /**
        * A ACH Decline object. This field will be present in the JSON response if and
@@ -1385,12 +1604,6 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
        */
       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
@@ -1402,7 +1615,7 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         | 'check_decline'
         | 'inbound_real_time_payments_transfer_decline'
         | 'international_ach_decline'
-        | 'card_route_decline'
+        | 'wire_decline'
         | 'other';
 
       /**
@@ -1423,9 +1636,19 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
        * response if and only if `category` is equal to `international_ach_decline`.
        */
       international_ach_decline: Source.InternationalACHDecline | null;
+
+      /**
+       * A Wire Decline object. This field will be present in the JSON response if and
+       * only if `category` is equal to `wire_decline`.
+       */
+      wire_decline: Source.WireDecline | null;
     }
 
     export namespace Source {
+      /**
+       * A ACH Decline object. This field will be present in the JSON response if and
+       * only if `category` is equal to `ach_decline`.
+       */
       export interface ACHDecline {
         /**
          * The declined amount in the minor unit of the destination account currency. For
@@ -1451,11 +1674,12 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
           | 'credit_entry_refused_by_receiver'
           | 'duplicate_return'
           | 'entity_not_active'
-          | 'transaction_not_allowed'
           | 'group_locked'
           | 'insufficient_funds'
+          | 'misrouted_return'
           | 'no_ach_route'
-          | 'originator_request';
+          | 'originator_request'
+          | 'transaction_not_allowed';
 
         receiver_id_number: string | null;
 
@@ -1464,6 +1688,10 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         trace_number: string;
       }
 
+      /**
+       * A Card Decline object. This field will be present in the JSON response if and
+       * only if `category` is equal to `card_decline`.
+       */
       export interface CardDecline {
         /**
          * The declined amount in the minor unit of the destination account currency. For
@@ -1541,13 +1769,19 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
           | 'insufficient_funds'
           | 'cvv2_mismatch'
           | 'transaction_not_allowed'
+          | 'breaches_internal_limit'
           | 'breaches_limit'
           | 'webhook_declined'
           | 'webhook_timed_out'
-          | 'declined_by_stand_in_processing';
+          | 'declined_by_stand_in_processing'
+          | 'invalid_physical_card'
+          | 'missing_original_authorization';
       }
 
       export namespace CardDecline {
+        /**
+         * Fields specific to the `network`
+         */
         export interface NetworkDetails {
           /**
            * Fields specific to the `visa` network
@@ -1556,6 +1790,9 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         }
 
         export namespace NetworkDetails {
+          /**
+           * Fields specific to the `visa` network
+           */
           export interface Visa {
             /**
              * For electronic commerce transactions, this identifies the level of security used
@@ -1577,11 +1814,15 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
              * The method used to enter the cardholder's primary account number and card
              * expiration date
              */
-            point_of_service_entry_mode: Shared.PointOfServiceEntryMode;
+            point_of_service_entry_mode: Shared.PointOfServiceEntryMode | null;
           }
         }
       }
 
+      /**
+       * A Check Decline object. This field will be present in the JSON response if and
+       * only if `category` is equal to `check_decline`.
+       */
       export interface CheckDecline {
         /**
          * The declined amount in the minor unit of the destination account currency. For
@@ -1602,12 +1843,21 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
           | 'group_locked'
           | 'insufficient_funds'
           | 'unable_to_locate_account'
+          | 'not_our_item'
           | 'unable_to_process'
           | 'refer_to_image'
           | 'stop_payment_requested'
-          | 'returned';
+          | 'returned'
+          | 'duplicate_presentment'
+          | 'not_authorized'
+          | 'altered_or_fictitious';
       }
 
+      /**
+       * 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`.
+       */
       export interface InboundRealTimePaymentsTransferDecline {
         /**
          * The declined amount in the minor unit of the destination account currency. For
@@ -1648,6 +1898,7 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         reason:
           | 'account_number_canceled'
           | 'account_number_disabled'
+          | 'account_restricted'
           | 'group_locked'
           | 'entity_not_active'
           | 'real_time_payments_not_enabled';
@@ -1663,6 +1914,10 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         transaction_identification: string;
       }
 
+      /**
+       * 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`.
+       */
       export interface InternationalACHDecline {
         /**
          * The declined amount in the minor unit of the destination account currency. For
@@ -1741,35 +1996,102 @@ export namespace InboundRealTimePaymentsTransferSimulationResult {
         trace_number: string;
       }
 
-      export interface CardRouteDecline {
+      /**
+       * A Wire Decline object. This field will be present in the JSON response if and
+       * only if `category` is equal to `wire_decline`.
+       */
+      export interface WireDecline {
         /**
          * 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';
+        beneficiary_address_line1: string | null;
 
-        merchant_acceptor_id: string;
+        beneficiary_address_line2: string | null;
 
-        merchant_category_code: string | null;
+        beneficiary_address_line3: string | null;
 
-        merchant_city: string | null;
+        beneficiary_name: string | null;
 
-        merchant_country: string;
+        beneficiary_reference: string | null;
 
-        merchant_descriptor: string;
+        description: string;
 
-        merchant_state: string | null;
+        input_message_accountability_data: string | null;
+
+        originator_address_line1: string | null;
+
+        originator_address_line2: string | null;
+
+        originator_address_line3: string | null;
+
+        originator_name: string | null;
+
+        originator_to_beneficiary_information_line1: string | null;
+
+        originator_to_beneficiary_information_line2: string | null;
+
+        originator_to_beneficiary_information_line3: string | null;
+
+        originator_to_beneficiary_information_line4: string | null;
+
+        /**
+         * Why the wire transfer was declined.
+         */
+        reason:
+          | 'account_number_canceled'
+          | 'account_number_disabled'
+          | 'entity_not_active'
+          | 'group_locked'
+          | 'no_account_number'
+          | 'transaction_not_allowed';
       }
     }
   }
 }
 
+export interface RealTimePaymentsTransferCompleteParams {
+  /**
+   * If set, the simulation will reject the transfer.
+   */
+  rejection?: RealTimePaymentsTransferCompleteParams.Rejection;
+}
+
+export namespace RealTimePaymentsTransferCompleteParams {
+  /**
+   * If set, the simulation will reject the transfer.
+   */
+  export interface Rejection {
+    /**
+     * The reason code that the simulated rejection will have.
+     */
+    reject_reason_code:
+      | 'account_closed'
+      | 'account_blocked'
+      | 'invalid_creditor_account_type'
+      | 'invalid_creditor_account_number'
+      | 'invalid_creditor_financial_institution_identifier'
+      | 'end_customer_deceased'
+      | 'narrative'
+      | 'transaction_forbidden'
+      | 'transaction_type_not_supported'
+      | 'unexpected_amount'
+      | 'amount_exceeds_bank_limits'
+      | 'invalid_creditor_address'
+      | 'unknown_end_customer'
+      | 'invalid_debtor_address'
+      | 'timeout'
+      | 'unsupported_message_for_recipient'
+      | 'recipient_connection_not_available'
+      | 'real_time_payments_suspended'
+      | 'instructed_agent_signed_off'
+      | 'processing_error'
+      | 'other';
+  }
+}
+
 export interface RealTimePaymentsTransferCreateInboundParams {
   /**
    * The identifier of the Account Number the inbound Real Time Payments Transfer is