increase 1.338.0 → 1.339.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (100) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +1 -1
  3. data/lib/increase/models/account_create_params.rb +4 -3
  4. data/lib/increase/models/ach_transfer.rb +19 -18
  5. data/lib/increase/models/ach_transfer_create_params.rb +48 -36
  6. data/lib/increase/models/ach_transfer_list_params.rb +1 -1
  7. data/lib/increase/models/beneficial_owner_create_params.rb +2 -1
  8. data/lib/increase/models/beneficial_owner_update_params.rb +2 -1
  9. data/lib/increase/models/card_push_transfer.rb +3 -3
  10. data/lib/increase/models/card_push_transfer_list_params.rb +3 -3
  11. data/lib/increase/models/check_transfer.rb +5 -2
  12. data/lib/increase/models/entity_create_params.rb +16 -8
  13. data/lib/increase/models/entity_update_params.rb +2 -1
  14. data/lib/increase/models/fednow_transfer.rb +3 -3
  15. data/lib/increase/models/fednow_transfer_list_params.rb +3 -3
  16. data/lib/increase/models/inbound_mail_item.rb +3 -1
  17. data/lib/increase/models/inbound_real_time_payments_transfer.rb +1 -1
  18. data/lib/increase/models/lockbox_address.rb +5 -1
  19. data/lib/increase/models/lockbox_recipient_create_params.rb +3 -2
  20. data/lib/increase/models/pending_transaction.rb +5 -2
  21. data/lib/increase/models/pending_transaction_list_params.rb +1 -1
  22. data/lib/increase/models/physical_card.rb +5 -2
  23. data/lib/increase/models/real_time_payments_transfer.rb +3 -3
  24. data/lib/increase/models/real_time_payments_transfer_list_params.rb +3 -3
  25. data/lib/increase/models/simulations/inbound_ach_transfer_create_params.rb +3 -2
  26. data/lib/increase/models/simulations/inbound_mail_item_create_params.rb +6 -4
  27. data/lib/increase/models/simulations/physical_card_create_params.rb +5 -2
  28. data/lib/increase/models/swift_transfer.rb +3 -3
  29. data/lib/increase/models/swift_transfer_list_params.rb +3 -3
  30. data/lib/increase/models/transaction.rb +7 -4
  31. data/lib/increase/models/wire_transfer.rb +3 -3
  32. data/lib/increase/models/wire_transfer_list_params.rb +3 -3
  33. data/lib/increase/resources/accounts.rb +1 -1
  34. data/lib/increase/resources/ach_transfers.rb +10 -10
  35. data/lib/increase/resources/inbound_mail_items.rb +3 -1
  36. data/lib/increase/resources/lockbox_addresses.rb +4 -1
  37. data/lib/increase/resources/lockbox_recipients.rb +1 -1
  38. data/lib/increase/resources/simulations/card_authorizations.rb +4 -1
  39. data/lib/increase/resources/simulations/inbound_ach_transfers.rb +1 -1
  40. data/lib/increase/resources/simulations/inbound_mail_items.rb +6 -3
  41. data/lib/increase/version.rb +1 -1
  42. data/rbi/increase/models/account_create_params.rbi +6 -4
  43. data/rbi/increase/models/ach_transfer.rbi +22 -19
  44. data/rbi/increase/models/ach_transfer_create_params.rbi +67 -45
  45. data/rbi/increase/models/ach_transfer_list_params.rbi +1 -1
  46. data/rbi/increase/models/beneficial_owner_create_params.rbi +4 -2
  47. data/rbi/increase/models/beneficial_owner_update_params.rbi +4 -2
  48. data/rbi/increase/models/card_push_transfer.rbi +7 -7
  49. data/rbi/increase/models/card_push_transfer_list_params.rbi +7 -7
  50. data/rbi/increase/models/check_transfer.rbi +9 -2
  51. data/rbi/increase/models/entity_create_params.rbi +30 -15
  52. data/rbi/increase/models/entity_update_params.rbi +4 -2
  53. data/rbi/increase/models/fednow_transfer.rbi +7 -7
  54. data/rbi/increase/models/fednow_transfer_list_params.rbi +7 -7
  55. data/rbi/increase/models/inbound_mail_item.rbi +3 -1
  56. data/rbi/increase/models/inbound_real_time_payments_transfer.rbi +1 -1
  57. data/rbi/increase/models/lockbox_address.rbi +5 -1
  58. data/rbi/increase/models/lockbox_recipient_create_params.rbi +4 -2
  59. data/rbi/increase/models/pending_transaction.rbi +9 -3
  60. data/rbi/increase/models/pending_transaction_list_params.rbi +1 -1
  61. data/rbi/increase/models/physical_card.rbi +9 -2
  62. data/rbi/increase/models/real_time_payments_transfer.rbi +7 -7
  63. data/rbi/increase/models/real_time_payments_transfer_list_params.rbi +7 -7
  64. data/rbi/increase/models/simulations/inbound_ach_transfer_create_params.rbi +4 -2
  65. data/rbi/increase/models/simulations/inbound_mail_item_create_params.rbi +8 -4
  66. data/rbi/increase/models/simulations/physical_card_create_params.rbi +9 -2
  67. data/rbi/increase/models/swift_transfer.rbi +7 -7
  68. data/rbi/increase/models/swift_transfer_list_params.rbi +7 -7
  69. data/rbi/increase/models/transaction.rbi +10 -5
  70. data/rbi/increase/models/wire_transfer.rbi +4 -4
  71. data/rbi/increase/models/wire_transfer_list_params.rbi +7 -7
  72. data/rbi/increase/resources/accounts.rbi +3 -2
  73. data/rbi/increase/resources/ach_transfers.rbi +29 -19
  74. data/rbi/increase/resources/inbound_mail_items.rbi +3 -1
  75. data/rbi/increase/resources/lockbox_addresses.rbi +4 -1
  76. data/rbi/increase/resources/lockbox_recipients.rbi +2 -1
  77. data/rbi/increase/resources/simulations/card_authorizations.rbi +4 -1
  78. data/rbi/increase/resources/simulations/inbound_ach_transfers.rbi +2 -1
  79. data/rbi/increase/resources/simulations/inbound_mail_items.rbi +8 -3
  80. data/sig/increase/models/ach_transfer.rbs +2 -2
  81. data/sig/increase/models/ach_transfer_create_params.rbs +1 -1
  82. data/sig/increase/models/ach_transfer_list_params.rbs +1 -1
  83. data/sig/increase/models/card_push_transfer.rbs +4 -4
  84. data/sig/increase/models/card_push_transfer_list_params.rbs +4 -4
  85. data/sig/increase/models/check_transfer.rbs +6 -2
  86. data/sig/increase/models/fednow_transfer.rbs +5 -5
  87. data/sig/increase/models/fednow_transfer_list_params.rbs +5 -5
  88. data/sig/increase/models/inbound_real_time_payments_transfer.rbs +1 -1
  89. data/sig/increase/models/pending_transaction.rbs +1 -1
  90. data/sig/increase/models/pending_transaction_list_params.rbs +1 -1
  91. data/sig/increase/models/physical_card.rbs +6 -2
  92. data/sig/increase/models/real_time_payments_transfer.rbs +4 -4
  93. data/sig/increase/models/real_time_payments_transfer_list_params.rbs +4 -4
  94. data/sig/increase/models/simulations/physical_card_create_params.rbs +6 -2
  95. data/sig/increase/models/swift_transfer.rbs +4 -4
  96. data/sig/increase/models/swift_transfer_list_params.rbs +4 -4
  97. data/sig/increase/models/wire_transfer.rbs +4 -4
  98. data/sig/increase/models/wire_transfer_list_params.rbs +4 -4
  99. metadata +2 -3
  100. data/CHANGELOG.md +0 -4541
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: f2421d28be1ae99adb5ebd0f1d35ec9dc9bde67202bb9a603f87df09aceb1007
4
- data.tar.gz: 27edbc064aaac7181030d074f4afe519af357bb0b5b8345bc85529a780f6656f
3
+ metadata.gz: d066a5655d395f885866d82a947c1f4b2fc96fc340b95e78855ef7e62cde2c65
4
+ data.tar.gz: 5e37b231a1ff2b1bc4d470fcc28468258d29a65a98214caf53f48109631fb591
5
5
  SHA512:
6
- metadata.gz: 1a2ad5882a85fa5f919c3042f8b55a16a093fac9200d4c081f49797a43003dfc5a942548d558fa615a82c303a93d3293942ab392bb39490cd6deb27ad5468f64
7
- data.tar.gz: 304c56360d05c83059b3905d2883dfea6d0a41e90dc81023f54121e187ac09d11d3dab40926fc438c07341c5d41d3a606fa950ed4e38fa64ff57b8bb403f7b71
6
+ metadata.gz: 9f3fcdc88cf60376cf49522de5cbcd4ed9a56b350be6e02cb9ab145735b879a03d1ca9f629591d43a2c8be1e25c7174f72d7abc2994a949f19c5603be170738e
7
+ data.tar.gz: 84abe452d0dc86a40fe772bfe79c3aaf9a0eaf3375ee84c87ddb1e41972aeb89986d567276d5b981fb5f6f746431c738504c826dc3d8ed19f41bf602320ca8e1
data/README.md CHANGED
@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
15
15
  <!-- x-release-please-start-version -->
16
16
 
17
17
  ```ruby
18
- gem "increase", "~> 1.338.0"
18
+ gem "increase", "~> 1.339.0"
19
19
  ```
20
20
 
21
21
  <!-- x-release-please-end -->
@@ -39,8 +39,9 @@ module Increase
39
39
  optional :loan, -> { Increase::AccountCreateParams::Loan }
40
40
 
41
41
  # @!attribute program_id
42
- # The identifier for the Program that this Account falls under. Required if you
43
- # operate more than one Program.
42
+ # The identifier for the Program that this Account falls under. Required if your
43
+ # Group operates more than one Program. List your [Programs](#programs) to find
44
+ # their identifiers.
44
45
  #
45
46
  # @return [String, nil]
46
47
  optional :program_id, String
