genesis_ruby 0.3.2 → 0.4.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 (121) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +35 -0
  3. data/README.md +169 -1
  4. data/VERSION +1 -1
  5. data/lib/genesis_ruby/api/constants/non_financial/alternatives/alipay/merchant_types.rb +26 -0
  6. data/lib/genesis_ruby/api/constants/non_financial/alternatives/alipay/site_types.rb +26 -0
  7. data/lib/genesis_ruby/api/constants/non_financial/kyc/bank_account_types.rb +24 -0
  8. data/lib/genesis_ruby/api/constants/transactions/parameters/foreign_retailer_indicators.rb +24 -0
  9. data/lib/genesis_ruby/api/constants/transactions/parameters/funding/person_types.rb +26 -0
  10. data/lib/genesis_ruby/api/constants/transactions/parameters/money_transfer/purpose_of_payments.rb +46 -19
  11. data/lib/genesis_ruby/api/constants/transactions/parameters/money_transfer/sender_account_number_types.rb +14 -17
  12. data/lib/genesis_ruby/api/constants/transactions/parameters/money_transfer/source_of_funds.rb +9 -18
  13. data/lib/genesis_ruby/api/constants/transactions/parameters/money_transfer/types.rb +31 -4
  14. data/lib/genesis_ruby/api/constants/transactions/parameters/non_financial/billing_api/enhanced_statement_response_fields.rb +39 -0
  15. data/lib/genesis_ruby/api/constants/transactions/parameters/non_financial/billing_api/response_fields.rb +2 -0
  16. data/lib/genesis_ruby/api/constants/transactions/parameters/non_financial/billing_api/statement_order_by_fields.rb +31 -0
  17. data/lib/genesis_ruby/api/constants/transactions/parameters/non_financial/billing_api/statement_response_fields.rb +14 -13
  18. data/lib/genesis_ruby/api/constants/transactions/parameters/non_financial/{processing_type.rb → scopes.rb} +4 -3
  19. data/lib/genesis_ruby/api/constants/transactions/parameters/purpose_of_payment.rb +117 -0
  20. data/lib/genesis_ruby/api/constants/transactions/parameters/purpose_of_payment_values.rb +267 -0
  21. data/lib/genesis_ruby/api/constants/transactions/parameters/wallets/e_wallet/payment_types.rb +46 -0
  22. data/lib/genesis_ruby/api/constants/transactions.rb +9 -0
  23. data/lib/genesis_ruby/api/mixins/requests/customer_address/billing_info_attributes.rb +3 -1
  24. data/lib/genesis_ruby/api/mixins/requests/financial/cards/credential_on_file_transaction_link_attributes.rb +83 -0
  25. data/lib/genesis_ruby/api/mixins/requests/financial/commercial_card_attributes.rb +143 -0
  26. data/lib/genesis_ruby/api/mixins/requests/financial/funding_attributes.rb +32 -3
  27. data/lib/genesis_ruby/api/mixins/requests/financial/marketplace_data_attributes.rb +179 -0
  28. data/lib/genesis_ruby/api/mixins/requests/financial/money_transfer_payout_attributes.rb +49 -46
  29. data/lib/genesis_ruby/api/mixins/requests/financial/order_attributes.rb +36 -0
  30. data/lib/genesis_ruby/api/mixins/requests/financial/purpose_of_payment_attributes.rb +14 -4
  31. data/lib/genesis_ruby/api/mixins/requests/financial/refund/bank_attributes.rb +41 -0
  32. data/lib/genesis_ruby/api/mixins/requests/financial/refund/beneficiary_attributes.rb +31 -0
  33. data/lib/genesis_ruby/api/mixins/requests/financial/refund/travel_ticket_attributes.rb +52 -0
  34. data/lib/genesis_ruby/api/mixins/requests/financial/threeds/force_threeds_attributes.rb +29 -0
  35. data/lib/genesis_ruby/api/mixins/requests/non_financial/alternatives/alipay/site_information_attributes.rb +57 -0
  36. data/lib/genesis_ruby/api/mixins/requests/non_financial/date_time_from_to_attributes.rb +102 -0
  37. data/lib/genesis_ruby/api/mixins/requests/non_financial/kyc/background_checks_attributes.rb +31 -10
  38. data/lib/genesis_ruby/api/mixins/requests/non_financial/kyc/verification_document_attributes.rb +49 -7
  39. data/lib/genesis_ruby/api/mixins/requests/non_financial/kyc/verification_instructions_attributes.rb +90 -0
  40. data/lib/genesis_ruby/api/mixins/requests/non_financial/reconcile_order_attributes.rb +30 -0
  41. data/lib/genesis_ruby/api/mixins/requests/non_financial/scope_attributes.rb +29 -0
  42. data/lib/genesis_ruby/api/mixins/requests/restricted_setter.rb +12 -0
  43. data/lib/genesis_ruby/api/mixins/requests/scheme_tokenized_attributes.rb +35 -0
  44. data/lib/genesis_ruby/api/requests/base/financials/credit_card.rb +1 -12
  45. data/lib/genesis_ruby/api/requests/base/graphql.rb +7 -0
  46. data/lib/genesis_ruby/api/requests/base/non_financial/billing_api/abstract_statement.rb +226 -0
  47. data/lib/genesis_ruby/api/requests/base/non_financial/billing_api/base.rb +39 -37
  48. data/lib/genesis_ruby/api/requests/base/non_financial/reconcile/base.rb +45 -0
  49. data/lib/genesis_ruby/api/requests/financial/async_refund.rb +41 -0
  50. data/lib/genesis_ruby/api/requests/financial/cards/authorize.rb +43 -24
  51. data/lib/genesis_ruby/api/requests/financial/cards/authorize3d.rb +13 -1
  52. data/lib/genesis_ruby/api/requests/financial/cards/payout.rb +21 -5
  53. data/lib/genesis_ruby/api/requests/financial/cards/sale.rb +42 -23
  54. data/lib/genesis_ruby/api/requests/financial/cards/sale3d.rb +13 -1
  55. data/lib/genesis_ruby/api/requests/financial/mobile/apple_pay.rb +5 -1
  56. data/lib/genesis_ruby/api/requests/financial/mobile/google_pay.rb +6 -2
  57. data/lib/genesis_ruby/api/requests/financial/online_banking_payments/my_bank.rb +1 -1
  58. data/lib/genesis_ruby/api/requests/financial/refund.rb +20 -35
  59. data/lib/genesis_ruby/api/requests/financial/sdd/sale.rb +6 -1
  60. data/lib/genesis_ruby/api/requests/financial/wallets/e_wallet.rb +72 -0
  61. data/lib/genesis_ruby/api/requests/non_financial/alternatives/alipay/register_merchant.rb +147 -0
  62. data/lib/genesis_ruby/api/requests/non_financial/billing_api/enhanced_statement.rb +46 -0
  63. data/lib/genesis_ruby/api/requests/non_financial/billing_api/statement.rb +12 -137
  64. data/lib/genesis_ruby/api/requests/non_financial/billing_api/transactions.rb +4 -2
  65. data/lib/genesis_ruby/api/requests/non_financial/fraud/chargeback/date_range.rb +10 -19
  66. data/lib/genesis_ruby/api/requests/non_financial/fraud/rdr/date_range.rb +91 -0
  67. data/lib/genesis_ruby/api/requests/non_financial/fraud/rdr/transaction.rb +54 -0
  68. data/lib/genesis_ruby/api/requests/non_financial/fraud/retrieval/date_range.rb +10 -19
  69. data/lib/genesis_ruby/api/requests/non_financial/kyc/verifications/bank_account.rb +76 -0
  70. data/lib/genesis_ruby/api/requests/non_financial/kyc/verifications/create.rb +31 -4
  71. data/lib/genesis_ruby/api/requests/non_financial/payment_authorizations/date_range.rb +124 -0
  72. data/lib/genesis_ruby/api/requests/non_financial/processed_transactions/date_range.rb +8 -15
  73. data/lib/genesis_ruby/api/requests/non_financial/processed_transactions/post_date_range.rb +12 -18
  74. data/lib/genesis_ruby/api/requests/non_financial/reconcile/date_range.rb +29 -4
  75. data/lib/genesis_ruby/api/requests/non_financial/reconcile/order.rb +40 -0
  76. data/lib/genesis_ruby/api/requests/non_financial/reconcile/transaction.rb +1 -15
  77. data/lib/genesis_ruby/api/requests/non_financial/tokenization/cryptogram.rb +3 -1
  78. data/lib/genesis_ruby/api/requests/non_financial/tokenization/tokenize.rb +3 -1
  79. data/lib/genesis_ruby/api/requests/wpf/create.rb +4 -0
  80. data/lib/genesis_ruby/api/requests/wpf/reconcile.rb +11 -4
  81. data/lib/genesis_ruby/api/requests/wpf/reconcile_by_date.rb +62 -0
  82. data/lib/genesis_ruby/api/requests/wpf/reconcile_by_order.rb +38 -0
  83. data/lib/genesis_ruby/builders/graphql.rb +95 -40
  84. data/lib/genesis_ruby/dependencies.rb +2 -0
  85. data/lib/genesis_ruby/utils/money/format.rb +2 -1
  86. data/lib/genesis_ruby/utils/transactions/financial_types.rb +3 -2
  87. data/lib/genesis_ruby/utils/transactions/references/refundable_types.rb +2 -1
  88. data/lib/genesis_ruby/utils/transactions/wpf_types.rb +1 -1
  89. data/lib/genesis_ruby/version.rb +1 -1
  90. metadata +40 -35
  91. data/.kiro/specs/f2025112509-add_managed_recurring_api/.config.kiro +0 -1
  92. data/.kiro/specs/f2025112509-add_managed_recurring_api/design.md +0 -332
  93. data/.kiro/specs/f2025112509-add_managed_recurring_api/requirements.md +0 -91
  94. data/.kiro/specs/f2025112509-add_managed_recurring_api/tasks.md +0 -139
  95. data/.kiro/specs/f2025112603-add_reverify_endpoint_to_payee_account/.config.kiro +0 -1
  96. data/.kiro/specs/f2025112603-add_reverify_endpoint_to_payee_account/design.md +0 -148
  97. data/.kiro/specs/f2025112603-add_reverify_endpoint_to_payee_account/requirements.md +0 -81
  98. data/.kiro/specs/f2025112603-add_reverify_endpoint_to_payee_account/tasks.md +0 -48
  99. data/.kiro/specs/f2025112606-add_list_payees_trx_request/.config.kiro +0 -1
  100. data/.kiro/specs/f2025112606-add_list_payees_trx_request/design.md +0 -112
  101. data/.kiro/specs/f2025112606-add_list_payees_trx_request/requirements.md +0 -74
  102. data/.kiro/specs/f2025112606-add_list_payees_trx_request/tasks.md +0 -38
  103. data/.kiro/specs/f2025112609_update_payee_request_params/design.md +0 -86
  104. data/.kiro/specs/f2025112609_update_payee_request_params/requirements.md +0 -86
  105. data/.kiro/specs/f2025112609_update_payee_request_params/tasks.md +0 -40
  106. data/.kiro/specs/f2025112612-add_payee_owner_documents_and_verification_requests/.config.kiro +0 -1
  107. data/.kiro/specs/f2025112612-add_payee_owner_documents_and_verification_requests/design.md +0 -246
  108. data/.kiro/specs/f2025112612-add_payee_owner_documents_and_verification_requests/requirements.md +0 -287
  109. data/.kiro/specs/f2025112612-add_payee_owner_documents_and_verification_requests/tasks.md +0 -76
  110. data/.kiro/specs/f2025112614-add_money_transfer_payout_attributes_to_payout_rq/design.md +0 -84
  111. data/.kiro/specs/f2025112614-add_money_transfer_payout_attributes_to_payout_rq/requirements.md +0 -88
  112. data/.kiro/specs/f2025112614-add_money_transfer_payout_attributes_to_payout_rq/tasks.md +0 -38
  113. data/.kiro/steering/product.md +0 -15
  114. data/.kiro/steering/spec-folder-naming.md +0 -16
  115. data/.kiro/steering/structure.md +0 -96
  116. data/.kiro/steering/tech.md +0 -66
  117. data/Gemfile +0 -6
  118. data/Gemfile.lock +0 -176
  119. data/Rakefile +0 -24
  120. data/genesis_ruby.gemspec +0 -47
  121. data/lib/genesis_ruby/api/constants/transactions/parameters/non_financial/externally_processed.rb +0 -24
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 25761ad9b4ff17bdcd71f0b5e084c4fce9cbfc5754ade3addf54debd8fcac1df
4
- data.tar.gz: 181e7917e70576f2cca9d38e7b59eef4799030ba21fcd52231e78206913827cc
3
+ metadata.gz: 2d49af9942fcd6a8bfa1588d624831868c57ae2af4b83e0e251271d9b7be5851
4
+ data.tar.gz: b8ca9c278033d60988967e5943bb7c076e455244283cc189f6f9fce47d25e8fd
5
5
  SHA512:
