ultracart_api 4.1.92 → 4.1.94
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.
- checksums.yaml +4 -4
- data/README.md +22 -2
- data/docs/FraudApi.md +278 -0
- data/docs/FraudDeclineEmailRequest.md +18 -0
- data/docs/FraudLookupValues.md +28 -0
- data/docs/FraudLookupValuesResponse.md +26 -0
- data/docs/FraudRuleInsertRequest.md +76 -0
- data/docs/FraudRuleItemFilter.md +20 -0
- data/docs/FraudRulePublic.md +90 -0
- data/docs/FraudRuleResponse.md +26 -0
- data/docs/FraudRuleRotatingTransactionGatewayFilter.md +20 -0
- data/docs/FraudRuleSearchRequest.md +78 -0
- data/docs/FraudRuleStorefrontFilter.md +20 -0
- data/docs/FraudRulesResponse.md +26 -0
- data/docs/ItemVariantItem.md +2 -0
- data/lib/ultracart_api/api/fraud_api.rb +373 -0
- data/lib/ultracart_api/models/fraud_decline_email_request.rb +220 -0
- data/lib/ultracart_api/models/fraud_lookup_values.rb +270 -0
- data/lib/ultracart_api/models/fraud_lookup_values_response.rb +256 -0
- data/lib/ultracart_api/models/fraud_rule_insert_request.rb +583 -0
- data/lib/ultracart_api/models/fraud_rule_item_filter.rb +245 -0
- data/lib/ultracart_api/models/fraud_rule_public.rb +652 -0
- data/lib/ultracart_api/models/fraud_rule_response.rb +256 -0
- data/lib/ultracart_api/models/fraud_rule_rotating_transaction_gateway_filter.rb +230 -0
- data/lib/ultracart_api/models/fraud_rule_search_request.rb +572 -0
- data/lib/ultracart_api/models/fraud_rule_storefront_filter.rb +245 -0
- data/lib/ultracart_api/models/fraud_rules_response.rb +259 -0
- data/lib/ultracart_api/models/item_variant_item.rb +11 -1
- data/lib/ultracart_api/version.rb +1 -1
- data/lib/ultracart_api.rb +12 -0
- metadata +26 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 9039a89e9e1a86f496622fbc690d91a7d3060521915b1d7b4b4546bff0640942
|
|
4
|
+
data.tar.gz: 17951d2b1878d2f6da99b50c1c0f7dc4d3c89e45935a88acd1db278e76afbf33
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 29d0fe1c6e9c5d9a00b005814b3a2fd2dc4b577cdb6c0507b6ca395b5fe22c2d1655322970dee4d795a25d75c68b5e2eeec7c8bbe628600f6502290eea7690e6
|
|
7
|
+
data.tar.gz: 7109641620abb4d0a0d9ecc7a19d558129b9a9da675795f14eec3d2d43aa06a220f53698252e8363e17125d490de3c0299fe2b7f58f051456b1ee8f3b473ee7f
|
data/README.md
CHANGED
|
@@ -7,7 +7,7 @@ Note: Every method has a sample for every language. See https://github.com/Ultr
|
|
|
7
7
|
This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
|
|
8
8
|
|
|
9
9
|
- API version: 2.0.0
|
|
10
|
-
- Package version: 4.1.
|
|
10
|
+
- Package version: 4.1.94
|
|
11
11
|
- Build package: org.openapitools.codegen.languages.RubyClientCodegen
|
|
12
12
|
- For more information, please visit [http://www.ultracart.com/api/](http://www.ultracart.com/api/)
|
|
13
13
|
|
|
@@ -16,7 +16,7 @@ This SDK is automatically generated by the [OpenAPI Generator](https://openapi-g
|
|
|
16
16
|
gemfile:
|
|
17
17
|
|
|
18
18
|
```shell
|
|
19
|
-
gem 'ultracart_api', '4.1.
|
|
19
|
+
gem 'ultracart_api', '4.1.94'
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
install:
|
|
@@ -353,6 +353,11 @@ Class | Method | HTTP request | Description
|
|
|
353
353
|
*UltracartClient::DatawarehouseApi* | [**update_custom_report**](docs/DatawarehouseApi.md#update_custom_report) | **PUT** /datawarehouse/custom_reports/{custom_report_oid} | Update a custom report
|
|
354
354
|
*UltracartClient::DatawarehouseApi* | [**update_custom_report_account_config**](docs/DatawarehouseApi.md#update_custom_report_account_config) | **PUT** /datawarehouse/custom_reports/account_config | Update custom report account config
|
|
355
355
|
*UltracartClient::DatawarehouseApi* | [**update_report**](docs/DatawarehouseApi.md#update_report) | **PUT** /datawarehouse/reports/{report_oid} | Update a report
|
|
356
|
+
*UltracartClient::FraudApi* | [**decline_email**](docs/FraudApi.md#decline_email) | **POST** /fraud/decline_email | Decline emails during checkout fraud review
|
|
357
|
+
*UltracartClient::FraudApi* | [**delete_fraud_rule**](docs/FraudApi.md#delete_fraud_rule) | **DELETE** /fraud/rules/{fraud_rule_oid} | Delete a fraud rule
|
|
358
|
+
*UltracartClient::FraudApi* | [**get_fraud_lookup_values**](docs/FraudApi.md#get_fraud_lookup_values) | **GET** /fraud/lookup_values | Retrieve fraud rule lookup values
|
|
359
|
+
*UltracartClient::FraudApi* | [**insert_fraud_rule**](docs/FraudApi.md#insert_fraud_rule) | **POST** /fraud/rules | Insert a fraud rule
|
|
360
|
+
*UltracartClient::FraudApi* | [**search_fraud_rules**](docs/FraudApi.md#search_fraud_rules) | **POST** /fraud/rules/search | Search fraud rules
|
|
356
361
|
*UltracartClient::FulfillmentApi* | [**acknowledge_orders**](docs/FulfillmentApi.md#acknowledge_orders) | **PUT** /fulfillment/distribution_centers/{distribution_center_code}/acknowledgements | Acknowledge receipt of orders.
|
|
357
362
|
*UltracartClient::FulfillmentApi* | [**generate_packing_slip**](docs/FulfillmentApi.md#generate_packing_slip) | **GET** /fulfillment/distribution_centers/{distribution_center_code}/orders/{order_id} | Generate a packing slip for this order for the given distribution center.
|
|
358
363
|
*UltracartClient::FulfillmentApi* | [**get_distribution_center_orders**](docs/FulfillmentApi.md#get_distribution_center_orders) | **GET** /fulfillment/distribution_centers/{distribution_center_code}/orders | Retrieve orders queued up for this distribution center.
|
|
@@ -1273,6 +1278,17 @@ Class | Method | HTTP request | Description
|
|
|
1273
1278
|
- [UltracartClient::FileManagerPageResponse](docs/FileManagerPageResponse.md)
|
|
1274
1279
|
- [UltracartClient::FileManagerUploadRequest](docs/FileManagerUploadRequest.md)
|
|
1275
1280
|
- [UltracartClient::FileManagerUploadUrlResponse](docs/FileManagerUploadUrlResponse.md)
|
|
1281
|
+
- [UltracartClient::FraudDeclineEmailRequest](docs/FraudDeclineEmailRequest.md)
|
|
1282
|
+
- [UltracartClient::FraudLookupValues](docs/FraudLookupValues.md)
|
|
1283
|
+
- [UltracartClient::FraudLookupValuesResponse](docs/FraudLookupValuesResponse.md)
|
|
1284
|
+
- [UltracartClient::FraudRuleInsertRequest](docs/FraudRuleInsertRequest.md)
|
|
1285
|
+
- [UltracartClient::FraudRuleItemFilter](docs/FraudRuleItemFilter.md)
|
|
1286
|
+
- [UltracartClient::FraudRulePublic](docs/FraudRulePublic.md)
|
|
1287
|
+
- [UltracartClient::FraudRuleResponse](docs/FraudRuleResponse.md)
|
|
1288
|
+
- [UltracartClient::FraudRuleRotatingTransactionGatewayFilter](docs/FraudRuleRotatingTransactionGatewayFilter.md)
|
|
1289
|
+
- [UltracartClient::FraudRuleSearchRequest](docs/FraudRuleSearchRequest.md)
|
|
1290
|
+
- [UltracartClient::FraudRuleStorefrontFilter](docs/FraudRuleStorefrontFilter.md)
|
|
1291
|
+
- [UltracartClient::FraudRulesResponse](docs/FraudRulesResponse.md)
|
|
1276
1292
|
- [UltracartClient::FulfillmentInventory](docs/FulfillmentInventory.md)
|
|
1277
1293
|
- [UltracartClient::FulfillmentShipment](docs/FulfillmentShipment.md)
|
|
1278
1294
|
- [UltracartClient::GeoPoint](docs/GeoPoint.md)
|
|
@@ -1713,6 +1729,8 @@ Class | Method | HTTP request | Description
|
|
|
1713
1729
|
- coupon_write: Allows you to write coupon information.
|
|
1714
1730
|
- customer_read: Allows you to read customer information.
|
|
1715
1731
|
- customer_write: Allows you to write customer information.
|
|
1732
|
+
- fraud_read: Allows you to read fraud information.
|
|
1733
|
+
- fraud_write: Allows you to write fraud information.
|
|
1716
1734
|
- fulfillment_read: Allows you to read fulfillment information.
|
|
1717
1735
|
- fulfillment_write: Allows you to write fulfillment information.
|
|
1718
1736
|
- gift_certificate_read: Allows you to read gift certificate information.
|
|
@@ -1751,6 +1769,8 @@ Not every change is committed to every SDK.
|
|
|
1751
1769
|
|
|
1752
1770
|
| Version | Date | Comments |
|
|
1753
1771
|
| --: | :-: | --- |
|
|
1772
|
+
| 4.1.94 | 06/02/2026 | fraud api alpha version |
|
|
1773
|
+
| 4.1.93 | 06/02/2026 | fraud api alpha version for testing |
|
|
1754
1774
|
| 4.1.92 | 05/26/2026 | AutoOrderApi.getAutoOrderCancelReasons |
|
|
1755
1775
|
| 4.1.91 | 05/18/2026 | ChannelPartner - support creation_dts on import of a store_completed (historical) order |
|
|
1756
1776
|
| 4.1.90 | 05/13/2026 | webhook rest api - new method getWebhookEventCategories |
|
data/docs/FraudApi.md
ADDED
|
@@ -0,0 +1,278 @@
|
|
|
1
|
+
# UltracartClient::FraudApi
|
|
2
|
+
|
|
3
|
+
All URIs are relative to *https://secure.ultracart.com/rest/v2*
|
|
4
|
+
|
|
5
|
+
| Method | HTTP request | Description |
|
|
6
|
+
| ------ | ------------ | ----------- |
|
|
7
|
+
| [**decline_email**](FraudApi.md#decline_email) | **POST** /fraud/decline_email | Decline emails during checkout fraud review |
|
|
8
|
+
| [**delete_fraud_rule**](FraudApi.md#delete_fraud_rule) | **DELETE** /fraud/rules/{fraud_rule_oid} | Delete a fraud rule |
|
|
9
|
+
| [**get_fraud_lookup_values**](FraudApi.md#get_fraud_lookup_values) | **GET** /fraud/lookup_values | Retrieve fraud rule lookup values |
|
|
10
|
+
| [**insert_fraud_rule**](FraudApi.md#insert_fraud_rule) | **POST** /fraud/rules | Insert a fraud rule |
|
|
11
|
+
| [**search_fraud_rules**](FraudApi.md#search_fraud_rules) | **POST** /fraud/rules/search | Search fraud rules |
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
## decline_email
|
|
15
|
+
|
|
16
|
+
> decline_email(fraud_decline_emails_request)
|
|
17
|
+
|
|
18
|
+
Decline emails during checkout fraud review
|
|
19
|
+
|
|
20
|
+
Adds one or more email addresses to the fraud decline list for this merchant account.
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
### Examples
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
(No example for this operation).
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
#### Using the decline_email_with_http_info variant
|
|
30
|
+
|
|
31
|
+
This returns an Array which contains the response data (`nil` in this case), status code and headers.
|
|
32
|
+
|
|
33
|
+
> <Array(nil, Integer, Hash)> decline_email_with_http_info(fraud_decline_emails_request)
|
|
34
|
+
|
|
35
|
+
```ruby
|
|
36
|
+
begin
|
|
37
|
+
# Decline emails during checkout fraud review
|
|
38
|
+
data, status_code, headers = api_instance.decline_email_with_http_info(fraud_decline_emails_request)
|
|
39
|
+
p status_code # => 2xx
|
|
40
|
+
p headers # => { ... }
|
|
41
|
+
p data # => nil
|
|
42
|
+
rescue UltracartClient::ApiError => e
|
|
43
|
+
puts "Error when calling FraudApi->decline_email_with_http_info: #{e}"
|
|
44
|
+
end
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### Parameters
|
|
48
|
+
|
|
49
|
+
| Name | Type | Description | Notes |
|
|
50
|
+
| ---- | ---- | ----------- | ----- |
|
|
51
|
+
| **fraud_decline_emails_request** | [**FraudDeclineEmailRequest**](FraudDeclineEmailRequest.md) | Fraud decline emails request | |
|
|
52
|
+
|
|
53
|
+
### Return type
|
|
54
|
+
|
|
55
|
+
nil (empty response body)
|
|
56
|
+
|
|
57
|
+
### Authorization
|
|
58
|
+
|
|
59
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
60
|
+
|
|
61
|
+
### HTTP request headers
|
|
62
|
+
|
|
63
|
+
- **Content-Type**: application/json
|
|
64
|
+
- **Accept**: application/json
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
## delete_fraud_rule
|
|
68
|
+
|
|
69
|
+
> delete_fraud_rule(fraud_rule_oid)
|
|
70
|
+
|
|
71
|
+
Delete a fraud rule
|
|
72
|
+
|
|
73
|
+
Deletes a fraud rule for this merchant account.
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
### Examples
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
(No example for this operation).
|
|
80
|
+
|
|
81
|
+
|
|
82
|
+
#### Using the delete_fraud_rule_with_http_info variant
|
|
83
|
+
|
|
84
|
+
This returns an Array which contains the response data (`nil` in this case), status code and headers.
|
|
85
|
+
|
|
86
|
+
> <Array(nil, Integer, Hash)> delete_fraud_rule_with_http_info(fraud_rule_oid)
|
|
87
|
+
|
|
88
|
+
```ruby
|
|
89
|
+
begin
|
|
90
|
+
# Delete a fraud rule
|
|
91
|
+
data, status_code, headers = api_instance.delete_fraud_rule_with_http_info(fraud_rule_oid)
|
|
92
|
+
p status_code # => 2xx
|
|
93
|
+
p headers # => { ... }
|
|
94
|
+
p data # => nil
|
|
95
|
+
rescue UltracartClient::ApiError => e
|
|
96
|
+
puts "Error when calling FraudApi->delete_fraud_rule_with_http_info: #{e}"
|
|
97
|
+
end
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
### Parameters
|
|
101
|
+
|
|
102
|
+
| Name | Type | Description | Notes |
|
|
103
|
+
| ---- | ---- | ----------- | ----- |
|
|
104
|
+
| **fraud_rule_oid** | **Integer** | | |
|
|
105
|
+
|
|
106
|
+
### Return type
|
|
107
|
+
|
|
108
|
+
nil (empty response body)
|
|
109
|
+
|
|
110
|
+
### Authorization
|
|
111
|
+
|
|
112
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
113
|
+
|
|
114
|
+
### HTTP request headers
|
|
115
|
+
|
|
116
|
+
- **Content-Type**: Not defined
|
|
117
|
+
- **Accept**: application/json
|
|
118
|
+
|
|
119
|
+
|
|
120
|
+
## get_fraud_lookup_values
|
|
121
|
+
|
|
122
|
+
> <FraudLookupValuesResponse> get_fraud_lookup_values
|
|
123
|
+
|
|
124
|
+
Retrieve fraud rule lookup values
|
|
125
|
+
|
|
126
|
+
Returns the dropdown values required to build valid fraud rule insert and search requests. Includes rule types, failure actions, user actions, IP range types, AVS match types, the merchant's rotating transaction gateways, screen branding themes, countries, and affiliates.
|
|
127
|
+
|
|
128
|
+
|
|
129
|
+
### Examples
|
|
130
|
+
|
|
131
|
+
|
|
132
|
+
(No example for this operation).
|
|
133
|
+
|
|
134
|
+
|
|
135
|
+
#### Using the get_fraud_lookup_values_with_http_info variant
|
|
136
|
+
|
|
137
|
+
This returns an Array which contains the response data, status code and headers.
|
|
138
|
+
|
|
139
|
+
> <Array(<FraudLookupValuesResponse>, Integer, Hash)> get_fraud_lookup_values_with_http_info
|
|
140
|
+
|
|
141
|
+
```ruby
|
|
142
|
+
begin
|
|
143
|
+
# Retrieve fraud rule lookup values
|
|
144
|
+
data, status_code, headers = api_instance.get_fraud_lookup_values_with_http_info
|
|
145
|
+
p status_code # => 2xx
|
|
146
|
+
p headers # => { ... }
|
|
147
|
+
p data # => <FraudLookupValuesResponse>
|
|
148
|
+
rescue UltracartClient::ApiError => e
|
|
149
|
+
puts "Error when calling FraudApi->get_fraud_lookup_values_with_http_info: #{e}"
|
|
150
|
+
end
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
### Parameters
|
|
154
|
+
|
|
155
|
+
This endpoint does not need any parameter.
|
|
156
|
+
|
|
157
|
+
### Return type
|
|
158
|
+
|
|
159
|
+
[**FraudLookupValuesResponse**](FraudLookupValuesResponse.md)
|
|
160
|
+
|
|
161
|
+
### Authorization
|
|
162
|
+
|
|
163
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
164
|
+
|
|
165
|
+
### HTTP request headers
|
|
166
|
+
|
|
167
|
+
- **Content-Type**: Not defined
|
|
168
|
+
- **Accept**: application/json
|
|
169
|
+
|
|
170
|
+
|
|
171
|
+
## insert_fraud_rule
|
|
172
|
+
|
|
173
|
+
> <FraudRuleResponse> insert_fraud_rule(fraud_rule_insert_request)
|
|
174
|
+
|
|
175
|
+
Insert a fraud rule
|
|
176
|
+
|
|
177
|
+
Creates a fraud rule for this merchant account. Field names in the request body are semantic (eg amount_threshold, email, ip_address). Call GET /v2/fraud/lookup_values for the list of valid rule_type, failure_action, and related dropdown values. The 'credit card matches' rule type is not supported via REST.
|
|
178
|
+
|
|
179
|
+
|
|
180
|
+
### Examples
|
|
181
|
+
|
|
182
|
+
|
|
183
|
+
(No example for this operation).
|
|
184
|
+
|
|
185
|
+
|
|
186
|
+
#### Using the insert_fraud_rule_with_http_info variant
|
|
187
|
+
|
|
188
|
+
This returns an Array which contains the response data, status code and headers.
|
|
189
|
+
|
|
190
|
+
> <Array(<FraudRuleResponse>, Integer, Hash)> insert_fraud_rule_with_http_info(fraud_rule_insert_request)
|
|
191
|
+
|
|
192
|
+
```ruby
|
|
193
|
+
begin
|
|
194
|
+
# Insert a fraud rule
|
|
195
|
+
data, status_code, headers = api_instance.insert_fraud_rule_with_http_info(fraud_rule_insert_request)
|
|
196
|
+
p status_code # => 2xx
|
|
197
|
+
p headers # => { ... }
|
|
198
|
+
p data # => <FraudRuleResponse>
|
|
199
|
+
rescue UltracartClient::ApiError => e
|
|
200
|
+
puts "Error when calling FraudApi->insert_fraud_rule_with_http_info: #{e}"
|
|
201
|
+
end
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
### Parameters
|
|
205
|
+
|
|
206
|
+
| Name | Type | Description | Notes |
|
|
207
|
+
| ---- | ---- | ----------- | ----- |
|
|
208
|
+
| **fraud_rule_insert_request** | [**FraudRuleInsertRequest**](FraudRuleInsertRequest.md) | Fraud rule insert request | |
|
|
209
|
+
|
|
210
|
+
### Return type
|
|
211
|
+
|
|
212
|
+
[**FraudRuleResponse**](FraudRuleResponse.md)
|
|
213
|
+
|
|
214
|
+
### Authorization
|
|
215
|
+
|
|
216
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
217
|
+
|
|
218
|
+
### HTTP request headers
|
|
219
|
+
|
|
220
|
+
- **Content-Type**: application/json
|
|
221
|
+
- **Accept**: application/json
|
|
222
|
+
|
|
223
|
+
|
|
224
|
+
## search_fraud_rules
|
|
225
|
+
|
|
226
|
+
> <FraudRulesResponse> search_fraud_rules(fraud_rule_search_request, opts)
|
|
227
|
+
|
|
228
|
+
Search fraud rules
|
|
229
|
+
|
|
230
|
+
Searches fraud rules for this merchant account using semantic filter fields. Pagination and sort are passed as query parameters (_limit, _offset, _sort). You will need to make multiple API calls in order to retrieve the entire result set since this API performs result set pagination. Results are capped at 10,000 records by ElasticSearch and the warning slot indicates when that cap was hit. Use more selective filters in that case.
|
|
231
|
+
|
|
232
|
+
|
|
233
|
+
### Examples
|
|
234
|
+
|
|
235
|
+
|
|
236
|
+
(No example for this operation).
|
|
237
|
+
|
|
238
|
+
|
|
239
|
+
#### Using the search_fraud_rules_with_http_info variant
|
|
240
|
+
|
|
241
|
+
This returns an Array which contains the response data, status code and headers.
|
|
242
|
+
|
|
243
|
+
> <Array(<FraudRulesResponse>, Integer, Hash)> search_fraud_rules_with_http_info(fraud_rule_search_request, opts)
|
|
244
|
+
|
|
245
|
+
```ruby
|
|
246
|
+
begin
|
|
247
|
+
# Search fraud rules
|
|
248
|
+
data, status_code, headers = api_instance.search_fraud_rules_with_http_info(fraud_rule_search_request, opts)
|
|
249
|
+
p status_code # => 2xx
|
|
250
|
+
p headers # => { ... }
|
|
251
|
+
p data # => <FraudRulesResponse>
|
|
252
|
+
rescue UltracartClient::ApiError => e
|
|
253
|
+
puts "Error when calling FraudApi->search_fraud_rules_with_http_info: #{e}"
|
|
254
|
+
end
|
|
255
|
+
```
|
|
256
|
+
|
|
257
|
+
### Parameters
|
|
258
|
+
|
|
259
|
+
| Name | Type | Description | Notes |
|
|
260
|
+
| ---- | ---- | ----------- | ----- |
|
|
261
|
+
| **fraud_rule_search_request** | [**FraudRuleSearchRequest**](FraudRuleSearchRequest.md) | Fraud rule search request | |
|
|
262
|
+
| **_limit** | **Integer** | The maximum number of records to return on this one API call. (Maximum 200) | [optional][default to 100] |
|
|
263
|
+
| **_offset** | **Integer** | Pagination of the record set. Offset is a zero based index. | [optional][default to 0] |
|
|
264
|
+
| **_sort** | **String** | The sort order of the fraud rules. See Sorting documentation for examples of using multiple values and sorting by ascending and descending. | [optional] |
|
|
265
|
+
|
|
266
|
+
### Return type
|
|
267
|
+
|
|
268
|
+
[**FraudRulesResponse**](FraudRulesResponse.md)
|
|
269
|
+
|
|
270
|
+
### Authorization
|
|
271
|
+
|
|
272
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
273
|
+
|
|
274
|
+
### HTTP request headers
|
|
275
|
+
|
|
276
|
+
- **Content-Type**: application/json
|
|
277
|
+
- **Accept**: application/json
|
|
278
|
+
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# UltracartClient::FraudDeclineEmailRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **email** | **String** | email to decline during checkout fraud review | [optional] |
|
|
8
|
+
|
|
9
|
+
## Example
|
|
10
|
+
|
|
11
|
+
```ruby
|
|
12
|
+
require 'ultracart_api'
|
|
13
|
+
|
|
14
|
+
instance = UltracartClient::FraudDeclineEmailRequest.new(
|
|
15
|
+
email: null
|
|
16
|
+
)
|
|
17
|
+
```
|
|
18
|
+
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# UltracartClient::FraudLookupValues
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **affiliates** | **Object** | Affiliates with non-empty email, sorted by email. | [optional] |
|
|
8
|
+
| **countries** | **Object** | ISO country codes available to this merchant. | [optional] |
|
|
9
|
+
| **ip_range_types** | **Object** | Valid values for ip_range_type on IP-based rules. | [optional] |
|
|
10
|
+
| **linked_accounts** | **Boolean** | True when this merchant has at least one linked merchant account. | [optional] |
|
|
11
|
+
| **rule_groups** | **Object** | Valid values for rule_group on search requests. | [optional] |
|
|
12
|
+
| **rule_types** | **Object** | Valid values for rule_type on insert and search requests. | [optional] |
|
|
13
|
+
|
|
14
|
+
## Example
|
|
15
|
+
|
|
16
|
+
```ruby
|
|
17
|
+
require 'ultracart_api'
|
|
18
|
+
|
|
19
|
+
instance = UltracartClient::FraudLookupValues.new(
|
|
20
|
+
affiliates: null,
|
|
21
|
+
countries: null,
|
|
22
|
+
ip_range_types: null,
|
|
23
|
+
linked_accounts: null,
|
|
24
|
+
rule_groups: null,
|
|
25
|
+
rule_types: null
|
|
26
|
+
)
|
|
27
|
+
```
|
|
28
|
+
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# UltracartClient::FraudLookupValuesResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **error** | [**Error**](Error.md) | | [optional] |
|
|
8
|
+
| **fraud_lookup_values** | [**FraudLookupValues**](FraudLookupValues.md) | | [optional] |
|
|
9
|
+
| **metadata** | [**ResponseMetadata**](ResponseMetadata.md) | | [optional] |
|
|
10
|
+
| **success** | **Boolean** | Indicates if API call was successful | [optional] |
|
|
11
|
+
| **warning** | [**Warning**](Warning.md) | | [optional] |
|
|
12
|
+
|
|
13
|
+
## Example
|
|
14
|
+
|
|
15
|
+
```ruby
|
|
16
|
+
require 'ultracart_api'
|
|
17
|
+
|
|
18
|
+
instance = UltracartClient::FraudLookupValuesResponse.new(
|
|
19
|
+
error: null,
|
|
20
|
+
fraud_lookup_values: null,
|
|
21
|
+
metadata: null,
|
|
22
|
+
success: null,
|
|
23
|
+
warning: null
|
|
24
|
+
)
|
|
25
|
+
```
|
|
26
|
+
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
# UltracartClient::FraudRuleInsertRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **affiliate_email** | **String** | Affiliate email. Used by the 'affiliate matches' rule type when affiliate_oid is not supplied. | [optional] |
|
|
8
|
+
| **affiliate_oid** | **Integer** | Affiliate OID. Used by the 'affiliate matches' rule type. If omitted, affiliate_email is required. | [optional] |
|
|
9
|
+
| **amount_threshold** | **Float** | Monetary or score threshold. Used by *transaction amount exceeds*, *fraud score exceeds*, and *decline percentage exceeds* rules. | [optional] |
|
|
10
|
+
| **auto_note** | **String** | Note automatically appended to the order's merchant note when this rule fires. | [optional] |
|
|
11
|
+
| **avs_match_type** | **String** | AVS match type for the zip portion. Used by the 'address street and zip avs' rule type. | [optional] |
|
|
12
|
+
| **avs_response_codes** | **String** | AVS response codes (street). Used by the 'address street and zip avs' rule type. | [optional] |
|
|
13
|
+
| **count_threshold** | **Integer** | Integer count threshold. Used by *count exceeds*, *change number*, *quantity exceeds*, and *purchased within last hours* rules. | [optional] |
|
|
14
|
+
| **country_code** | **String** | ISO country code. Used by the 'address not in country' rule type. | [optional] |
|
|
15
|
+
| **credit_card_bins** | **Object** | Credit card BINs to block (max 20). Used by the 'credit card block bin' rule type. | [optional] |
|
|
16
|
+
| **email** | **String** | Email address. Used by the 'address email' rule type. | [optional] |
|
|
17
|
+
| **failure_action** | **String** | Action to take when this rule fires. | [optional] |
|
|
18
|
+
| **gateway_response_codes** | **String** | Gateway response code key. Used by the 'gateway response' rule type. | [optional] |
|
|
19
|
+
| **gateway_response_value** | **String** | Gateway response code value. Used by the 'gateway response' rule type. | [optional] |
|
|
20
|
+
| **ip_address** | **String** | IP address or subnet (eg '192.168.1.1' or '10.0.0.0/8'). Used by 'exempt ip' and 'ip matches' rules. | [optional] |
|
|
21
|
+
| **ip_range_type** | **String** | Specifies whether an IP rule applies to a single address or a subnet. | [optional] |
|
|
22
|
+
| **item_filters** | **Object** | Optional list of merchant item ids restricting this rule to orders containing one or more of these items. | [optional] |
|
|
23
|
+
| **merchant_item_id** | **String** | Merchant item id. Used by the 'item matches' rule type. | [optional] |
|
|
24
|
+
| **modify_custom_field1** | **String** | | [optional] |
|
|
25
|
+
| **modify_custom_field2** | **String** | | [optional] |
|
|
26
|
+
| **modify_custom_field3** | **String** | | [optional] |
|
|
27
|
+
| **modify_custom_field4** | **String** | | [optional] |
|
|
28
|
+
| **modify_custom_field5** | **String** | | [optional] |
|
|
29
|
+
| **modify_custom_field6** | **String** | | [optional] |
|
|
30
|
+
| **modify_custom_field7** | **String** | | [optional] |
|
|
31
|
+
| **modify_skip_affiliate** | **Boolean** | | [optional] |
|
|
32
|
+
| **modify_skip_affiliate_network_pixel** | **Boolean** | | [optional] |
|
|
33
|
+
| **rotating_transaction_gateway_filters** | **Object** | Optional list of rotating transaction gateway oids restricting this rule to orders processed by one of these gateways. | [optional] |
|
|
34
|
+
| **rule_type** | **String** | Rule type. Also returned by GET /v2/fraud/lookup_values. | [optional] |
|
|
35
|
+
| **screen_branding_theme_filters** | **Object** | Optional list of screen branding theme oids restricting this rule to orders associated with one or more storefronts. | [optional] |
|
|
36
|
+
| **user_action** | **String** | Only used by rule types that distinguish between attempted and approved transactions. | [optional] |
|
|
37
|
+
|
|
38
|
+
## Example
|
|
39
|
+
|
|
40
|
+
```ruby
|
|
41
|
+
require 'ultracart_api'
|
|
42
|
+
|
|
43
|
+
instance = UltracartClient::FraudRuleInsertRequest.new(
|
|
44
|
+
affiliate_email: null,
|
|
45
|
+
affiliate_oid: null,
|
|
46
|
+
amount_threshold: null,
|
|
47
|
+
auto_note: null,
|
|
48
|
+
avs_match_type: null,
|
|
49
|
+
avs_response_codes: null,
|
|
50
|
+
count_threshold: null,
|
|
51
|
+
country_code: null,
|
|
52
|
+
credit_card_bins: null,
|
|
53
|
+
email: null,
|
|
54
|
+
failure_action: null,
|
|
55
|
+
gateway_response_codes: null,
|
|
56
|
+
gateway_response_value: null,
|
|
57
|
+
ip_address: null,
|
|
58
|
+
ip_range_type: null,
|
|
59
|
+
item_filters: null,
|
|
60
|
+
merchant_item_id: null,
|
|
61
|
+
modify_custom_field1: null,
|
|
62
|
+
modify_custom_field2: null,
|
|
63
|
+
modify_custom_field3: null,
|
|
64
|
+
modify_custom_field4: null,
|
|
65
|
+
modify_custom_field5: null,
|
|
66
|
+
modify_custom_field6: null,
|
|
67
|
+
modify_custom_field7: null,
|
|
68
|
+
modify_skip_affiliate: null,
|
|
69
|
+
modify_skip_affiliate_network_pixel: null,
|
|
70
|
+
rotating_transaction_gateway_filters: null,
|
|
71
|
+
rule_type: null,
|
|
72
|
+
screen_branding_theme_filters: null,
|
|
73
|
+
user_action: null
|
|
74
|
+
)
|
|
75
|
+
```
|
|
76
|
+
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# UltracartClient::FraudRuleItemFilter
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **merchant_item_id** | **String** | Unique item id of this item filter | [optional] |
|
|
8
|
+
| **merchant_item_oid** | **Integer** | Unique object identifier of this item | [optional] |
|
|
9
|
+
|
|
10
|
+
## Example
|
|
11
|
+
|
|
12
|
+
```ruby
|
|
13
|
+
require 'ultracart_api'
|
|
14
|
+
|
|
15
|
+
instance = UltracartClient::FraudRuleItemFilter.new(
|
|
16
|
+
merchant_item_id: null,
|
|
17
|
+
merchant_item_oid: null
|
|
18
|
+
)
|
|
19
|
+
```
|
|
20
|
+
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
# UltracartClient::FraudRulePublic
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **affiliate_oid** | **Integer** | | [optional] |
|
|
8
|
+
| **amount_threshold** | **Float** | | [optional] |
|
|
9
|
+
| **auto_note** | **String** | | [optional] |
|
|
10
|
+
| **avs_match_type** | **String** | | [optional] |
|
|
11
|
+
| **avs_response_codes** | **String** | | [optional] |
|
|
12
|
+
| **card_number** | **String** | Masked credit card number for rules tied to a specific card | [optional] |
|
|
13
|
+
| **count_threshold** | **Integer** | | [optional] |
|
|
14
|
+
| **country_code** | **String** | | [optional] |
|
|
15
|
+
| **created_by** | **String** | | [optional] |
|
|
16
|
+
| **created_dts** | **String** | Created date | [optional] |
|
|
17
|
+
| **credit_card_bins** | **Object** | Credit card BINs blocked by the 'credit card block bin' rule type. | [optional] |
|
|
18
|
+
| **decline_message** | **String** | | [optional] |
|
|
19
|
+
| **description** | **String** | Human-readable description of the rule | [optional] |
|
|
20
|
+
| **description_html** | **String** | HTML version of the rule description | [optional] |
|
|
21
|
+
| **email** | **String** | | [optional] |
|
|
22
|
+
| **failure_action** | **String** | Action taken when this rule fires. | [optional] |
|
|
23
|
+
| **fraud_rule_oid** | **Integer** | UltraCart unique identifier for this fraud rule | [optional] |
|
|
24
|
+
| **gateway_response_codes** | **String** | | [optional] |
|
|
25
|
+
| **gateway_response_value** | **String** | | [optional] |
|
|
26
|
+
| **ip_address** | **String** | | [optional] |
|
|
27
|
+
| **ip_range_type** | **String** | | [optional] |
|
|
28
|
+
| **item_filters** | [**Array<FraudRuleItemFilter>**](FraudRuleItemFilter.md) | | [optional] |
|
|
29
|
+
| **merchant_item_id** | **String** | | [optional] |
|
|
30
|
+
| **modify_custom_field1** | **String** | | [optional] |
|
|
31
|
+
| **modify_custom_field2** | **String** | | [optional] |
|
|
32
|
+
| **modify_custom_field3** | **String** | | [optional] |
|
|
33
|
+
| **modify_custom_field4** | **String** | | [optional] |
|
|
34
|
+
| **modify_custom_field5** | **String** | | [optional] |
|
|
35
|
+
| **modify_custom_field6** | **String** | | [optional] |
|
|
36
|
+
| **modify_custom_field7** | **String** | | [optional] |
|
|
37
|
+
| **modify_skip_affiliate** | **Boolean** | | [optional] |
|
|
38
|
+
| **modify_skip_affiliate_network_pixel** | **Boolean** | | [optional] |
|
|
39
|
+
| **rotating_transaction_gateway_filters** | [**Array<FraudRuleRotatingTransactionGatewayFilter>**](FraudRuleRotatingTransactionGatewayFilter.md) | | [optional] |
|
|
40
|
+
| **rule_group** | **String** | Group containing this rule type (eg 'creditCardRules') | [optional] |
|
|
41
|
+
| **rule_type** | **String** | Rule type. | [optional] |
|
|
42
|
+
| **storefront_filters** | [**Array<FraudRuleStorefrontFilter>**](FraudRuleStorefrontFilter.md) | | [optional] |
|
|
43
|
+
| **user_action** | **String** | | [optional] |
|
|
44
|
+
|
|
45
|
+
## Example
|
|
46
|
+
|
|
47
|
+
```ruby
|
|
48
|
+
require 'ultracart_api'
|
|
49
|
+
|
|
50
|
+
instance = UltracartClient::FraudRulePublic.new(
|
|
51
|
+
affiliate_oid: null,
|
|
52
|
+
amount_threshold: null,
|
|
53
|
+
auto_note: null,
|
|
54
|
+
avs_match_type: null,
|
|
55
|
+
avs_response_codes: null,
|
|
56
|
+
card_number: null,
|
|
57
|
+
count_threshold: null,
|
|
58
|
+
country_code: null,
|
|
59
|
+
created_by: null,
|
|
60
|
+
created_dts: null,
|
|
61
|
+
credit_card_bins: null,
|
|
62
|
+
decline_message: null,
|
|
63
|
+
description: null,
|
|
64
|
+
description_html: null,
|
|
65
|
+
email: null,
|
|
66
|
+
failure_action: null,
|
|
67
|
+
fraud_rule_oid: null,
|
|
68
|
+
gateway_response_codes: null,
|
|
69
|
+
gateway_response_value: null,
|
|
70
|
+
ip_address: null,
|
|
71
|
+
ip_range_type: null,
|
|
72
|
+
item_filters: null,
|
|
73
|
+
merchant_item_id: null,
|
|
74
|
+
modify_custom_field1: null,
|
|
75
|
+
modify_custom_field2: null,
|
|
76
|
+
modify_custom_field3: null,
|
|
77
|
+
modify_custom_field4: null,
|
|
78
|
+
modify_custom_field5: null,
|
|
79
|
+
modify_custom_field6: null,
|
|
80
|
+
modify_custom_field7: null,
|
|
81
|
+
modify_skip_affiliate: null,
|
|
82
|
+
modify_skip_affiliate_network_pixel: null,
|
|
83
|
+
rotating_transaction_gateway_filters: null,
|
|
84
|
+
rule_group: null,
|
|
85
|
+
rule_type: null,
|
|
86
|
+
storefront_filters: null,
|
|
87
|
+
user_action: null
|
|
88
|
+
)
|
|
89
|
+
```
|
|
90
|
+
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# UltracartClient::FraudRuleResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **error** | [**Error**](Error.md) | | [optional] |
|
|
8
|
+
| **fraud_rule** | [**FraudRulePublic**](FraudRulePublic.md) | | [optional] |
|
|
9
|
+
| **metadata** | [**ResponseMetadata**](ResponseMetadata.md) | | [optional] |
|
|
10
|
+
| **success** | **Boolean** | Indicates if API call was successful | [optional] |
|
|
11
|
+
| **warning** | [**Warning**](Warning.md) | | [optional] |
|
|
12
|
+
|
|
13
|
+
## Example
|
|
14
|
+
|
|
15
|
+
```ruby
|
|
16
|
+
require 'ultracart_api'
|
|
17
|
+
|
|
18
|
+
instance = UltracartClient::FraudRuleResponse.new(
|
|
19
|
+
error: null,
|
|
20
|
+
fraud_rule: null,
|
|
21
|
+
metadata: null,
|
|
22
|
+
success: null,
|
|
23
|
+
warning: null
|
|
24
|
+
)
|
|
25
|
+
```
|
|
26
|
+
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# UltracartClient::FraudRuleRotatingTransactionGatewayFilter
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **code** | **String** | The short code identifier of this rotating transaction gateway used to filter this fraud rule | [optional] |
|
|
8
|
+
| **rotating_transaction_gateway_oid** | **Integer** | Unique object identifier of a rotating transaction gateway filtering this fraud rule to only orders processed by this gateway | [optional] |
|
|
9
|
+
|
|
10
|
+
## Example
|
|
11
|
+
|
|
12
|
+
```ruby
|
|
13
|
+
require 'ultracart_api'
|
|
14
|
+
|
|
15
|
+
instance = UltracartClient::FraudRuleRotatingTransactionGatewayFilter.new(
|
|
16
|
+
code: null,
|
|
17
|
+
rotating_transaction_gateway_oid: null
|
|
18
|
+
)
|
|
19
|
+
```
|
|
20
|
+
|