Class: ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID

Inherits:

Internal::Type::BaseModel

• Object
• Internal::Type::BaseModel
• ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID

Defined in:

lib/modern_treasury/models/bulk_request_create_params.rb,
sig/modern_treasury/models/bulk_request_create_params.rbs

Defined Under Namespace

Modules: ChargeBearer, Direction, FallbackType, ForeignExchangeIndicator, Priority, ReconciliationStatus, Status Classes: Accounting, LineItem, ReceivingAccount

Instance Attribute Summary

• #accounting ⇒ ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::Accounting^? deprecated Deprecated.
• #accounting_category_id ⇒ String^? deprecated Deprecated.
• #accounting_ledger_class_id ⇒ String^? deprecated Deprecated.
• #amount ⇒ Integer^?

  Value in specified currency's smallest unit.

• #charge_bearer ⇒ Symbol, ...

  The party that will pay the fees for the payment order.

• #counterparty_id ⇒ String^?

  Required when receiving_account_id is passed the ID of an external account.

• #currency ⇒ Symbol, ...

  Defaults to the currency of the originating account.

• #description ⇒ String^?

  An optional description for internal use.

• #direction ⇒ Symbol, ...

  One of credit, debit.

• #effective_date ⇒ Date^?

  Date transactions are to be posted to the participants' account.

• #expires_at ⇒ Time^?

  RFP payments require an expires_at.

• #external_id ⇒ String^?

  An optional user-defined 180 character unique identifier.

• #fallback_type ⇒ Symbol, ...

  A payment type to fallback to if the original type is not valid for the receiving account.

• #foreign_exchange_contract ⇒ String^?

  If present, indicates a specific foreign exchange contract number that has been generated by your financial institution.

• #foreign_exchange_indicator ⇒ Symbol, ...

  Indicates the type of FX transfer to initiate, can be either variable_to_fixed, fixed_to_variable, or null if the payment order currency matches the originating account currency.

• #id ⇒ String^?
• #line_items ⇒ Array<ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::LineItem>^?

  An array of line items that must sum up to the amount of the payment order.

• #metadata ⇒ Hash{Symbol=>String}^?

  Additional data represented as key-value pairs.

• #nsf_protected ⇒ Boolean^?

  A boolean to determine if NSF Protection is enabled for this payment order.

• #originating_account_id ⇒ String^?

  The ID of one of your organization's internal accounts.

• #originating_party_name ⇒ String^?

  If present, this will replace your default company name on receiver's bank statement.

• #priority ⇒ Symbol, ...

  Either normal or high.

• #process_after ⇒ Time^?

  If present, Modern Treasury will not process the payment until after this time.

• #purpose ⇒ String^?

  For wire, this is usually the purpose which is transmitted via the "InstrForDbtrAgt" field in the ISO20022 file.

• #receiving_account ⇒ ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::ReceivingAccount^?

  Either receiving_account or receiving_account_id must be present.

• #receiving_account_id ⇒ String^?

  Either receiving_account or receiving_account_id must be present.

• #reconciliation_status ⇒ Symbol, ...

  One of unreconciled, tentatively_reconciled or reconciled.

• #remittance_information ⇒ String^?

  For ach, this field will be passed through on an addenda record.

• #send_remittance_advice ⇒ Boolean^?

  Send an email to the counterparty when the payment order is sent to the bank.

• #statement_descriptor ⇒ String^?

  An optional descriptor which will appear in the receiver's statement.

• #status ⇒ Symbol, ...

  To cancel a payment order, use cancelled.

• #subtype ⇒ Symbol, ...

  An additional layer of classification for the type of payment order you are doing.

• #type ⇒ Symbol, ...

  One of ach, se_bankgirot, eft, wire, check, book, rtp, sepa, bacs, au_becs, neft, nics, nz_national_clearing_code, sic, zengin.

• #ultimate_originating_party_identifier ⇒ String^?

  This represents the identifier by which the person is known to the receiver when using the CIE subtype for ACH payments.

• #ultimate_originating_party_name ⇒ String^?

  This represents the name of the person that the payment is on behalf of when using the CIE subtype for ACH payments.

• #ultimate_receiving_party_identifier ⇒ String^?

  This represents the name of the merchant that the payment is being sent to when using the CIE subtype for ACH payments.

• #ultimate_receiving_party_name ⇒ String^?

  This represents the identifier by which the merchant is known to the person initiating an ACH payment with CIE subtype.