6
- metadata.gz: 556163d312e4e1e5abd5a70174f15fb6c179425499fd49cbf80c02c88d311479391a8afade1428983bbda34f1451b58a76b98ee7fac470dbeb10903b3ff798d8
7
- data.tar.gz: 201a4291c694d167212aecb08ab00f449961c0ad66ae6d6040205f583dc34162caba6931916114586cfdacc033df1985977c94b075bedd0eb96a6ca30f5ba627
6
+ metadata.gz: 39f192d05190c794bf8e254ba7e9448b8f02b8b798281160aa145bd8369bdcd91990b599736430d0fe3f0d34d21749ad417a4925254257d0ec0517ed3d18fb91
7
+ data.tar.gz: f6d9de1228d62e7c6c67624a549001e9ee80a6d91e21b4869eeabad5d7c73b89b3b6e71fb004ee4f84897ad94fc8ca0643262a132f868a092a5a44db4466d9b8
data/CHANGELOG.md CHANGED
@@ -1,3 +1,38 @@
1
+ 0.4.0
2
+ -----
3
+
4
+ **Features**:
5
+
6
+ * Added force_threeds parameter to Authorize3D, Sale3D, Apple Pay and Google Pay requests
7
+ * Added credential_on_file_transaction_link_id parameter to Authorize and Sale requests
8
+ * Added Rapid Dispute Resolution (RDR) Transaction and Date Range API requests
9
+ * Added Marketplace Foreign Retailer data support
10
+ * Added street_name attributes to the Billing attributes
11
+ * Updated SDD Sale allowed countries
12
+ * Updated Funding and Visa AFT attributes and validations
13
+ * Added eWallet transaction support
14
+ * Added scheme_tokenized parameter to Tokenization Cryptogram and Tokenize requests
15
+ * Updated Billing APIs to the current API contract
16
+ * Updated Processed Transactions, Chargebacks and Retrieval Requests Date Range reporting APIs to the current scope contract
17
+ * Added required scope parameter to Processed Transactions, Chargebacks and Retrieval Requests Date Range requests
18
+ * Added KYC Bank Account Verification API request
19
+ * Updated KYC Create Verification parameters
20
+ * Added order_id parameter to Authorize, Authorize3D, Sale, Sale3D and WPF Create requests
21
+ * Added Payment Authorizations API requests
22
+ * Added Async Refund transaction support
23
+ * Added Commercial Card Data and Mastercard LTI support to Authorize, Authorize3D, Sale, Sale3D and Refund requests
24
+ * Added Alipay Register Merchant APM Service request
25
+ * Completed Reconcile API support
26
+ * Added purpose_of_payment parameter to Authorize, Authorize3D, Sale, Sale3D, Apple Pay, Google Pay and WPF Create requests
27
+ * Updated Money Transfer and Purpose of Payment lists and Payout request Money Transfer section
28
+ * Removed deprecated processing_type and externally_processed parameters, constants and accessors from the Processed Transactions, Chargebacks and Retrieval Requests Date Range requests
29
+ * Removed gaming parameters from the Payout card request
30
+ * Removed credential_on_file_settlement_date and scheme_tokenized parameters from the Payout request, setting them now raises ParameterError
31
+
32
+ **Fixes**:
33
+
34
+ * Fixed zero-amount conversion for zero-exponent currencies
35
+
1
36
  0.3.2
