payabli 2.2.22 → 2.2.25

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 (48) hide show
  1. checksums.yaml +4 -4
  2. data/.fern/metadata.json +6 -5
  3. data/.fernignore +1 -2
  4. data/.rubocop.yml +1 -1
  5. data/CONTRIBUTING.md +33 -0
  6. data/README.md +5 -5
  7. data/lib/payabli/client.rb +6 -1
  8. data/lib/payabli/cloud/client.rb +3 -0
  9. data/lib/payabli/internal/http/base_request.rb +14 -0
  10. data/lib/payabli/internal/http/raw_client.rb +21 -3
  11. data/lib/payabli/internal/json/request.rb +6 -4
  12. data/lib/payabli/internal/multipart/multipart_request.rb +6 -4
  13. data/lib/payabli/internal/types/boolean.rb +1 -1
  14. data/lib/payabli/internal/types/utils.rb +2 -2
  15. data/lib/payabli/management/client.rb +61 -0
  16. data/lib/payabli/management/types/bank_account_verification_details_response.rb +24 -0
  17. data/lib/payabli/management/types/verify_account_details_request.rb +17 -0
  18. data/lib/payabli/management/types/verify_account_details_response.rb +14 -0
  19. data/lib/payabli/money_in/client.rb +3 -1
  20. data/lib/payabli/money_in/types/transaction_detail_payment_data.rb +1 -1
  21. data/lib/payabli/money_out/client.rb +5 -3
  22. data/lib/payabli/money_out_types/types/authorize_payout_body.rb +1 -0
  23. data/lib/payabli/query/client.rb +100 -0
  24. data/lib/payabli/query/types/list_devices_org_request.rb +16 -0
  25. data/lib/payabli/query/types/list_devices_request.rb +16 -0
  26. data/lib/payabli/query_types/types/device_query_record.rb +34 -0
  27. data/lib/payabli/query_types/types/query_device_response.rb +13 -0
  28. data/lib/payabli/types/auto_capture.rb +23 -0
  29. data/lib/payabli/types/notification_content_event_type.rb +0 -1
  30. data/lib/payabli/types/notification_standard_request_content_event_type.rb +0 -1
  31. data/lib/payabli/types/processing_section.rb +5 -0
  32. data/lib/payabli/types/template_element.rb +1 -0
  33. data/lib/payabli/types/v_card_card_type.rb +23 -0
  34. data/lib/payabli/types/v_card_record.rb +1 -0
  35. data/lib/payabli/types/vendor_data.rb +2 -0
  36. data/lib/payabli/types/vendor_query_record.rb +7 -0
  37. data/lib/payabli/vendor/client.rb +39 -1
  38. data/lib/payabli/vendor/types/vendor_enrich_request.rb +18 -0
  39. data/lib/payabli/vendor/types/vendor_enrich_response.rb +17 -0
  40. data/lib/payabli/vendor/types/vendor_enrich_response_data.rb +16 -0
  41. data/lib/payabli/vendor/types/vendor_enrichment_data.rb +13 -0
  42. data/lib/payabli/vendor/types/vendor_enrichment_invoice_scan.rb +26 -0
  43. data/lib/payabli/vendor/types/vendor_enrichment_web_search.rb +26 -0
  44. data/lib/payabli/version.rb +1 -1
  45. data/lib/payabli.rb +16 -0
  46. data/reference.md +686 -75
  47. data/wiremock/wiremock-mappings.json +8569 -1
  48. metadata +25 -3