@@ -59,7 +60,7 @@ module Increase
59
60
  #
60
61
  # @param loan [Increase::Models::AccountCreateParams::Loan] The loan details for the account.
61
62
  #
62
- # @param program_id [String] The identifier for the Program that this Account falls under. Required if you op
63
+ # @param program_id [String] The identifier for the Program that this Account falls under. Required if your G
63
64
  #
64
65
  # @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}]
65
66
 
@@ -17,7 +17,7 @@ module Increase
17
17
  required :account_id, String
18
18
 
19
19
  # @!attribute account_number
20
- # The destination account number.
20
+ # The receiver's account number.
21
21
  #
22
22
  # @return [String]
23
23
  required :account_number, String
@@ -109,8 +109,7 @@ module Increase
109
109
  required :currency, enum: -> { Increase::ACHTransfer::Currency }
110
110
 
111
111
  # @!attribute destination_account_holder
112
- # The type of entity that owns the account to which the ACH Transfer is being
113
- # sent.
112
+ # The type of entity that owns the receiver's account.
114
113
  #
115
114
  # @return [Symbol, Increase::Models::ACHTransfer::DestinationAccountHolder]
116
115
  required :destination_account_holder, enum: -> { Increase::ACHTransfer::DestinationAccountHolder }
@@ -122,7 +121,7 @@ module Increase
122
121
  required :external_account_id, String, nil?: true
123
122
 
124
123
  # @!attribute funding
125
- # The type of the account to which the transfer will be sent.
124
+ # The type of the receiver's bank account.
126
125
  #
127
126
  # @return [Symbol, Increase::Models::ACHTransfer::Funding]
128
127
  required :funding, enum: -> { Increase::ACHTransfer::Funding }
@@ -143,7 +142,8 @@ module Increase
143
142
  required :inbound_funds_hold, -> { Increase::ACHTransfer::InboundFundsHold }, nil?: true
144
143
 
145
144
  # @!attribute individual_id
146
- # Your identifier for the transfer recipient.
145
+ # Your internal identifier for the transfer recipient. This value is informational
146
+ # and not verified by the recipient's bank.
147
147
  #
148
148
  # @return [String, nil]
149
149
  required :individual_id, String, nil?: true
@@ -194,7 +194,8 @@ module Increase
194
194
  required :return_, -> { Increase::ACHTransfer::Return }, api_name: :return, nil?: true
195
195
 
196
196
  # @!attribute routing_number
197
- # The American Bankers' Association (ABA) Routing Transit Number (RTN).
197
+ # The American Bankers' Association (ABA) Routing Transit Number (RTN) of the
198
+ # receiver's bank.
198
199
  #
199
200
  # @return [String]
200
201
  required :routing_number, String
@@ -260,7 +261,7 @@ module Increase
260
261
  #
261
262
  # @param account_id [String] The Account to which the transfer belongs.
262
263
  #
263
- # @param account_number [String] The destination account number.
264
+ # @param account_number [String] The receiver's account number.
264
265
  #
265
266
  # @param acknowledgement [Increase::Models::ACHTransfer::Acknowledgement, nil] After the transfer is acknowledged by FedACH, this will contain supplemental det
266
267
  #
@@ -288,17 +289,17 @@ module Increase
288
289
  #
289
290
  # @param currency [Symbol, Increase::Models::ACHTransfer::Currency] The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transfer's c
290
291
  #
291
- # @param destination_account_holder [Symbol, Increase::Models::ACHTransfer::DestinationAccountHolder] The type of entity that owns the account to which the ACH Transfer is being sent
292
+ # @param destination_account_holder [Symbol, Increase::Models::ACHTransfer::DestinationAccountHolder] The type of entity that owns the receiver's account.
292
293
  #
293
294
  # @param external_account_id [String, nil] The identifier of the External Account the transfer was made to, if any.
294
295
  #
295
- # @param funding [Symbol, Increase::Models::ACHTransfer::Funding] The type of the account to which the transfer will be sent.
296
+ # @param funding [Symbol, Increase::Models::ACHTransfer::Funding] The type of the receiver's bank account.
296
297
  #
297
298
  # @param idempotency_key [String, nil] The idempotency key you chose for this object. This value is unique across Incre
298
299
  #
299
300
  # @param inbound_funds_hold [Increase::Models::ACHTransfer::InboundFundsHold, nil] Increase will sometimes hold the funds for ACH debit transfers. If funds are hel
300
301
  #
301
- # @param individual_id [String, nil] Your identifier for the transfer recipient.
302
+ # @param individual_id [String, nil] Your internal identifier for the transfer recipient. This value is informational
302
303
  #
303
304
  # @param individual_name [String, nil] The name of the transfer recipient. This value is informational and not verified
304
305
  #
@@ -312,7 +313,7 @@ module Increase
312
313
  #
313
314
  # @param return_ [Increase::Models::ACHTransfer::Return, nil] If your transfer is returned, this will contain details of the return.
314
315
  #
315
- # @param routing_number [String] The American Bankers' Association (ABA) Routing Transit Number (RTN).
316
+ # @param routing_number [String] The American Bankers' Association (ABA) Routing Transit Number (RTN) of the rece
316
317
  #