2
37
  -----
3
38
 
data/README.md CHANGED
@@ -100,6 +100,7 @@ begin
100
100
  # Other
101
101
  request.lifetime = 30
102
102
  request.web_payment_form_id = '987654321'
103
+ request.order_id = 'ORD-2024-78456'
103
104
 
104
105
  # Reminders
105
106
  request.pay_later = true
@@ -155,6 +156,78 @@ rescue GenesisRuby::Error => error
155
156
  end
156
157
  ```
157
158
 
159
+ #### Marketplace Data (Foreign Retailer)
160
+
161
+ Available for the `Authorize`, `Authorize3d`, `Sale` and `Sale3d` card transactions.
162
+
163
+ <details>
164
+ <summary>Example Sale with Marketplace Data</summary>
165
+
166
+ ```ruby
167
+ require 'genesis_ruby'
168
+
169
+ begin
170
+ genesis = GenesisRuby::Genesis.for(config: configuration, request: GenesisRuby::Api::Requests::Financial::Cards::Sale) do |request|
171
+ # Common Attributes
172
+ request.transaction_id = '12345-67890'
173
+ request.amount = '100.00'
174
+ request.currency = 'EUR'
175
+ # ... Credit Card, Customer and Billing Attributes
176
+
177
+ # Marketplace Data Attributes
178
+ # Required when foreign_retailer_transaction_amount is set
179
+ request.foreign_retailer_indicator = GenesisRuby::Api::Constants::Transactions::Parameters::
180
+ ForeignRetailerIndicators::FOREIGN_RETAILER
181
+ # Optional when foreign_retailer_indicator is set
182
+ # Set in major currency units (like amount); the SDK converts it to minor units with the request currency
183
+ # Must be greater than 0 and less than or equal to amount
184
+ request.foreign_retailer_transaction_amount = '25.50'
185
+ end.execute
186
+
187
+ puts genesis.response.response_object
188
+
189
+ rescue GenesisRuby::Error => error
190
+ puts error.message
191
+ end
192
+ ```
193
+ </details>
194
+
195
+ #### Order
196
+
197
+ Available for the `Authorize`, `Authorize3d`, `Sale` and `Sale3d` card transactions and the Web Payment Form `Create` request.
198
+
199
+ <details>
200
+ <summary>Example Sale with Order ID</summary>
201
+
202
+ ```ruby
203
+ require 'genesis_ruby'
204
+
205
+ begin
206
+ genesis = GenesisRuby::Genesis.for(config: configuration, request: GenesisRuby::Api::Requests::Financial::Cards::Sale) do |request|
207
+ # Common Attributes
208
+ request.transaction_id = '12345-67890'
209
+ request.amount = '100.00'
210
+ request.currency = 'EUR'
211
+
212
+ # ... Credit Card, Customer and Billing Attributes
213
+
214
+ # Order Attributes
215
+ # Merchant order identifier, any string up to 255 characters
216
+ # Groups multiple transactions under a single business order
217
+ # Transaction order IDs must be enabled for the merchant in the Genesis admin
218
+ request.order_id = 'ORD-2024-78456'
219
+ end.execute
220
+
221
+ puts genesis.response.response_object
222
+
223
+ # Returned when the transaction is associated with an order
224
+ puts genesis.response.response_object[:order_id]
225
+ rescue GenesisRuby::Error => error
226
+ puts error.message
227
+ end
228
+ ```
229
+ </details>
230
+
158
231
  ### Smart Router
159
232
 
160
233
  The Smart Routing API is a higher-level abstraction that allows for simpler and more efficient gateway Processing API integration.
@@ -1019,6 +1092,7 @@ GenesisRuby::Api::Requests::Financial::Mobile::RussianMobileSale
1019
1092
 
1020
1093
  ## Wallets
1021
1094
  GenesisRuby::Api::Requests::Financial::Wallets::Alipay
1095
+ GenesisRuby::Api::Requests::Financial::Wallets::EWallet
1022
1096
  GenesisRuby::Api::Requests::Financial::Wallets::PayPal
1023
1097
 
1024
1098
  ## Cash Payments
@@ -1050,6 +1124,8 @@ GenesisRuby::Api::Requests::Financial::Vouchers::Neosurf
1050
1124
  GenesisRuby::Api::Requests::Wpf::Create
1051
1125
  ## WPF Reconcile
1052
1126
  GenesisRuby::Api::Requests::Wpf::Reconcile
1127
+ GenesisRuby::Api::Requests::Wpf::ReconcileByDate
1128
+ GenesisRuby::Api::Requests::Wpf::ReconcileByOrder
1053
1129
 
1054
1130
  # Online Banking Payments
1055
1131
  GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::BancoDoBrasil
@@ -1090,6 +1166,7 @@ GenesisRuby::Api::Requests::Financial::Sdd::Recurring::InitRecurringSale
1090
1166
  GenesisRuby::Api::Requests::Financial::Capture
1091
1167
  GenesisRuby::Api::Requests::Financial::Void
1092
1168
  GenesisRuby::Api::Requests::Financial::Refund
1169
+ GenesisRuby::Api::Requests::Financial::AsyncRefund
1093
1170
  GenesisRuby::Api::Requests::Financial::Sdd::Refund
1094
1171
  GenesisRuby::Api::Requests::Financial::Sdd::Recurring::RecurringSale
1095
1172
  GenesisRuby::Api::Requests::Financial::Cards::Credit
@@ -1101,13 +1178,15 @@ GenesisRuby::Api::Requests::Financial::Payout::GlobalPayout
1101
1178
  ## Reconcile
1102
1179
  GenesisRuby::Api::Requests::NonFinancial::Reconcile::Transaction
1103
1180
  GenesisRuby::Api::Requests::NonFinancial::Reconcile::DateRange
1181
+ GenesisRuby::Api::Requests::NonFinancial::Reconcile::Order
1104
1182
 
1105
1183
  ## Installments
1106
1184
  GenesisRuby::Api::Requests::NonFinancial::Installments::Fetch
1107
1185
 
1108
1186
  ## Billing API
1109
- GenesisRuby::Api::Requests::NonFinancial::BillingApi::Statements
1187
+ GenesisRuby::Api::Requests::NonFinancial::BillingApi::Statement
1110
1188
  GenesisRuby::Api::Requests::NonFinancial::BillingApi::Transactions
1189
+ GenesisRuby::Api::Requests::NonFinancial::BillingApi::EnhancedStatement
1111
1190
 
1112
1191
  ## Managed Recurring API
1113
1192
  GenesisRuby::Api::Requests::NonFinancial::ManagedRecurring::FetchAll
@@ -1152,6 +1231,7 @@ GenesisRuby::Api::Requests::NonFinancial::Kyc::Business::Verification
1152
1231
  GenesisRuby::Api::Requests::NonFinancial::Kyc::ConsumerRegistration::Create
1153
1232
  GenesisRuby::Api::Requests::NonFinancial::Kyc::ConsumerRegistration::Update
1154
1233
  GenesisRuby::Api::Requests::NonFinancial::Kyc::Verifications::AddressByDocumentProof
1234
+ GenesisRuby::Api::Requests::NonFinancial::Kyc::Verifications::BankAccount
1155
1235
  GenesisRuby::Api::Requests::NonFinancial::Kyc::Verifications::Create
1156
1236
  GenesisRuby::Api::Requests::NonFinancial::Kyc::Verifications::Register
1157
1237
  GenesisRuby::Api::Requests::NonFinancial::Kyc::Verifications::RemoteIdentity
@@ -1203,6 +1283,10 @@ GenesisRuby::Api::Requests::NonFinancial::Fraud::Chargeback::DateRange
1203
1283
  GenesisRuby::Api::Requests::NonFinancial::Fraud::Reports::Transaction
1204
1284
  GenesisRuby::Api::Requests::NonFinancial::Fraud::Reports::DateRange
1205
1285
 
1286
+ ## Rapid Dispute Resolution API
1287
+ GenesisRuby::Api::Requests::NonFinancial::Fraud::Rdr::Transaction
1288
+ GenesisRuby::Api::Requests::NonFinancial::Fraud::Rdr::DateRange
1289
+
1206
1290
  ## Fx API
1207
1291
  GenesisRuby::Api::Requests::NonFinancial::Fx::GetTiers
1208
1292
  GenesisRuby::Api::Requests::NonFinancial::Fx::GetTier
@@ -1210,6 +1294,90 @@ GenesisRuby::Api::Requests::NonFinancial::Fx::GetRates
1210
1294
  GenesisRuby::Api::Requests::NonFinancial::Fx::GetRate
1211
1295
  GenesisRuby::Api::Requests::NonFinancial::Fx::SearchRate
1212
1296
 
1297
+ ## APM Services API
1298
+ GenesisRuby::Api::Requests::NonFinancial::Alternatives::Alipay::RegisterMerchant
1299
+
1300
+ ## Payment Authorizations API
1301
+ GenesisRuby::Api::Requests::NonFinancial::PaymentAuthorizations::DateRange
1302
+
1303
+ ```
1304
+
1305
+ ### Billing Statements
1306
+
1307
+ The standard `Statement` request issues the `billingStatements` GraphQL query and the
1308
+ `EnhancedStatement` request issues the `enhancedBillingStatements` query. Both are served
1309
+ from the same `billing_statements` endpoint; the enhanced request additionally exposes the
1310
+ extended `summary` / `details` response tree (`pricingMethod`, detailed fee breakdowns).
1311
+
1312
+ > The `master_account_mid` filter applies server-side only to records created on or after
1313
+ > 2026-08-17.
1314
+
1315
+ ```ruby
1316
+ request = GenesisRuby::Api::Requests::NonFinancial::BillingApi::Statement.new configuration
1317
+
1318
+ # Date-range filters. Each from/to pair must be set together, the `from` value must be on or
1319
+ # before its `to` value, a pair may span at most 7 days, and every boundary accepts either a
1320
+ # date ('YYYY-MM-DD') or a datetime ('YYYY-MM-DD HH:MM:SS') value.
1321
+ request.start_date_from = '2024-01-01'
1322
+ request.start_date_to = '2024-01-05'
1323
+ request.end_date_from = '2024-01-01'
1324
+ request.end_date_to = '2024-01-07 23:59:59'
1325
+
1326
+ # Filter by master account MID (list)
1327
+ request.master_account_mid = %w(111700000000000 124000000000000)
1328
+
1329
+ # Flat and nested response-field selection. The nested structure is rendered exactly as given.
1330
+ # For billingStatements, `summary` is a group of scalar leaves and `details` exposes
1331
+ # `transactionTypesBreakdown`.
1332
+ request.response_fields = [
1333
+ 'billingStatement',
1334
+ 'status',
1335
+ { 'summary' => %w(
1336
+ grossVolume debit credit fees taxes netReserves adjustments
1337
+ netSettlementAmount paymentFxConversionFee paymentAmount paymentCurrency
1338
+ ) },
1339
+ { 'details' => [
1340
+ { 'transactionTypesBreakdown' => %w(category transactionType count amount) }
1341
+ ] }
1342
+ ]
1343
+
1344
+ response = genesis.execute request
1345
+ ```
1346
+
1347
+ The SDK does **not** auto-expand the `summary` and `details` response fields. There is no fixed
1348
+ internal `summary` / `details` tree: the caller supplies the exact nested fields wanted and the
1349
+ SDK renders them as given.
1350
+
1351
+ For the enhanced statement tree, use `EnhancedStatement` and request `pricingMethod` plus the
1352
+ deeper `summary` / `details` sub-selections. In the enhanced schema `summary` groups such as
1353
+ `grossVolume` are objects (`{ count amount }`) and `details` exposes `discountFees`,
1354
+ `transactionFees`, `serviceFees`, `chargebacks`, `miscellaneous`, and `reserves`:
1355
+
1356
+ ```ruby
1357
+ request = GenesisRuby::Api::Requests::NonFinancial::BillingApi::EnhancedStatement.new configuration
1358
+
1359
+ request.start_date_from = '2024-01-01'
1360
+ request.start_date_to = '2024-01-05'
1361
+ request.response_fields = [
1362
+ 'billingStatement',
1363
+ 'pricingMethod',
1364
+ { 'summary' => [
1365
+ { 'grossVolume' => %w(count amount) },
1366
+ 'netSettlementAmount',
1367
+ 'paymentAmount'
1368
+ ] },
1369
+ { 'details' => [
1370
+ { 'discountFees' => [
1371
+ 'subtotalCount',
1372
+ 'subtotalValue',
1373
+ 'subtotalAmount',
1374
+ { 'feesByRegionAndCardType' => [
1375
+ 'category',
1376
+ { 'feesByTransactionType' => %w(transactionType count value amount rate interchange) }
1377
+ ] }
1378
+ ] }
1379
+ ] }
1380
+ ]
1213
1381
  ```