data/reference.md CHANGED
@@ -2565,6 +2565,8 @@ client.cloud.history_device(
2565
2565
  <dl>
2566
2566
  <dd>
2567
2567
 
2568
+ Use [List devices by paypoint](/developers/api-reference/cloud/get-list-of-devices-for-a-paypoint) instead, which supports filters, sorting, and pagination.
2569
+
2568
2570
  Get a list of cloud devices registered to an entrypoint.
2569
2571
  </dd>
2570
2572
  </dl>
@@ -10256,6 +10258,129 @@ client.line_item.update_item(
10256
10258
  </dl>
10257
10259
 
10258
10260
 
10261
+ </dd>
10262
+ </dl>
10263
+ </details>
10264
+
10265
+ ## Management
10266
+ <details><summary><code>client.management.<a href="/lib/payabli/management/client.rb">verify_account_details</a>(entry, request) -> Payabli::Management::Types::VerifyAccountDetailsResponse</code></summary>
10267
+ <dl>
10268
+ <dd>
10269
+
10270
+ #### 📝 Description
10271
+
10272
+ <dl>
10273
+ <dd>
10274
+
10275
+ <dl>
10276
+ <dd>
10277
+
10278
+ Verifies a bank account and returns detailed verification results from the verification network, including bank name, account status, and response codes. Unlike a pass/fail verification, this endpoint returns granular data to support decision-making and troubleshooting.
10279
+
10280
+ When bank authentication is enabled for the paypoint's organization, the endpoint performs an identity verification check on the account holder. Otherwise, it performs an account existence check. When bank authentication is enabled, the `accountHolderType` and `holderName` fields are required.
10281
+
10282
+ Requires `inboundpayments_create` or `outboundpayments_create` permission.
10283
+ </dd>
10284
+ </dl>
10285
+ </dd>
10286
+ </dl>
10287
+
10288
+ #### 🔌 Usage
10289
+
10290
+ <dl>
10291
+ <dd>
10292
+
10293
+ <dl>
10294
+ <dd>
10295
+
10296
+ ```ruby
10297
+ client.management.verify_account_details(
10298
+ entry: "entry752",
10299
+ routing_number: "122105278",
10300
+ account_number: "0000000016",
10301
+ account_type: "Checking",
10302
+ country: "US",
10303
+ account_holder_type: "personal",
10304
+ holder_name: "Jane Doe"
10305
+ )
10306
+ ```
10307
+ </dd>
10308
+ </dl>
10309
+ </dd>
10310
+ </dl>
10311
+
10312
+ #### ⚙️ Parameters
10313
+
10314
+ <dl>
10315
+ <dd>
10316
+
10317
+ <dl>
10318
+ <dd>
10319
+
10320
+ **entry:** `String` — The paypoint's entry name identifier.
10321
+
10322
+ </dd>
10323
+ </dl>
10324
+
10325
+ <dl>
10326
+ <dd>
10327
+
10328
+ **routing_number:** `String` — The bank routing number to verify.
10329
+
10330
+ </dd>
10331
+ </dl>
10332
+
10333
+ <dl>
10334
+ <dd>
10335
+
10336
+ **account_number:** `String` — The bank account number to verify.
10337
+
10338
+ </dd>
10339
+ </dl>
10340
+
10341
+ <dl>
10342
+ <dd>
10343
+
10344
+ **account_type:** `String` — The type of bank account, such as `Checking` or `Savings`.
10345
+
10346
+ </dd>
10347
+ </dl>
10348
+
10349
+ <dl>
10350
+ <dd>
10351
+
10352
+ **country:** `String` — The ISO country code for the bank account, such as `US`.
10353
+
10354
+ </dd>
10355
+ </dl>
10356
+
10357
+ <dl>
10358
+ <dd>
10359
+
10360
+ **account_holder_type:** `String` — The type of account holder. Accepted values are `personal` or `business`. Required when bank authentication is enabled for the paypoint's organization.
10361
+
10362
+ </dd>
10363
+ </dl>
10364
+
10365
+ <dl>
10366
+ <dd>
10367
+
10368
+ **holder_name:** `String` — The name of the bank account holder. For personal accounts, provide the holder's full name (for example, `Jane Doe`); the value is split on the first space into first and last name. For business accounts, provide the legal business name. Required when bank authentication is enabled for the paypoint's organization.
10369
+
10370
+ </dd>
10371
+ </dl>
10372
+
10373
+ <dl>
10374
+ <dd>
10375
+
10376
+ **request_options:** `Payabli::Management::RequestOptions`
10377
+
10378
+ </dd>
10379
+ </dl>
10380
+ </dd>
10381
+ </dl>
10382
+
10383
+
10259
10384
  </dd>
10260
10385
  </dl>
10261
10386
  </details>
@@ -10883,7 +11008,7 @@ client.money_in.getpaid(
10883
11008
  <dl>
10884
11009
  <dd>
10885
11010
 
10886
- A reversal either refunds or voids a transaction independent of the transaction's settlement status. Send a reversal request for a transaction, and Payabli automatically determines whether it's a refund or void. You don't need to know whether the transaction is settled or not.
11011
+ A reversal either refunds or voids a transaction independent of the transaction's settlement status. Send a reversal request for a transaction, and Payabli automatically determines whether it's a refund or void. You don't need to know whether the transaction is settled or not. This endpoint only works on transactions made with the v1 API. For v2 transactions, check the transaction's settlement status and call v2 void or v2 refund based on the result.
10887
11012
  </dd>
10888
11013
  </dl>
10889
11014
  </dd>
@@ -11998,7 +12123,7 @@ client.money_in.voidv_2(trans_id: "10-3ffa27df-b171-44e0-b251-e95fbfc7a723")
11998
12123
  <dl>
11999
12124
  <dd>
12000
12125
 
12001
- Authorizes transaction for payout. Authorized transactions aren't flagged for settlement until captured. Use `referenceId` returned in the response to capture the transaction.
12126
+ Authorizes transaction for payout. If you don't pass the `autoCapture` field with a value of `true`, authorized transactions aren't flagged for settlement until captured. Use `referenceId` returned in the response to capture the transaction.
12002
12127
  </dd>
12003
12128
  </dl>
12004
12129
  </dd>
@@ -12028,7 +12153,8 @@ client.money_out.authorize_out(
12028
12153
  },
12029
12154
  invoice_data: [{
12030
12155
  bill_id: 54323
12031
- }]
12156
+ }],
12157
+ auto_capture: true
12032
12158
  )