317
318
  # @param settlement [Increase::Models::ACHTransfer::Settlement, nil] A subhash containing information about when and how the transfer settled at the
318
319
  #
@@ -640,8 +641,7 @@ module Increase
640
641
  # @return [Array<Symbol>]
641
642
  end
642
643
 
643
- # The type of entity that owns the account to which the ACH Transfer is being
644
- # sent.
644
+ # The type of entity that owns the receiver's account.
645
645
  #
646
646
  # @see Increase::Models::ACHTransfer#destination_account_holder
647
647
  module DestinationAccountHolder
@@ -660,7 +660,7 @@ module Increase
660
660
  # @return [Array<Symbol>]
661
661
  end
662
662
 
663
- # The type of the account to which the transfer will be sent.
663
+ # The type of the receiver's bank account.
664
664
  #
665
665
  # @see Increase::Models::ACHTransfer#funding
666
666
  module Funding
@@ -1019,7 +1019,7 @@ module Increase
1019
1019
  # The chosen effective date will be the same as the ACH processing date on which the transfer is submitted.
1020
1020
  # This is necessary, but not sufficient for the transfer to be settled same-day:
1021
1021
  # it must also be submitted before the last same-day cutoff
1022
- # and be less than or equal to $1,000.000.00.
1022
+ # and be less than or equal to $1,000,000.00.
1023
1023
  SAME_DAY = :same_day
1024
1024
 
1025
1025
  # The chosen effective date will be the business day following the ACH processing date on which the transfer is submitted. The transfer will be settled on that future day.
@@ -1068,7 +1068,8 @@ module Increase
1068
1068
  required :transaction_id, String
1069
1069
 
1070
1070
  # @!attribute transfer_id
1071
- # The identifier of the ACH Transfer associated with this return.
1071
+ # The identifier of the ACH Transfer associated with this return. This matches the
1072
+ # original Transaction's `source.ach_transfer_intention.transfer_id`.
1072
1073
  #
1073
1074
  # @return [String]
1074
1075
  required :transfer_id, String
@@ -1089,7 +1090,7 @@ module Increase
1089
1090
  #
1090
1091
  # @param transaction_id [String] The identifier of the Transaction associated with this return.
1091
1092
  #
1092
- # @param transfer_id [String] The identifier of the ACH Transfer associated with this return.
1093
+ # @param transfer_id [String] The identifier of the ACH Transfer associated with this return. This matches the
1093
1094
 
1094
1095
  # Why the ACH Transfer was returned. This reason code is sent by the receiving
1095
1096
  # bank back to Increase.
@@ -1386,7 +1387,7 @@ module Increase
1386
1387
  # The transfer has been rejected.
1387
1388
  REJECTED = :rejected
1388
1389
 
1389
- # The transfer is complete.
1390
+ # The transfer has been submitted to the Federal Reserve. When the transfer settles, the status remains `submitted` and the `settlement` sub-object is populated.
1390
1391
  SUBMITTED = :submitted
1391
1392
 
1392
1393
  # The transfer has been returned.
@@ -33,50 +33,58 @@ module Increase
33
33
  required :statement_descriptor, String
34
34
 
35
35
  # @!attribute account_number
36
- # The account number for the destination account.
36
+ # The receiver's account number. For credit transfers (positive `amount`) this is
37
+ # the account that funds will be sent to. For debit transfers (negative `amount`)
38
+ # this is the account that funds will be pulled from.
37
39
  #
38
40
  # @return [String, nil]
39
41
  optional :account_number, String
40
42
 
41
43
  # @!attribute addenda
42
- # Additional information that will be sent to the recipient. This is included in
43
- # the transfer data sent to the receiving bank.
44
+ # Additional information passed through to the receiving bank with the transfer.
45
+ # Most ACH transfers do not need this. Only set this if your recipient has asked
46
+ # for addendum data, typically unstructured remittance information. Corporate
47
+ # Trade Exchange (CTX) flows can carry structured X12 remittance advice instead.
44
48
  #
45
49
  # @return [Increase::Models::ACHTransferCreateParams::Addenda, nil]
46
50
  optional :addenda, -> { Increase::ACHTransferCreateParams::Addenda }
47
51
 
48
52
  # @!attribute company_descriptive_date
49
- # The description of the date of the transfer, usually in the format `YYMMDD`.
50
- # This is included in the transfer data sent to the receiving bank.
53
+ # A description of the transfer date (typically `YYMMDD`), sent in the company
54
+ # batch header. This value is informational and does not affect funds movement,
55
+ # settlement timing, or returns. Only set this if your recipient has asked for it.
51
56
  #
52
57
  # @return [String, nil]
53
58
  optional :company_descriptive_date, String
54
59
 
55
60
  # @!attribute company_discretionary_data
56
- # The data you choose to associate with the transfer. This is included in the
57
- # transfer data sent to the receiving bank.
61
+ # Custom data sent in the company batch header. This value is informational and
62
+ # does not affect funds movement, settlement timing, or returns. Most ACH
63
+ # transfers do not need this. Only set this if your recipient has asked for it.
58
64
  #