1214
1382
 
1215
1383
  ### Manual initialization
data/VERSION CHANGED
@@ -1 +1 @@
1
- 0.3.2
1
+ 0.4.0
@@ -0,0 +1,26 @@
1
+ # frozen_string_literal: true
2
+
3
+ module GenesisRuby
4
+ module Api
5
+ module Constants
6
+ module NonFinancial
7
+ module Alternatives
8
+ module Alipay
9
+ # Alipay Register Merchant allowed merchant types
10
+ class MerchantTypes
11
+
12
+ extend Mixins::Constants::Common
13
+
14
+ # Sole proprietorship
15
+ INDIVIDUAL = 'INDIVIDUAL'
16
+
17
+ # Enterprise (legal entity)
18
+ ENTERPRISE = 'ENTERPRISE'
19
+
20
+ end
21
+ end
22
+ end
23
+ end
24
+ end
25
+ end
26
+ end
@@ -0,0 +1,26 @@
1
+ # frozen_string_literal: true
2
+
3
+ module GenesisRuby
4
+ module Api
5
+ module Constants
6
+ module NonFinancial
7
+ module Alternatives
8
+ module Alipay
9
+ # Alipay Register Merchant allowed site types
10
+ class SiteTypes
11
+
12
+ extend Mixins::Constants::Common
13
+
14
+ # Website URL
15
+ WEB = 'WEB'
16
+
17
+ # App download URL
18
+ APP = 'APP'
19
+
20
+ end
21
+ end
22
+ end
23
+ end
24
+ end
25
+ end
26
+ end
@@ -0,0 +1,24 @@
1
+ # frozen_string_literal: true
2
+
3
+ module GenesisRuby
4
+ module Api
5
+ module Constants
6
+ module NonFinancial
7
+ module Kyc
8
+ # Bank Account Verification allowed bank account types
9
+ class BankAccountTypes
10
+
11
+ extend Mixins::Constants::Common
12
+
13
+ # Business bank account
14
+ BUSINESS = 'Business'
15
+
16
+ # Personal bank account
17
+ PERSONAL = 'Personal'
18
+
19
+ end
20
+ end
21
+ end
22
+ end
23
+ end
24
+ end
@@ -0,0 +1,24 @@
1
+ # frozen_string_literal: true
2
+
3
+ module GenesisRuby
4
+ module Api
5
+ module Constants
6
+ module Transactions
7
+ module Parameters
8
+ # Marketplace Data foreign retailer indicator allowed values
9
+ #
10
+ # The value is uppercase. Always call `.valid?` with `strict: true`:
11
+ # the non-strict mode downcases the input and never matches `FOREIGN_RETAILER`.
12
+ class ForeignRetailerIndicators
13
+
14
+ extend Mixins::Constants::Common
15
+
16
+ # Foreign retailer transaction
17
+ FOREIGN_RETAILER = 'F'
18
+
19
+ end
20
+ end
21
+ end
22
+ end
23
+ end
24
+ end
@@ -0,0 +1,26 @@
1
+ # frozen_string_literal: true
2
+
3
+ module GenesisRuby
4
+ module Api
5
+ module Constants
6
+ module Transactions
7
+ module Parameters
8
+ module Funding
9
+ # Funding Person Types allowed values
10
+ class PersonTypes
11
+
12
+ extend Api::Mixins::Constants::Common
13
+
14
+ # Natural person (individual)
15
+ NATURAL = 'natural'
16
+
17
+ # Legal person (company or other legal entity)
18
+ LEGAL = 'legal'
19
+
20
+ end
21
+ end
22
+ end
23
+ end
24
+ end
25
+ end
26
+ end
@@ -6,40 +6,67 @@ module GenesisRuby
6
6
  module Transactions