12033
12159
  ```
12034
12160
  </dd>
@@ -12364,7 +12490,7 @@ client.money_out.capture_all_out(body: %w[2-29 2-28 2-27])
12364
12490
  <dl>
12365
12491
  <dd>
12366
12492
 
12367
- Captures a single authorized payout transaction by ID.
12493
+ Captures a single authorized payout transaction by ID. If the transaction was authorized with `autoCapture` set to `true`, you don't need to call this endpoint to capture the transaction for processing.
12368
12494
  </dd>
12369
12495
  </dl>
12370
12496
  </dd>
@@ -18678,7 +18804,7 @@ See [Filters and Conditions Reference](/developers/developer-guides/pay-ops-repo
18678
18804
  </dl>
18679
18805
  </details>
18680
18806
 
18681
- <details><summary><code>client.query.<a href="/lib/payabli/query/client.rb">list_notification_reports</a>(entry) -> Payabli::Types::QueryResponseNotificationReports</code></summary>
18807
+ <details><summary><code>client.query.<a href="/lib/payabli/query/client.rb">list_devices</a>(entry) -> Payabli::QueryTypes::Types::QueryDeviceResponse</code></summary>
18682
18808
  <dl>
18683
18809
  <dd>
18684
18810
 
@@ -18690,7 +18816,7 @@ See [Filters and Conditions Reference](/developers/developer-guides/pay-ops-repo
18690
18816
  <dl>
18691
18817
  <dd>
18692
18818
 
18693
- Returns a list of all reports generated in the last 60 days for a single entrypoint. Use filters to limit results.
18819
+ Returns a list of cloud devices for a single paypoint. Use filters to limit results. Include the `exportFormat` query parameter to return the results as a file instead of a JSON response.
18694
18820
  </dd>
18695
18821
  </dl>
18696
18822
  </dd>
@@ -18705,11 +18831,11 @@ Returns a list of all reports generated in the last 60 days for a single entrypo
18705
18831
  <dd>
18706
18832
 
18707
18833
  ```ruby