59
65
  # @return [String, nil]
60
66
  optional :company_discretionary_data, String
61
67
 
62
68
  # @!attribute company_entry_description
63
- # A description of the transfer, included in the transfer data sent to the
64
- # receiving bank. Standardized formatting may be required, for example `PAYROLL`
65
- # for payroll-related Prearranged Payments and Deposits (PPD) credit transfers.
69
+ # A short description sent in the company batch header. Most receivers do not
70
+ # surface this. Only set this if your recipient has asked for a specific value or
71
+ # if Nacha mandates one for your Standard Entry Class (SEC) code and use case. For
72
+ # example, Prearranged Payment and Deposit (PPD) payroll credits must use
73
+ # `PAYROLL`, and reversals must use `REVERSAL`.
66
74
  #
67
75
  # @return [String, nil]
68
76
  optional :company_entry_description, String
69
77
 
70
78
  # @!attribute company_name
71
- # The name by which the recipient knows you. This is included in the transfer data
72
- # sent to the receiving bank.
79
+ # The name by which the recipient knows you, sent in the company batch header. We
80
+ # recommend setting this on every transfer; if you do not, we fall back to the ACH
81
+ # company name configured on your account.
73
82
  #
74
83
  # @return [String, nil]
75
84
  optional :company_name, String
76
85
 
77
86
  # @!attribute destination_account_holder
78
- # The type of entity that owns the account to which the ACH Transfer is being
79
- # sent.
87
+ # The type of entity that owns the receiver's account.
80
88
  #
81
89
  # @return [Symbol, Increase::Models::ACHTransferCreateParams::DestinationAccountHolder, nil]
82
90
  optional :destination_account_holder,
@@ -90,13 +98,14 @@ module Increase
90
98
  optional :external_account_id, String
91
99
 
92
100
  # @!attribute funding
93
- # The type of the account to which the transfer will be sent.
101
+ # The type of the receiver's bank account.
94
102
  #
95
103
  # @return [Symbol, Increase::Models::ACHTransferCreateParams::Funding, nil]
96
104
  optional :funding, enum: -> { Increase::ACHTransferCreateParams::Funding }
97
105
 
98
106
  # @!attribute individual_id
99
- # Your identifier for the transfer recipient.
107
+ # Your internal identifier for the transfer recipient. This value is informational
108
+ # and not verified by the recipient's bank. Most callers can leave this unset.
100
109
  #
101
110
  # @return [String, nil]
102
111
  optional :individual_id, String
@@ -124,8 +133,8 @@ module Increase
124
133
  optional :require_approval, Increase::Internal::Type::Boolean
125
134
 
126
135
  # @!attribute routing_number
127
- # The American Bankers' Association (ABA) Routing Transit Number (RTN) for the
128
- # destination account.
136
+ # The American Bankers' Association (ABA) Routing Transit Number (RTN) of the
137
+ # receiver's bank.
129
138
  #
130
139
  # @return [String, nil]
131
140
  optional :routing_number, String
@@ -133,7 +142,8 @@ module Increase
133
142
  # @!attribute standard_entry_class_code
134
143
  # The
135
144
  # [Standard Entry Class (SEC) code](/documentation/ach-standard-entry-class-codes)
136
- # to use for the transfer.
145
+ # to use for the transfer. If not provided, the default is
146
+ # `corporate_credit_or_debit`.
137
147
  #
138
148
  # @return [Symbol, Increase::Models::ACHTransferCreateParams::StandardEntryClassCode, nil]
139
149
  optional :standard_entry_class_code,
@@ -155,25 +165,25 @@ module Increase
155
165
  #
156
166
  # @param statement_descriptor [String] A description you choose to give the transfer. This will be saved with the trans
157
167
  #
158
- # @param account_number [String] The account number for the destination account.
168
+ # @param account_number [String] The receiver's account number. For credit transfers (positive `amount`) this is
159
169
  #
160
- # @param addenda [Increase::Models::ACHTransferCreateParams::Addenda] Additional information that will be sent to the recipient. This is included in t
170
+ # @param addenda [Increase::Models::ACHTransferCreateParams::Addenda] Additional information passed through to the receiving bank with the transfer. M
161
171
  #
162
- # @param company_descriptive_date [String] The description of the date of the transfer, usually in the format `YYMMDD`. Thi
172
+ # @param company_descriptive_date [String] A description of the transfer date (typically `YYMMDD`), sent in the company bat
163
173
  #
164
- # @param company_discretionary_data [String] The data you choose to associate with the transfer. This is included in the tran
174
+ # @param company_discretionary_data [String] Custom data sent in the company batch header. This value is informational and do
165
175
  #
166
- # @param company_entry_description [String] A description of the transfer, included in the transfer data sent to the receivi
176
+ # @param company_entry_description [String] A short description sent in the company batch header. Most receivers do not surf
167
177
  #
168
- # @param company_name [String] The name by which the recipient knows you. This is included in the transfer data
178
+ # @param company_name [String] The name by which the recipient knows you, sent in the company batch header. We
169
179
  #