7
7
  module Parameters
8
8
  module MoneyTransfer
9
- # Money Transfer Purpose of Payments
9
+ # Money Transfer Purpose of Payments (Mastercard)
10
10
  class PurposeOfPayments
11
11
 
12
12
  extend Mixins::Constants::Common
13
13
 
14
14
  # Family support
15
- FAMILY_SUPPORT = 'family_support'
15
+ FAMILY_SUPPORT = 'family_support'
16
16
 
17
- # Education
18
- EDUCATION = 'education'
17
+ # Regular labor transfers
18
+ REGULAR_LABOR_TRANSFERS = 'regular_labor_transfers'
19
+
20
+ # Travel and tourism
21
+ TRAVEL_AND_TOURISM = 'travel_and_tourism'
22
+
23
+ # Hospitalization and medical treatment
24
+ HOSPITALIZATION_AND_MEDICAL_TREATMENT = 'hospitalization_and_medical_treatment'
25
+
26
+ # Emergency need
27
+ EMERGENCY_NEED = 'emergency_need'
28
+
29
+ # Savings
30
+ SAVINGS = 'savings'
31
+
32
+ # Gifts
33
+ GIFTS = 'gifts'
19
34
 
20
- # Gift and donation
21
- GIFT_AND_DONATION = 'gift_and_donation'
35
+ # Salary
36
+ SALARY = 'salary'
22
37
 