Class Method Summary

• .values ⇒ Array<Symbol>

Instance Method Summary

• #initialize(amount:, accounting_category_id: nil, description: nil, metadata: nil) ⇒ Object constructor

  Some parameter documentations has been truncated, see LineItem for more details.

• #to_hash ⇒ {

Methods inherited from Internal::Type::BaseModel

==, #==, #[], coerce, #deconstruct_keys, #deep_to_h, dump, fields, hash, #hash, inherited, inspect, #inspect, known_fields, optional, recursively_to_h, required, #to_h, #to_json, #to_s, to_sorbet_type, #to_yaml

Methods included from Internal::Type::Converter

#coerce, coerce, #dump, dump, #inspect, inspect, meta_info, new_coerce_state, type_info

Methods included from Internal::Util::SorbetRuntimeSupport

#const_missing, #define_sorbet_constant!, #sorbet_constant_defined?, #to_sorbet_type, to_sorbet_type

Constructor Details

#initialize(amount:, accounting_category_id: nil, description: nil, metadata: nil) ⇒ Object

Some parameter documentations has been truncated, see LineItem for more details.

Parameters:

• amount (Integer) —

  Value in specified currency's smallest unit. e.g. $10 would be represented as 10

• accounting_category_id (String, nil) (defaults to: nil) —

  The ID of one of your accounting categories. Note that these will only be access

• description (String, nil) (defaults to: nil) —

  A free-form description of the line item.

• metadata (Hash{Symbol=>String}) (defaults to: nil) —

  Additional data represented as key-value pairs. Both the key and value must be s

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1788

Instance Attribute Details

#accounting ⇒ ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::Accounting^?

Deprecated.

Returns:

• (ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::Accounting, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1502

optional :accounting,
-> { ModernTreasury::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::Accounting }

#accounting_category_id ⇒ String^?

Deprecated.

The ID of one of your accounting categories. Note that these will only be accessible if your accounting system has been connected.

Parameters:

• value (String, nil)

Returns:

• (String, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1512

optional :accounting_category_id, String, nil?: true

#accounting_ledger_class_id ⇒ String^?

Deprecated.

The ID of one of your accounting ledger classes. Note that these will only be accessible if your accounting system has been connected.

Parameters:

• value (String, nil)

Returns:

• (String, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1521

optional :accounting_ledger_class_id, String, nil?: true

#amount ⇒ Integer^?

Value in specified currency's smallest unit. e.g. $10 would be represented as 1000 (cents). For RTP, the maximum amount allowed by the network is $10,000,000.

Parameters:

• (Integer)

Returns:

• (Integer, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1528

optional :amount, Integer

#charge_bearer ⇒ Symbol, ...

The party that will pay the fees for the payment order. See https://docs.moderntreasury.com/payments/docs/charge-bearer to understand the differences between the options.

Parameters:

• value (ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::charge_bearer, nil)

Returns:

• (Symbol, ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::ChargeBearer, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1536

optional :charge_bearer,
enum: -> {
  ModernTreasury::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::ChargeBearer
},
nil?: true

#counterparty_id ⇒ String^?

Required when receiving_account_id is passed the ID of an external account.

Parameters:

• value (String, nil)

Returns:

• (String, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1546

optional :counterparty_id, String, nil?: true

#currency ⇒ Symbol, ...

Defaults to the currency of the originating account.

Returns:

• (Symbol, ModernTreasury::Models::Currency, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1552

optional :currency, enum: -> { ModernTreasury::Currency }

#description ⇒ String^?

An optional description for internal use.

Parameters:

• value (String, nil)

Returns:

• (String, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1558

optional :description, String, nil?: true

#direction ⇒ Symbol, ...

One of credit, debit. Describes the direction money is flowing in the transaction. A credit moves money from your account to someone else's. A debit pulls money from someone else's account to your own. Note that wire, rtp, and check payments will always be credit.

Returns:

• (Symbol, ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::Direction, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1567

optional :direction,
enum: -> { ModernTreasury::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::Direction }

#effective_date ⇒ Date^?

Date transactions are to be posted to the participants' account. Defaults to the current business day or the next business day if the current day is a bank holiday or weekend. Format: yyyy-mm-dd.

Parameters:

• (Date)

Returns:

• (Date, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1576

optional :effective_date, Date

#expires_at ⇒ Time^?

RFP payments require an expires_at. This value must be past the effective_date.

Parameters:

• value (Time, nil)

Returns:

• (Time, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1582

optional :expires_at, Time, nil?: true

#external_id ⇒ String^?

An optional user-defined 180 character unique identifier.

Parameters:

• value (String, nil)

Returns:

• (String, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1588

optional :external_id, String, nil?: true

#fallback_type ⇒ Symbol, ...

A payment type to fallback to if the original type is not valid for the receiving account. Currently, this only supports falling back from RTP to ACH (type=rtp and fallback_type=ach)

Returns:

• (Symbol, ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::FallbackType, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1596

optional :fallback_type,
enum: -> { ModernTreasury::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::FallbackType }

#foreign_exchange_contract ⇒ String^?

If present, indicates a specific foreign exchange contract number that has been generated by your financial institution.

Parameters:

• value (String, nil)

Returns:

• (String, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1604

optional :foreign_exchange_contract, String, nil?: true

#foreign_exchange_indicator ⇒ Symbol, ...

Indicates the type of FX transfer to initiate, can be either variable_to_fixed, fixed_to_variable, or null if the payment order currency matches the originating account currency.

Parameters:

• value (ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::foreign_exchange_indicator, nil)

Returns:

• (Symbol, ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::ForeignExchangeIndicator, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1612

optional :foreign_exchange_indicator,
enum: -> {
  ModernTreasury::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::ForeignExchangeIndicator
},
nil?: true

#id ⇒ String^?

Parameters:

• (String)

Returns:

• (String, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1496

optional :id, String

#line_items ⇒ Array<ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::LineItem>^?

An array of line items that must sum up to the amount of the payment order.

Returns:

• (Array<ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::LineItem>, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1622

optional :line_items,
-> { ModernTreasury::Internal::Type::ArrayOf[ModernTreasury::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::LineItem] }

#metadata ⇒ Hash{Symbol=>String}^?

Additional data represented as key-value pairs. Both the key and value must be strings.

Parameters:

• (::Hash[Symbol, String])

Returns:

• (Hash{Symbol=>String}, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1630

optional :metadata, ModernTreasury::Internal::Type::HashOf[String]

#nsf_protected ⇒ Boolean^?

A boolean to determine if NSF Protection is enabled for this payment order. Note that this setting must also be turned on in your organization settings page.

Parameters:

• (Boolean)

Returns:

• (Boolean, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1637

optional :nsf_protected, ModernTreasury::Internal::Type::Boolean

#originating_account_id ⇒ String^?

The ID of one of your organization's internal accounts.

Parameters:

• (String)

Returns:

• (String, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1643

optional :originating_account_id, String

#originating_party_name ⇒ String^?

If present, this will replace your default company name on receiver's bank statement. This field can only be used for ACH payments currently. For ACH, only the first 16 characters of this string will be used. Any additional characters will be truncated.

Parameters:

• value (String, nil)

Returns:

• (String, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1652

optional :originating_party_name, String, nil?: true

#priority ⇒ Symbol, ...

Either normal or high. For ACH and EFT payments, high represents a same-day ACH or EFT transfer, respectively. For check payments, high can mean an overnight check rather than standard mail.

Returns:

• (Symbol, ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::Priority, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1660

optional :priority,
enum: -> { ModernTreasury::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::Priority }

#process_after ⇒ Time^?

If present, Modern Treasury will not process the payment until after this time. If process_after is past the cutoff for effective_date, process_after will take precedence and effective_date will automatically update to reflect the earliest possible sending date after process_after. Format is ISO8601 timestamp.

Parameters:

• value (Time, nil)

Returns:

• (Time, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1671

optional :process_after, Time, nil?: true

#purpose ⇒ String^?

For wire, this is usually the purpose which is transmitted via the "InstrForDbtrAgt" field in the ISO20022 file. For eft, this field is the 3 digit CPA Code that will be attached to the payment.

Parameters:

• value (String, nil)

Returns:

• (String, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1679

optional :purpose, String, nil?: true

#receiving_account ⇒ ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::ReceivingAccount^?

Either receiving_account or receiving_account_id must be present. When using receiving_account_id, you may pass the id of an external account or an internal account.

Returns:

• (ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::ReceivingAccount, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1687

optional :receiving_account,
-> { ModernTreasury::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::ReceivingAccount }

#receiving_account_id ⇒ String^?

Either receiving_account or receiving_account_id must be present. When using receiving_account_id, you may pass the id of an external account or an internal account.

Parameters:

• (String)

Returns:

• (String, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1696

optional :receiving_account_id, String

#reconciliation_status ⇒ Symbol, ...

One of unreconciled, tentatively_reconciled or reconciled.

Returns:

• (Symbol, ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::ReconciliationStatus, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1702

optional :reconciliation_status,
enum: -> { ModernTreasury::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::ReconciliationStatus }

#remittance_information ⇒ String^?

For ach, this field will be passed through on an addenda record. For wire payments the field will be passed through as the "Originator to Beneficiary Information", also known as OBI or Fedwire tag 6000.

Parameters:

• value (String, nil)

Returns:

• (String, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1711

optional :remittance_information, String, nil?: true

#send_remittance_advice ⇒ Boolean^?

Send an email to the counterparty when the payment order is sent to the bank. If null, send_remittance_advice on the Counterparty is used.

Parameters:

• value (Boolean, nil)

Returns:

• (Boolean, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1718

optional :send_remittance_advice, ModernTreasury::Internal::Type::Boolean, nil?: true

#statement_descriptor ⇒ String^?

An optional descriptor which will appear in the receiver's statement. For check payments this field will be used as the memo line. For ach the maximum length is 10 characters. Note that for ACH payments, the name on your bank account will be included automatically by the bank, so you can use the characters for other useful information. For eft the maximum length is 15 characters.

Parameters:

• value (String, nil)

Returns:

• (String, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1729

optional :statement_descriptor, String, nil?: true

#status ⇒ Symbol, ...

To cancel a payment order, use cancelled. To redraft a returned payment order, use approved. To undo approval on a denied or approved payment order, use needs_approval.

Returns:

• (Symbol, ModernTreasury::Models::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::Status, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1737

optional :status,
enum: -> { ModernTreasury::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::Status }

#subtype ⇒ Symbol, ...

An additional layer of classification for the type of payment order you are doing. This field is only used for ach payment orders currently. For ach payment orders, the subtype represents the SEC code. We currently support CCD, PPD, IAT, CTX, WEB, CIE, and TEL.

Parameters:

• value (ModernTreasury::Models::payment_order_subtype, nil)

Returns:

• (Symbol, ModernTreasury::Models::PaymentOrderSubtype, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1747

optional :subtype, enum: -> { ModernTreasury::PaymentOrderSubtype }, nil?: true

#type ⇒ Symbol, ...

One of ach, se_bankgirot, eft, wire, check, book, rtp, sepa, bacs, au_becs, neft, nics, nz_national_clearing_code, sic, zengin.

Returns:

• (Symbol, ModernTreasury::Models::PaymentOrderType, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1754

optional :type, enum: -> { ModernTreasury::PaymentOrderType }

#ultimate_originating_party_identifier ⇒ String^?

This represents the identifier by which the person is known to the receiver when using the CIE subtype for ACH payments. Only the first 22 characters of this string will be used. Any additional characters will be truncated.

Parameters:

• value (String, nil)

Returns:

• (String, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1762

optional :ultimate_originating_party_identifier, String, nil?: true

#ultimate_originating_party_name ⇒ String^?

This represents the name of the person that the payment is on behalf of when using the CIE subtype for ACH payments. Only the first 15 characters of this string will be used. Any additional characters will be truncated.

Parameters:

• value (String, nil)

Returns:

• (String, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1770

optional :ultimate_originating_party_name, String, nil?: true

#ultimate_receiving_party_identifier ⇒ String^?

This represents the name of the merchant that the payment is being sent to when using the CIE subtype for ACH payments. Only the first 22 characters of this string will be used. Any additional characters will be truncated.

Parameters:

• value (String, nil)

Returns:

• (String, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1778

optional :ultimate_receiving_party_identifier, String, nil?: true

#ultimate_receiving_party_name ⇒ String^?

This represents the identifier by which the merchant is known to the person initiating an ACH payment with CIE subtype. Only the first 15 characters of this string will be used. Any additional characters will be truncated.

Parameters:

• value (String, nil)

Returns:

• (String, nil)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1786

optional :ultimate_receiving_party_name, String, nil?: true

Class Method Details

.values ⇒ Array<Symbol>

Returns:

• (Array<Symbol>)

# File 'lib/modern_treasury/models/bulk_request_create_params.rb', line 1912

Instance Method Details

#to_hash ⇒ {

Returns:

• ({)

# File 'sig/modern_treasury/models/bulk_request_create_params.rbs', line 1420

def to_hash: -> {