170
- # @param destination_account_holder [Symbol, Increase::Models::ACHTransferCreateParams::DestinationAccountHolder] The type of entity that owns the account to which the ACH Transfer is being sent
180
+ # @param destination_account_holder [Symbol, Increase::Models::ACHTransferCreateParams::DestinationAccountHolder] The type of entity that owns the receiver's account.
171
181
  #
172
182
  # @param external_account_id [String] The ID of an External Account to initiate a transfer to. If this parameter is pr
173
183
  #
174
- # @param funding [Symbol, Increase::Models::ACHTransferCreateParams::Funding] The type of the account to which the transfer will be sent.
184
+ # @param funding [Symbol, Increase::Models::ACHTransferCreateParams::Funding] The type of the receiver's bank account.
175
185
  #
176
- # @param individual_id [String] Your identifier for the transfer recipient.
186
+ # @param individual_id [String] Your internal identifier for the transfer recipient. This value is informational
177
187
  #
178
188
  # @param individual_name [String] The name of the transfer recipient. This value is informational and not verified
179
189
  #
@@ -181,7 +191,7 @@ module Increase
181
191
  #
182
192
  # @param require_approval [Boolean] Whether the transfer requires explicit approval via the dashboard or API.
183
193
  #
184
- # @param routing_number [String] The American Bankers' Association (ABA) Routing Transit Number (RTN) for the des
194
+ # @param routing_number [String] The American Bankers' Association (ABA) Routing Transit Number (RTN) of the rece
185
195
  #
186
196
  # @param standard_entry_class_code [Symbol, Increase::Models::ACHTransferCreateParams::StandardEntryClassCode] The [Standard Entry Class (SEC) code](/documentation/ach-standard-entry-class-co
187
197
  #
@@ -216,8 +226,10 @@ module Increase
216
226
  # Some parameter documentations has been truncated, see
217
227
  # {Increase::Models::ACHTransferCreateParams::Addenda} for more details.
218
228
  #
219
- # Additional information that will be sent to the recipient. This is included in
220
- # the transfer data sent to the receiving bank.
229
+ # Additional information passed through to the receiving bank with the transfer.
230
+ # Most ACH transfers do not need this. Only set this if your recipient has asked
231
+ # for addendum data, typically unstructured remittance information. Corporate
232
+ # Trade Exchange (CTX) flows can carry structured X12 remittance advice instead.
221
233
  #
222
234
  # @param category [Symbol, Increase::Models::ACHTransferCreateParams::Addenda::Category] The type of addenda to pass with the transfer.
223
235
  #
@@ -315,8 +327,7 @@ module Increase
315
327
  end
316
328
  end
317
329
 
318
- # The type of entity that owns the account to which the ACH Transfer is being
319
- # sent.
330
+ # The type of entity that owns the receiver's account.
320
331
  module DestinationAccountHolder
321
332
  extend Increase::Internal::Type::Enum
322
333
 
@@ -333,7 +344,7 @@ module Increase
333
344
  # @return [Array<Symbol>]
334
345
  end
335
346
 
336
- # The type of the account to which the transfer will be sent.
347
+ # The type of the receiver's bank account.
337
348
  module Funding
338
349
  extend Increase::Internal::Type::Enum
339
350
 
@@ -388,7 +399,7 @@ module Increase
388
399
  module SettlementSchedule
389
400
  extend Increase::Internal::Type::Enum
390
401
 
391
- # The chosen effective date will be the same as the ACH processing date on which the transfer is submitted. This is necessary, but not sufficient for the transfer to be settled same-day: it must also be submitted before the last same-day cutoff and be less than or equal to $1,000.000.00.
402
+ # The chosen effective date will be the same as the ACH processing date on which the transfer is submitted. This is necessary, but not sufficient for the transfer to be settled same-day: it must also be submitted before the last same-day cutoff and be less than or equal to $1,000,000.00.
392
403
  SAME_DAY = :same_day
393
404
 
394
405
  # The chosen effective date will be the business day following the ACH processing date on which the transfer is submitted. The transfer will be settled on that future day.
@@ -401,7 +412,8 @@ module Increase
401
412
 
402
413
  # The
403
414
  # [Standard Entry Class (SEC) code](/documentation/ach-standard-entry-class-codes)
404
- # to use for the transfer.
415
+ # to use for the transfer. If not provided, the default is
416
+ # `corporate_credit_or_debit`.
405
417
  module StandardEntryClassCode
406
418
  extend Increase::Internal::Type::Enum
407
419
 
@@ -153,7 +153,7 @@ module Increase
153
153
  # The transfer has been rejected.
154
154
  REJECTED = :rejected
155
155
 
156
- # The transfer is complete.
156
+ # The transfer has been submitted to the Federal Reserve. When the transfer settles, the status remains `submitted` and the `settlement` sub-object is populated.
157
157
  SUBMITTED = :submitted
158
158
 
159
159
  # The transfer has been returned.
@@ -173,7 +173,8 @@ module Increase
173
173
  # An identification number that can be used to verify the individual's identity,
174
174
  # such as a social security number. For Social Security Numbers and Individual
175
175
  # Taxpayer Identification Numbers, submit nine digits with no dashes or other