23
- # Medical treatment
24
- MEDICAL_TREATMENT = 'medical_treatment'
38
+ # Crowd lending
39
+ CROWD_LENDING = 'crowd_lending'
25
40
 
26
- # Maintenance expenses
27
- MAINTENANCE = 'maintenance'
41
+ # Crypto currency
42
+ CRYPTO_CURRENCY = 'crypto_currency'
28
43
 
29
- # Travel
30
- TRAVEL = 'travel'
44
+ # Refund to original card
45
+ REFUND_TO_ORIGINAL_CARD = 'refund_to_original_card'
31
46
 
32
- # Small value remittance
33
- SMALL_VALUE = 'small_value'
47
+ # Refund to new card
48
+ REFUND_TO_NEW_CARD = 'refund_to_new_card'
34
49
 
35
- # Liberalized remittance
36
- LIBERALIZED = 'liberalized'
50
+ # Transfer to another person or organization in the same staged digital wallet (Brazil)
51
+ SAME_DIGITAL_WALLET_TRANSFER_TO_PERSON_ORG = 'same_digital_wallet_transfer_to_person_org'
37
52
 
38
- # Savings/Investments
39
- SAVINGS_INVESTMENTS = 'savings_investments'
53
+ # Boleto payment (Brazil)
54
+ BOLETO_PAYMENT = 'boleto_payment'
55
+
56
+ # High risk securities
57
+ HIGH_RISK_SECURITIES = 'high_risk_securities'
58
+
59
+ # Recycling deposit return
60
+ RECYCLING_DEPOSIT = 'recycling_deposit'
61
+
62
+ # VAT payment
63
+ VAT_PAYMENT = 'vat_payment'
64
+
65
+ # Education
66
+ EDUCATION = 'education'
40
67
 