18708
- client.query.list_notification_reports(
18834
+ client.query.list_devices(
18709
18835
  entry: "8cfec329267",
18710
- from_record: 251,
18711
- limit_record: 0,
18712
- sort_by: "desc(field_name)"
18836
+ from_record: 0,
18837
+ limit_record: 20,
18838
+ sort_by: "desc(createdAt)"
18713
18839
  )
18714
18840
  ```
18715
18841
  </dd>
@@ -18733,6 +18859,14 @@ client.query.list_notification_reports(
18733
18859
  <dl>
18734
18860
  <dd>
18735
18861
 
18862
+ **export_format:** `Payabli::Types::ExportFormat`
18863
+
18864
+ </dd>
18865
+ </dl>
18866
+
18867
+ <dl>
18868
+ <dd>
18869
+
18736
18870
  **from_record:** `Integer` — The number of records to skip before starting to collect the result set.
18737
18871
 
18738
18872
  </dd>
@@ -18751,7 +18885,10 @@ client.query.list_notification_reports(
18751
18885
 
18752
18886
  **parameters:** `Internal::Types::Hash[String, String]`
18753
18887
 
18754
- Collection of field names, conditions, and values used to filter the query
18888
+
18889
+ Collection of field names, conditions, and values used to filter
18890
+ the query.
18891
+
18755
18892
  <Info>
18756
18893
  **You must remove `parameters=` from the request before you send it, otherwise Payabli will ignore the filters.**
18757
18894
 
@@ -18759,36 +18896,88 @@ Collection of field names, conditions, and values used to filter the query
18759
18896
 
18760
18897
  For example:
18761
18898
 
18762
- --url https://api-sandbox.payabli.com/api/Query/transactions/org/236?parameters=totalAmount(gt)=1000&limitRecord=20
18899
+ --url https://api-sandbox.payabli.com/api/Query/devices/8cfec329267?parameters=status=1&limitRecord=20
18763
18900
 
18764
18901
  should become:
18765
18902
 
18766
- --url https://api-sandbox.payabli.com/api/Query/transactions/org/236?totalAmount(gt)=1000&limitRecord=20
18903
+ --url https://api-sandbox.payabli.com/api/Query/devices/8cfec329267?status=1&limitRecord=20
18767
18904
  </Info>
18768
18905
 
18769
- See [Filters and Conditions Reference](/developers/developer-guides/pay-ops-reporting-engine-overview#filters-and-conditions-reference) for help.
18906
+ See [Filters and Conditions
18907
+ Reference](/developers/developer-guides/pay-ops-reporting-engine-overview#filters-and-conditions-reference)
18908
+ for more information.
18770
18909
 
18771
- List of field names accepted:
18772
- - `reportName` (ct, nct, eq, ne)
18773
- - `createdAt` (gt, ge, lt, le, eq, ne)
18910
+ **List of field names accepted:**
18774
18911
 
18775
- List of comparison accepted - enclosed between parentheses:
18776
- - eq or empty => equal
18777
- - gt => greater than
18778
- - ge => greater or equal
18779
- - lt => less than
18780
- - le => less or equal
18781
- - ne => not equal
18782
- - ct => contains
18783
- - nct => not contains
18784
- - in => inside array
18785
- - nin => not inside array
18786
18912
 
18787
- List of parameters accepted:
18788
- - limitRecord : max number of records for query (default="20", "0" or negative value for all)
18789
- - fromRecord : initial record in query
18913
+ - `deviceId` (eq, ne, ct, nct)
18790
18914
 
18791
- Example: reportName(ct)=tr return all records containing the string "tr"
18915
+ - `serialNumber` (eq, ne, ct, nct)
18916
+
18917
+ - `friendlyName` (eq, ne, ct, nct)
18918
+
18919
+ - `description` (eq, ne, ct, nct)
18920
+
18921
+ - `model` (eq, ne, ct, nct)
18922
+
18923
+ - `make` (eq, ne, ct, nct)
18924
+
18925
+ - `macAddress` (eq, ne, ct, nct)
18926
+
18927
+ - `registrationCode` (eq, ne, ct, nct)
18928
+
18929
+ - `status` (eq, ne, in, nin)
18930
+
18931
+ - `deviceType` (eq, ne, in, nin)
18932
+
18933
+ - `deviceOs` (eq, ne, in, nin)
18934
+
18935
+ - `activationAttempts` (eq, ne, gt, ge, lt, le)
18936
+
18937
+ - `createdDate` (gt, ge, lt, le, eq, ne)
18938
+
18939
+ - `updatedDate` (gt, ge, lt, le, eq, ne)
18940
+
18941
+ - `lastHealthCheck` (gt, ge, lt, le, eq, ne)
18942
+
18943
+ - `activationExpiry` (gt, ge, lt, le, eq, ne). This filter corresponds to the `activationCodeExpiry` response field.
18944
+
18945
+ - `paypointId` (eq, ne)
18946
+
18947
+ - `paypointDba` (eq, ne, ct, nct)
18948
+
18949
+ - `paypointLegal` (eq, ne, ct, nct)
18950
+
18951
+ - `paypointEntry` (eq, ne, ct, nct)
18952
+
18953
+ - `externalPaypointId` (eq, ne, ct, nct)
18954
+
18955
+ - `parentOrgId` (eq, ne)
18956
+
18957
+ - `parentOrgName` (eq, ne, ct, nct)
18958
+
18959
+
18960
+ **List of comparison operators accepted:**
18961
+
18962
+ - `eq` or empty => equal
18963
+
18964
+ - `gt` => greater than
18965
+
18966
+ - `ge` => greater or equal
18967
+
18968
+ - `lt` => less than
18969
+
18970
+ - `le` => less or equal
18971
+
18972
+ - `ne` => not equal
18973
+
18974
+ - `ct` => contains
18975
+
18976
+ - `nct` => not contains
18977
+
18978
+ - `in` => inside array
18979
+
18980
+ - `nin` => not inside array
18792
18981
 
18793
18982
  </dd>
18794
18983
  </dl>
@@ -18816,7 +19005,7 @@ Example: reportName(ct)=tr return all records containing the string "tr"
18816
19005
  </dl>
18817
19006
  </details>
18818
19007
 
18819
- <details><summary><code>client.query.<a href="/lib/payabli/query/client.rb">list_notification_reports_org</a>(org_id) -> Payabli::Types::QueryResponseNotificationReports</code></summary>
19008
+ <details><summary><code>client.query.<a href="/lib/payabli/query/client.rb">list_devices_org</a>(org_id) -> Payabli::QueryTypes::Types::QueryDeviceResponse</code></summary>
18820
19009
  <dl>
18821
19010
  <dd>
18822
19011
 
@@ -18828,7 +19017,7 @@ Example: reportName(ct)=tr return all records containing the string "tr"
18828
19017
  <dl>
18829
19018
  <dd>
18830
19019
 
18831
- Returns a list of all reports generated in the last 60 days for an organization. Use filters to limit results.
19020
+ Returns a list of cloud devices for a single organization. Use filters to limit results. Include the `exportFormat` query parameter to return the results as a file instead of a JSON response.
18832
19021
  </dd>
18833
19022
  </dl>
18834
19023
  </dd>
@@ -18843,11 +19032,11 @@ Returns a list of all reports generated in the last 60 days for an organization.
18843
19032
  <dd>
18844
19033
 
18845
19034
  ```ruby
18846
- client.query.list_notification_reports_org(
18847
- org_id: 123,
18848
- from_record: 251,
18849
- limit_record: 0,
18850
- sort_by: "desc(field_name)"
19035
+ client.query.list_devices_org(
19036
+ org_id: 100,
19037
+ from_record: 0,
19038
+ limit_record: 20,
19039
+ sort_by: "desc(createdAt)"
18851
19040
  )
18852
19041
  ```
18853
19042
  </dd>
@@ -18871,6 +19060,14 @@ client.query.list_notification_reports_org(
18871
19060
  <dl>
18872
19061
  <dd>
18873
19062
 
19063
+ **export_format:** `Payabli::Types::ExportFormat`
19064
+
19065
+ </dd>
19066
+ </dl>
19067
+
19068
+ <dl>
19069
+ <dd>
19070
+
18874
19071
  **from_record:** `Integer` — The number of records to skip before starting to collect the result set.
18875
19072
 
18876
19073
  </dd>
@@ -18889,59 +19086,390 @@ client.query.list_notification_reports_org(
18889
19086
 
18890
19087
  **parameters:** `Internal::Types::Hash[String, String]`
18891
19088
 
18892
- Collection of field names, conditions, and values used to filter the query <Info>
19089
+
19090
+ Collection of field names, conditions, and values used to filter
19091
+ the query.
19092
+
19093
+ <Info>
18893
19094
  **You must remove `parameters=` from the request before you send it, otherwise Payabli will ignore the filters.**
18894
19095
 
18895
19096
  Because of a technical limitation, you can't make a request that includes filters from the API console on this page. The response won't be filtered. Instead, copy the request, remove `parameters=` and run the request in a different client.
18896
19097
 
18897
19098
  For example:
18898
19099
 
18899
- --url https://api-sandbox.payabli.com/api/Query/transactions/org/236?parameters=totalAmount(gt)=1000&limitRecord=20
19100
+ --url https://api-sandbox.payabli.com/api/Query/devices/org/236?parameters=status=1&limitRecord=20
18900
19101
 
18901
19102
  should become:
18902
19103
 
18903
- --url https://api-sandbox.payabli.com/api/Query/transactions/org/236?totalAmount(gt)=1000&limitRecord=20
19104
+ --url https://api-sandbox.payabli.com/api/Query/devices/org/236?status=1&limitRecord=20
18904
19105
  </Info>
18905
- See [Filters and Conditions Reference](/developers/developer-guides/pay-ops-reporting-engine-overview#filters-and-conditions-reference) for help.
18906
19106
 
18907
- List of field names accepted:
18908
- - `reportName` (ct, nct, eq, ne)
18909
- - `createdAt` (gt, ge, lt, le, eq, ne)
19107
+ See [Filters and Conditions
19108
+ Reference](/developers/developer-guides/pay-ops-reporting-engine-overview#filters-and-conditions-reference)
19109
+ for more information.
18910
19110
 
18911
- List of comparison accepted - enclosed between parentheses:
18912
- - eq or empty => equal
18913
- - gt => greater than
18914
- - ge => greater or equal
18915
- - lt => less than
18916
- - le => less or equal
18917
- - ne => not equal
18918
- - ct => contains
18919
- - nct => not contains
18920
- - in => inside array
18921
- - nin => not inside array
19111
+ **List of field names accepted:**
18922
19112
 
18923
- List of parameters accepted:
18924
- - limitRecord : max number of records for query (default="20", "0" or negative value for all)
18925
- - fromRecord : initial record in query
18926
19113
 
18927
- Example: reportName(ct)=tr return all records containing the string "tr"
18928
-
18929
- </dd>
18930
- </dl>
19114
+ - `deviceId` (eq, ne, ct, nct)
18931
19115
 
18932
- <dl>
18933
- <dd>
19116
+ - `serialNumber` (eq, ne, ct, nct)
18934
19117
 
18935
- **sort_by:** `String` — The field name to use for sorting results. Use `desc(field_name)` to sort descending by `field_name`, and use `asc(field_name)` to sort ascending by `field_name`.
18936
-
18937
- </dd>
18938
- </dl>
19118
+ - `friendlyName` (eq, ne, ct, nct)
18939
19119
 
18940
- <dl>
18941
- <dd>
19120
+ - `description` (eq, ne, ct, nct)
18942
19121
 
18943
- **request_options:** `Payabli::Query::RequestOptions`
18944
-
19122
+ - `model` (eq, ne, ct, nct)
19123
+
19124
+ - `make` (eq, ne, ct, nct)
19125
+
19126
+ - `macAddress` (eq, ne, ct, nct)
19127
+
19128
+ - `registrationCode` (eq, ne, ct, nct)
19129
+
19130
+ - `status` (eq, ne, in, nin)
19131
+
19132
+ - `deviceType` (eq, ne, in, nin)
19133
+
19134
+ - `deviceOs` (eq, ne, in, nin)
19135
+
19136
+ - `activationAttempts` (eq, ne, gt, ge, lt, le)
19137
+
19138
+ - `createdDate` (gt, ge, lt, le, eq, ne)
19139
+
19140
+ - `updatedDate` (gt, ge, lt, le, eq, ne)
19141
+
19142
+ - `lastHealthCheck` (gt, ge, lt, le, eq, ne)
19143
+
19144
+ - `activationExpiry` (gt, ge, lt, le, eq, ne). This filter corresponds to the `activationCodeExpiry` response field.
19145
+
19146
+ - `paypointId` (eq, ne)
19147
+
19148
+ - `paypointDba` (eq, ne, ct, nct)
19149
+
19150
+ - `paypointLegal` (eq, ne, ct, nct)
19151
+
19152
+ - `paypointEntry` (eq, ne, ct, nct)
19153
+
19154
+ - `externalPaypointId` (eq, ne, ct, nct)
19155
+
19156
+ - `parentOrgId` (eq, ne)
19157
+
19158
+ - `parentOrgName` (eq, ne, ct, nct)
19159
+
19160
+
19161
+ **List of comparison operators accepted:**
19162
+
19163
+ - `eq` or empty => equal
19164
+
19165
+ - `gt` => greater than
19166
+
19167
+ - `ge` => greater or equal
19168
+
19169
+ - `lt` => less than
19170
+
19171
+ - `le` => less or equal
19172
+
19173
+ - `ne` => not equal
19174
+
19175
+ - `ct` => contains
19176
+
19177
+ - `nct` => not contains
19178
+
19179
+ - `in` => inside array
19180
+
19181
+ - `nin` => not inside array
19182
+
19183
+ </dd>
19184
+ </dl>
19185
+
19186
+ <dl>
19187
+ <dd>
19188
+
19189
+ **sort_by:** `String` — The field name to use for sorting results. Use `desc(field_name)` to sort descending by `field_name`, and use `asc(field_name)` to sort ascending by `field_name`.
19190
+
19191
+ </dd>
19192
+ </dl>
19193
+
19194
+ <dl>
19195
+ <dd>
19196
+
19197
+ **request_options:** `Payabli::Query::RequestOptions`
19198
+
19199
+ </dd>
19200
+ </dl>
19201
+ </dd>
19202
+ </dl>
19203
+
19204
+
19205
+ </dd>
19206
+ </dl>
19207
+ </details>
19208
+
19209
+ <details><summary><code>client.query.<a href="/lib/payabli/query/client.rb">list_notification_reports</a>(entry) -> Payabli::Types::QueryResponseNotificationReports</code></summary>
19210
+ <dl>
19211
+ <dd>
19212
+
19213
+ #### 📝 Description
19214
+
19215
+ <dl>
19216
+ <dd>
19217
+
19218
+ <dl>
19219
+ <dd>
19220
+
19221
+ Returns a list of all reports generated in the last 60 days for a single entrypoint. Use filters to limit results.
19222
+ </dd>
19223
+ </dl>
19224
+ </dd>
19225
+ </dl>
19226
+
19227
+ #### 🔌 Usage
19228
+
19229
+ <dl>
19230
+ <dd>
19231
+
19232
+ <dl>
19233
+ <dd>
19234
+
19235
+ ```ruby
19236
+ client.query.list_notification_reports(
19237
+ entry: "8cfec329267",
19238
+ from_record: 251,
19239
+ limit_record: 0,
19240
+ sort_by: "desc(field_name)"
19241
+ )
19242
+ ```
19243
+ </dd>
19244
+ </dl>
19245
+ </dd>
19246
+ </dl>
19247
+
19248
+ #### ⚙️ Parameters
19249
+
19250
+ <dl>
19251
+ <dd>
19252
+
19253
+ <dl>
19254
+ <dd>
19255
+
19256
+ **entry:** `String`
19257
+
19258
+ </dd>
19259
+ </dl>
19260
+
19261
+ <dl>
19262
+ <dd>
19263
+
19264
+ **from_record:** `Integer` — The number of records to skip before starting to collect the result set.
19265
+
19266
+ </dd>
19267
+ </dl>
19268
+
19269
+ <dl>
19270
+ <dd>
19271
+
19272
+ **limit_record:** `Integer` — Max number of records to return for the query. Use `0` or negative value to return all records.
19273
+
19274
+ </dd>
19275
+ </dl>
19276
+
19277
+ <dl>
19278
+ <dd>
19279
+
19280
+ **parameters:** `Internal::Types::Hash[String, String]`
19281
+
19282
+ Collection of field names, conditions, and values used to filter the query
19283
+ <Info>
19284
+ **You must remove `parameters=` from the request before you send it, otherwise Payabli will ignore the filters.**
19285
+
19286
+ Because of a technical limitation, you can't make a request that includes filters from the API console on this page. The response won't be filtered. Instead, copy the request, remove `parameters=` and run the request in a different client.
19287
+
19288
+ For example:
19289
+
19290
+ --url https://api-sandbox.payabli.com/api/Query/transactions/org/236?parameters=totalAmount(gt)=1000&limitRecord=20
19291
+
19292
+ should become:
19293
+
19294
+ --url https://api-sandbox.payabli.com/api/Query/transactions/org/236?totalAmount(gt)=1000&limitRecord=20
19295
+ </Info>
19296
+
19297
+ See [Filters and Conditions Reference](/developers/developer-guides/pay-ops-reporting-engine-overview#filters-and-conditions-reference) for help.
19298
+
19299
+ List of field names accepted:
19300
+ - `reportName` (ct, nct, eq, ne)
19301
+ - `createdAt` (gt, ge, lt, le, eq, ne)
19302
+
19303
+ List of comparison accepted - enclosed between parentheses:
19304
+ - eq or empty => equal
19305
+ - gt => greater than
19306
+ - ge => greater or equal
19307
+ - lt => less than
19308
+ - le => less or equal
19309
+ - ne => not equal
19310
+ - ct => contains
19311
+ - nct => not contains
19312
+ - in => inside array
19313
+ - nin => not inside array
19314
+
19315
+ List of parameters accepted:
19316
+ - limitRecord : max number of records for query (default="20", "0" or negative value for all)
19317
+ - fromRecord : initial record in query
19318
+
19319
+ Example: reportName(ct)=tr return all records containing the string "tr"
19320
+
19321
+ </dd>
19322
+ </dl>
19323
+
19324
+ <dl>
19325
+ <dd>
19326
+
19327
+ **sort_by:** `String` — The field name to use for sorting results. Use `desc(field_name)` to sort descending by `field_name`, and use `asc(field_name)` to sort ascending by `field_name`.
19328
+
19329
+ </dd>
19330
+ </dl>
19331
+
19332
+ <dl>
19333
+ <dd>
19334
+
19335
+ **request_options:** `Payabli::Query::RequestOptions`
19336
+
19337
+ </dd>
19338
+ </dl>
19339
+ </dd>
19340
+ </dl>
19341
+
19342
+
19343
+ </dd>
19344
+ </dl>
19345
+ </details>
19346
+
19347
+ <details><summary><code>client.query.<a href="/lib/payabli/query/client.rb">list_notification_reports_org</a>(org_id) -> Payabli::Types::QueryResponseNotificationReports</code></summary>
19348
+ <dl>
19349
+ <dd>
19350
+
19351
+ #### 📝 Description
19352
+
19353
+ <dl>
19354
+ <dd>
19355
+
19356
+ <dl>
19357
+ <dd>
19358
+
19359
+ Returns a list of all reports generated in the last 60 days for an organization. Use filters to limit results.
19360
+ </dd>
19361
+ </dl>
19362
+ </dd>
19363
+ </dl>
19364
+
19365
+ #### 🔌 Usage
19366
+
19367
+ <dl>
19368
+ <dd>
19369
+
19370
+ <dl>
19371
+ <dd>
19372
+
19373
+ ```ruby
19374
+ client.query.list_notification_reports_org(
19375
+ org_id: 123,
19376
+ from_record: 251,
19377
+ limit_record: 0,
19378
+ sort_by: "desc(field_name)"
19379
+ )
19380
+ ```
19381
+ </dd>
19382
+ </dl>
19383
+ </dd>
19384
+ </dl>
19385
+
19386
+ #### ⚙️ Parameters
19387
+
19388
+ <dl>
19389
+ <dd>
19390
+
19391
+ <dl>
19392
+ <dd>
19393
+
19394
+ **org_id:** `Integer` — The numeric identifier for organization, assigned by Payabli.
19395
+
19396
+ </dd>
19397
+ </dl>
19398
+
19399
+ <dl>
19400
+ <dd>
19401
+
19402
+ **from_record:** `Integer` — The number of records to skip before starting to collect the result set.
19403
+
19404
+ </dd>
19405
+ </dl>
19406
+
19407
+ <dl>
19408
+ <dd>
19409
+
19410
+ **limit_record:** `Integer` — Max number of records to return for the query. Use `0` or negative value to return all records.
19411
+
19412
+ </dd>
19413
+ </dl>
19414
+
19415
+ <dl>
19416
+ <dd>
19417
+
19418
+ **parameters:** `Internal::Types::Hash[String, String]`
19419
+
19420
+ Collection of field names, conditions, and values used to filter the query <Info>
19421
+ **You must remove `parameters=` from the request before you send it, otherwise Payabli will ignore the filters.**
19422
+
19423
+ Because of a technical limitation, you can't make a request that includes filters from the API console on this page. The response won't be filtered. Instead, copy the request, remove `parameters=` and run the request in a different client.
19424
+
19425
+ For example:
19426
+
19427
+ --url https://api-sandbox.payabli.com/api/Query/transactions/org/236?parameters=totalAmount(gt)=1000&limitRecord=20
19428
+
19429
+ should become:
19430
+
19431
+ --url https://api-sandbox.payabli.com/api/Query/transactions/org/236?totalAmount(gt)=1000&limitRecord=20
19432
+ </Info>
19433
+ See [Filters and Conditions Reference](/developers/developer-guides/pay-ops-reporting-engine-overview#filters-and-conditions-reference) for help.
19434
+
19435
+ List of field names accepted:
19436
+ - `reportName` (ct, nct, eq, ne)
19437
+ - `createdAt` (gt, ge, lt, le, eq, ne)
19438
+
19439
+ List of comparison accepted - enclosed between parentheses:
19440
+ - eq or empty => equal
19441
+ - gt => greater than
19442
+ - ge => greater or equal
19443
+ - lt => less than
19444
+ - le => less or equal
19445
+ - ne => not equal
19446
+ - ct => contains
19447
+ - nct => not contains
19448
+ - in => inside array
19449
+ - nin => not inside array
19450
+
19451
+ List of parameters accepted:
19452
+ - limitRecord : max number of records for query (default="20", "0" or negative value for all)
19453
+ - fromRecord : initial record in query
19454
+
19455
+ Example: reportName(ct)=tr return all records containing the string "tr"
19456
+
19457
+ </dd>
19458
+ </dl>
19459
+
19460
+ <dl>
19461
+ <dd>
19462
+
19463
+ **sort_by:** `String` — The field name to use for sorting results. Use `desc(field_name)` to sort descending by `field_name`, and use `asc(field_name)` to sort ascending by `field_name`.
19464
+
19465
+ </dd>
19466
+ </dl>
19467
+
19468
+ <dl>
19469
+ <dd>
19470
+
19471
+ **request_options:** `Payabli::Query::RequestOptions`
19472
+
18945
19473
  </dd>
18946
19474
  </dl>
18947
19475
  </dd>
@@ -22956,6 +23484,7 @@ List of field names accepted:
22956
23484
  - `orgName` (ne, eq, ct, nct)
22957
23485
  - `externalPaypointId` (ct, nct, eq, ne)
22958
23486
  - `paypointId` (in, nin, eq, ne)
23487
+ - `cardType` (eq)
22959
23488
 
22960
23489
  List of comparison accepted - enclosed between parentheses:
22961
23490
 
@@ -23110,6 +23639,7 @@ List of field names accepted:
23110
23639
  - `orgName` (ne, eq, ct, nct)
23111
23640
  - `externalPaypointId` (ct, nct, eq, ne)
23112
23641
  - `paypointId` (in, nin, eq, ne)
23642
+ - `cardType` (eq)
23113
23643
 
23114
23644
  List of comparison accepted - enclosed between parentheses:
23115
23645
 
@@ -25782,7 +26312,7 @@ client.vendor.edit_vendor(
25782
26312
  <dl>
25783
26313
  <dd>
25784
26314
 
25785
- Retrieves a vendor's details.
26315
+ Retrieves a vendor's details, including enrichment status and payment acceptance info when available.
25786
26316
  </dd>
25787
26317
  </dl>
25788
26318
  </dd>
@@ -25828,6 +26358,87 @@ client.vendor.get_vendor(id_vendor: 1)
25828
26358
  </dl>
25829
26359
 
25830
26360
 
26361
+ </dd>
26362
+ </dl>
26363
+ </details>
26364
+
26365
+ <details><summary><code>client.vendor.<a href="/lib/payabli/vendor/client.rb">enrich_vendor</a>(entry, request) -> Payabli::Vendor::Types::VendorEnrichResponse</code></summary>
26366
+ <dl>
26367
+ <dd>
26368
+
26369
+ #### 📝 Description
26370
+
26371
+ <dl>
26372
+ <dd>
26373
+
26374
+ <dl>
26375
+ <dd>
26376
+
26377
+ Triggers AI-powered vendor enrichment for an existing vendor. Runs one or more enrichment stages (invoice scan, web search) based on the `scope` parameter. Can automatically apply extracted payment acceptance info and vendor contact information to the vendor record, or return raw results for manual review. Contact Payabli to enable this feature.
26378
+ </dd>
26379
+ </dl>
26380
+ </dd>
26381
+ </dl>
26382
+
26383
+ #### 🔌 Usage
26384
+
26385
+ <dl>
26386
+ <dd>
26387
+
26388
+ <dl>
26389
+ <dd>
26390
+
26391
+ ```ruby
26392
+ client.vendor.enrich_vendor(
26393
+ entry: "8cfec329267",
26394
+ vendor_id: 3890,
26395
+ scope: ["invoice_scan"],
26396
+ apply_enrichment_data: false,
26397
+ invoice_file: {
26398
+ ftype: "pdf",
26399
+ filename: "invoice-2026-001.pdf",
26400
+ f_content: "<base64-encoded-pdf>"
26401
+ },
26402
+ fallback_method: "check"
26403
+ )
26404
+ ```
26405
+ </dd>
26406
+ </dl>
26407
+ </dd>
26408
+ </dl>
26409
+
26410
+ #### ⚙️ Parameters
26411
+
26412
+ <dl>
26413
+ <dd>
26414
+
26415
+ <dl>
26416
+ <dd>
26417
+
26418
+ **entry:** `String` — Entrypoint identifier.
26419
+
26420
+ </dd>
26421
+ </dl>
26422
+
26423
+ <dl>
26424
+ <dd>
26425
+
26426
+ **request:** `Payabli::Vendor::Types::VendorEnrichRequest`
26427
+
26428
+ </dd>
26429
+ </dl>
26430
+
26431
+ <dl>
26432
+ <dd>
26433
+
26434
+ **request_options:** `Payabli::Vendor::RequestOptions`
26435
+
26436
+ </dd>
26437
+ </dl>
26438
+ </dd>
26439
+ </dl>
26440
+
26441
+
25831
26442
  </dd>
25832
26443
  </dl>
25833
26444
  </details>