176
- # separators.
176
+ # separators. When testing in sandbox, use one of our
177
+ # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
177
178
  #
178
179
  # @return [String]
179
180
  required :number, String
@@ -140,7 +140,8 @@ module Increase
140
140
  # An identification number that can be used to verify the individual's identity,
141
141
  # such as a social security number. For Social Security Numbers and Individual
142
142
  # Taxpayer Identification Numbers, submit nine digits with no dashes or other
143
- # separators.
143
+ # separators. When testing in sandbox, use one of our
144
+ # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
144
145
  #
145
146
  # @return [String]
146
147
  required :number, String
@@ -1380,15 +1380,15 @@ module Increase
1380
1380
  # The transfer has been canceled.
1381
1381
  CANCELED = :canceled
1382
1382
 
1383
+ # The transfer is queued to be submitted to the card network.
1384
+ PENDING_SUBMISSION = :pending_submission
1385
+
1383
1386
  # The transfer is pending review by Increase.
1384
1387
  PENDING_REVIEWING = :pending_reviewing
1385
1388
 
1386
1389
  # The transfer requires attention from an Increase operator.
1387
1390
  REQUIRES_ATTENTION = :requires_attention
1388
1391
 
1389
- # The transfer is queued to be submitted to the card network.
1390
- PENDING_SUBMISSION = :pending_submission
1391
-
1392
1392
  # The transfer has been submitted and is pending a response from the card network.
1393
1393
  SUBMITTED = :submitted
1394
1394
 
@@ -132,15 +132,15 @@ module Increase
132
132
  # The transfer has been canceled.
133
133
  CANCELED = :canceled
134
134
 
135
+ # The transfer is queued to be submitted to the card network.
136
+ PENDING_SUBMISSION = :pending_submission
137
+
135
138
  # The transfer is pending review by Increase.
136
139
  PENDING_REVIEWING = :pending_reviewing
137
140
 
138
141
  # The transfer requires attention from an Increase operator.
139
142
  REQUIRES_ATTENTION = :requires_attention
140
143
 
141
- # The transfer is queued to be submitted to the card network.
142
- PENDING_SUBMISSION = :pending_submission
143
-
144
144
  # The transfer has been submitted and is pending a response from the card network.
145
145
  SUBMITTED = :submitted
146
146
 
@@ -788,10 +788,13 @@ module Increase
788
788
  # The check has been delivered. Note that some couriers track delivery status based on driver location data rather than an explicit scan. While uncommon, a single check may have more than one delivered event.
789
789
  DELIVERED = :delivered
790
790
 
791
- # There is an issue preventing delivery. The delivery will be attempted again if possible. If the issue cannot be resolved, the check will be returned to sender.
791
+ # There is an issue preventing delivery. The delivery will be attempted again if possible. If the issue cannot be resolved, the check will be rerouted to the return address.
792
792
  DELIVERY_ISSUE = :delivery_issue
793
793
 
794
- # Delivery failed and the check was returned to sender.
794
+ # The check has been rerouted to the return address.
795
+ RETURNING_TO_SENDER = :returning_to_sender
796
+
797
+ # The check has been delivered to the return address.
795
798
  RETURNED_TO_SENDER = :returned_to_sender
796
799
 
797
800
  # @!method self.values
@@ -159,7 +159,8 @@ module Increase
159
159
 
160
160
  # @!attribute legal_identifier
161
161
  # The legal identifier of the corporation. This is usually the Employer
162
- # Identification Number (EIN).
162
+ # Identification Number (EIN). This replaces the deprecated `tax_identifier`
163
+ # field.
163
164
  #
164
165
  # @return [Increase::Models::EntityCreateParams::Corporation::LegalIdentifier]
165
166
  required :legal_identifier, -> { Increase::EntityCreateParams::Corporation::LegalIdentifier }
@@ -456,7 +457,8 @@ module Increase
456
457
  # An identification number that can be used to verify the individual's identity,
457
458
  # such as a social security number. For Social Security Numbers and Individual
458
459
  # Taxpayer Identification Numbers, submit nine digits with no dashes or other
459
- # separators.
460
+ # separators. When testing in sandbox, use one of our
461
+ # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
460
462
  #
461
463
  # @return [String]
462
464
  required :number, String
@@ -675,7 +677,8 @@ module Increase
675
677
  class LegalIdentifier < Increase::Internal::Type::BaseModel
676
678
  # @!attribute value
677
679
  # The legal identifier. For US Employer Identification Numbers, submit nine digits
678
- # with no dashes or other separators.
680
+ # with no dashes or other separators. When testing in sandbox, use one of our
681
+ # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
679
682
  #
680
683
  # @return [String]
681
684
  required :value, String
@@ -693,7 +696,8 @@ module Increase
693
696
  # details.
694
697
  #
695
698
  # The legal identifier of the corporation. This is usually the Employer
696
- # Identification Number (EIN).
699
+ # Identification Number (EIN). This replaces the deprecated `tax_identifier`
700
+ # field.
697
701
  #
698
702
  # @param value [String] The legal identifier. For US Employer Identification Numbers, submit nine digits
699
703
  #