41
68
  # Other
42
- OTHER = 'other'
69
+ OTHER = 'other'
43
70
 
44
71
  end
45
72
  end
@@ -11,35 +11,32 @@ module GenesisRuby
11
11
 
12
12
  extend Mixins::Constants::Common
13
13
 
14
- # International Bank Account Number
15
- IBAN = 'iban'
14
+ # RTN and bank account number
15
+ RTN_AND_BANK_ACCOUNT_NUMBER = 'rtn_and_bank_account_number'
16
16
 
17
- # Credit/Debit card account number
18
- CREDIT_DEBIT_CARD = 'credit_debit_card'
17
+ # International Bank Account Number
18
+ IBAN = 'iban'
19
19
 
20
- # Savings/Checking/Investment account number
21
- SAVINGS_CHECKING_INVESTMENT = 'savings_checking_investment'
20
+ # Card account
21
+ CARD_ACCOUNT = 'card_account'
22
22
 
23
- # Social Networking ID
24
- SOCIAL_NETWORKING_ID = 'social_networking_id'
23
+ # Email
24
+ EMAIL = 'email'
25
25
 
26
26
  # Phone number
27
- PHONE_NUMBER = 'phone_number'
27
+ PHONE_NUMBER = 'phone_number'
28
28
 
29
29
  # Bank account number and Bank Identification Code
30
- BANK_ACCOUNT_NUMBER_AND_BIC = 'bank_account_number_and_bic'
30
+ BANK_ACCOUNT_NUMBER_AND_BIC = 'bank_account_number_and_bic'
31
31
 
32
32
  # Wallet ID
33
- WALLET_ID = 'wallet_id'
34
-
35
- # Unique transaction reference
36
- UNIQUE_TRANSACTION_REFERENCE = 'unique_transaction_reference'
33
+ WALLET_ID = 'wallet_id'
37
34
 
38
- # National ID
39
- NATIONAL_ID = 'national_id'
35
+ # Social network ID
36
+ SOCIAL_NETWORK_ID = 'social_network_id'
40
37
 
41
38
  # Other
42
- OTHER = 'other'
39
+ OTHER = 'other'
43
40
 
44
41
  end
45
42
  end
@@ -11,29 +11,20 @@ module GenesisRuby
11
11
 
12
12
  extend Mixins::Constants::Common
13
13
 
14
- # Current account
15
- CURRENT_ACCOUNT = 'current_account'
14
+ # Credit
15
+ CREDIT = 'credit'
16
16
 
17
- # Credit card
18
- CREDIT_CARD = 'credit_card'
19
-
20
- # Savings account
21
- SAVINGS_ACCOUNT = 'savings_account'
22
-
23
- # Deposit account
24
- DEPOSIT_ACCOUNT = 'deposit_account'
25
-
26
- # Cash
27
- CASH = 'cash'
17
+ # Debit
18
+ DEBIT = 'debit'
28
19
 
29
20
  # Prepaid
30
- PREPAID = 'prepaid'
21
+ PREPAID = 'prepaid'
31
22
 
32
- # Other debit account
33
- OTHER_DEBIT_ACCOUNT = 'other_debit_account'
23
+ # Cash
24
+ CASH = 'cash'
34
25
 
35
- # Other credit account
36
- OTHER_CREDIT_ACCOUNT = 'other_credit_account'
26
+ # Deposit account
27
+ DEPOSIT_ACCOUNT = 'deposit_account'
37
28
 
38
29
  end
39
30
  end
@@ -11,11 +11,38 @@ module GenesisRuby
11
11
 
12
12
  extend Mixins::Constants::Common
13
13
 
14
- # Visa money transfer type
15
- VISA = 'visa'
14
+ # Account to account transfer
15
+ ACCOUNT_TO_ACCOUNT = 'account_to_account'
16
16
 
17
- # Mastercard money transfer type
18
- MASTERCARD = 'mastercard'
17
+ # Person to person transfer
18
+ PERSON_TO_PERSON = 'person_to_person'
19
+
20
+ # Wallet transfer
21
+ WALLET_TRANSFER = 'wallet_transfer'
22
+
23
+ # Funds transfer
24
+ FUNDS_TRANSFER = 'funds_transfer'
25
+
26
+ # Liquid assets
27
+ LIQUID_ASSETS = 'liquid_assets'
28
+
29
+ # Merchant settlement
30
+ MERCHANT_SETTLEMENT = 'merchant_settlement'
31
+
32
+ # Own account
33
+ OWN_ACCOUNT = 'own_account'
34
+
35
+ # Own credit card bill
36
+ OWN_CREDIT_CARD_BILL = 'own_credit_card_bill'
37
+
38
+ # Business disbursement
39
+ BUSINESS_DISBURSEMENT = 'business_disbursement'
40
+
41
+ # Government or non-profit disbursement
42
+ GOVERNMENT_OR_NON_PROFIT_DISBURSEMENT = 'government_or_non_profit_disbursement'
43
+
44
+ # General business to business
45
+ GENERAL_BUSINESS_TO_BUSINESS = 'general_business_to_business'
19
46
 
20
47
  end
21
48
  end