@@ -1025,7 +1029,8 @@ module Increase
1025
1029
  # An identification number that can be used to verify the individual's identity,
1026
1030
  # such as a social security number. For Social Security Numbers and Individual
1027
1031
  # Taxpayer Identification Numbers, submit nine digits with no dashes or other
1028
- # separators.
1032
+ # separators. When testing in sandbox, use one of our
1033
+ # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
1029
1034
  #
1030
1035
  # @return [String]
1031
1036
  required :number, String
@@ -1352,7 +1357,8 @@ module Increase
1352
1357
  # An identification number that can be used to verify the individual's identity,
1353
1358
  # such as a social security number. For Social Security Numbers and Individual
1354
1359
  # Taxpayer Identification Numbers, submit nine digits with no dashes or other
1355
- # separators.
1360
+ # separators. When testing in sandbox, use one of our
1361
+ # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
1356
1362
  #
1357
1363
  # @return [String]
1358
1364
  required :number, String
@@ -1996,7 +2002,8 @@ module Increase
1996
2002
  # An identification number that can be used to verify the individual's identity,
1997
2003
  # such as a social security number. For Social Security Numbers and Individual
1998
2004
  # Taxpayer Identification Numbers, submit nine digits with no dashes or other
1999
- # separators.
2005
+ # separators. When testing in sandbox, use one of our
2006
+ # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
2000
2007
  #
2001
2008
  # @return [String]
2002
2009
  required :number, String
@@ -2323,7 +2330,8 @@ module Increase
2323
2330
  # An identification number that can be used to verify the individual's identity,
2324
2331
  # such as a social security number. For Social Security Numbers and Individual
2325
2332
  # Taxpayer Identification Numbers, submit nine digits with no dashes or other
2326
- # separators.
2333
+ # separators. When testing in sandbox, use one of our
2334
+ # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
2327
2335
  #
2328
2336
  # @return [String]
2329
2337
  required :number, String
@@ -467,7 +467,8 @@ module Increase
467
467
  # An identification number that can be used to verify the individual's identity,
468
468
  # such as a social security number. For Social Security Numbers and Individual
469
469
  # Taxpayer Identification Numbers, submit nine digits with no dashes or other
470
- # separators.
470
+ # separators. When testing in sandbox, use one of our
471
+ # [sandbox test values](https://increase.com/documentation/sandbox-test-values).
471
472
  #
472
473
  # @return [String]
473
474
  required :number, String
@@ -518,6 +518,9 @@ module Increase
518
518
  module Status
519
519
  extend Increase::Internal::Type::Enum
520
520
 
521
+ # The transfer is queued to be submitted to FedNow.
522
+ PENDING_SUBMITTING = :pending_submitting
523
+
521
524
  # The transfer is pending review by Increase.
522
525
  PENDING_REVIEWING = :pending_reviewing
523
526
 
@@ -533,9 +536,6 @@ module Increase
533
536
  # The transfer is pending approval.
534
537
  PENDING_APPROVAL = :pending_approval
535
538
 
536
- # The transfer is queued to be submitted to FedNow.
537
- PENDING_SUBMITTING = :pending_submitting
538
-
539
539
  # The transfer has been submitted and is pending a response from FedNow.
540
540
  PENDING_RESPONSE = :pending_response
541
541
 
@@ -134,6 +134,9 @@ module Increase
134
134
  module In
135
135
  extend Increase::Internal::Type::Enum
136
136
 
137
+ # The transfer is queued to be submitted to FedNow.
138
+ PENDING_SUBMITTING = :pending_submitting
139
+
137
140
  # The transfer is pending review by Increase.
138
141
  PENDING_REVIEWING = :pending_reviewing
139
142
 
@@ -149,9 +152,6 @@ module Increase
149
152
  # The transfer is pending approval.
150
153
  PENDING_APPROVAL = :pending_approval
151
154
 
152
- # The transfer is queued to be submitted to FedNow.
153
- PENDING_SUBMITTING = :pending_submitting
154
-
155
155
  # The transfer has been submitted and is pending a response from FedNow.
156
156
  PENDING_RESPONSE = :pending_response
157
157
 
@@ -72,7 +72,9 @@ module Increase
72
72
  # {Increase::Models::InboundMailItem} for more details.
73
73
  #
74
74
  # Inbound Mail Items represent pieces of physical mail delivered to a Lockbox
75
- # Address.
75
+ # Address. Increase automatically deposits checks mailed to a Lockbox Recipient
76
+ # into the recipient's Account. Checks that are not matched to a Lockbox Recipient
77
+ # must be deposited or ignored using the Action an Inbound Mail Item endpoint.
76
78
  #
77
79
  # @param id [String] The Inbound Mail Item identifier.
78
80
  #
@@ -245,7 +245,7 @@ module Increase
245
245
  # The transfer is pending confirmation.
246
246
  PENDING_CONFIRMING = :pending_confirming
247
247
 
248
- # The transfer was not responded to in time.
248
+ # The transfer was not responded to in time. This is rare and represents an error at Increase.
249
249
  TIMED_OUT = :timed_out
250
250
 
251
251
  # The transfer has been received successfully and is confirmed.