ultracart_api 4.1.91 → 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 +26 -2
- data/docs/AutoOrderApi.md +52 -0
- data/docs/AutoOrderCancelReason.md +22 -0
- data/docs/AutoOrderCancelReasonsResponse.md +26 -0
- 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/auto_order_api.rb +58 -0
- data/lib/ultracart_api/api/fraud_api.rb +373 -0
- data/lib/ultracart_api/models/auto_order_cancel_reason.rb +240 -0
- data/lib/ultracart_api/models/auto_order_cancel_reasons_response.rb +259 -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 +14 -0
- metadata +30 -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:
|
|
@@ -90,6 +90,7 @@ Class | Method | HTTP request | Description
|
|
|
90
90
|
*UltracartClient::AutoOrderApi* | [**get_auto_order**](docs/AutoOrderApi.md#get_auto_order) | **GET** /auto_order/auto_orders/{auto_order_oid} | Retrieve an auto order by oid
|
|
91
91
|
*UltracartClient::AutoOrderApi* | [**get_auto_order_by_code**](docs/AutoOrderApi.md#get_auto_order_by_code) | **GET** /auto_order/auto_orders/code/{auto_order_code} | Retrieve an auto order by code
|
|
92
92
|
*UltracartClient::AutoOrderApi* | [**get_auto_order_by_reference_order_id**](docs/AutoOrderApi.md#get_auto_order_by_reference_order_id) | **GET** /auto_order/auto_orders/reference_order_id/{reference_order_id} | Retrieve an auto order by order id
|
|
93
|
+
*UltracartClient::AutoOrderApi* | [**get_auto_order_cancel_reasons**](docs/AutoOrderApi.md#get_auto_order_cancel_reasons) | **GET** /auto_order/auto_orders/cancel_reasons | Retrieve auto order cancel reasons.
|
|
93
94
|
*UltracartClient::AutoOrderApi* | [**get_auto_order_emails**](docs/AutoOrderApi.md#get_auto_order_emails) | **GET** /auto_order/auto_orders/{auto_order_oid}/emails | Retrieve email delivery information for this auto order.
|
|
94
95
|
*UltracartClient::AutoOrderApi* | [**get_auto_orders**](docs/AutoOrderApi.md#get_auto_orders) | **GET** /auto_order/auto_orders | Retrieve auto orders
|
|
95
96
|
*UltracartClient::AutoOrderApi* | [**get_auto_orders_batch**](docs/AutoOrderApi.md#get_auto_orders_batch) | **POST** /auto_order/auto_orders/batch | Retrieve auto order batch
|
|
@@ -352,6 +353,11 @@ Class | Method | HTTP request | Description
|
|
|
352
353
|
*UltracartClient::DatawarehouseApi* | [**update_custom_report**](docs/DatawarehouseApi.md#update_custom_report) | **PUT** /datawarehouse/custom_reports/{custom_report_oid} | Update a custom report
|
|
353
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
|
|
354
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
|
|
355
361
|
*UltracartClient::FulfillmentApi* | [**acknowledge_orders**](docs/FulfillmentApi.md#acknowledge_orders) | **PUT** /fulfillment/distribution_centers/{distribution_center_code}/acknowledgements | Acknowledge receipt of orders.
|
|
356
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.
|
|
357
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.
|
|
@@ -715,6 +721,8 @@ Class | Method | HTTP request | Description
|
|
|
715
721
|
- [UltracartClient::AutoOrderAddonItem](docs/AutoOrderAddonItem.md)
|
|
716
722
|
- [UltracartClient::AutoOrderAddonItemOption](docs/AutoOrderAddonItemOption.md)
|
|
717
723
|
- [UltracartClient::AutoOrderAddonItemsUpdateRequest](docs/AutoOrderAddonItemsUpdateRequest.md)
|
|
724
|
+
- [UltracartClient::AutoOrderCancelReason](docs/AutoOrderCancelReason.md)
|
|
725
|
+
- [UltracartClient::AutoOrderCancelReasonsResponse](docs/AutoOrderCancelReasonsResponse.md)
|
|
718
726
|
- [UltracartClient::AutoOrderConsolidate](docs/AutoOrderConsolidate.md)
|
|
719
727
|
- [UltracartClient::AutoOrderEmail](docs/AutoOrderEmail.md)
|
|
720
728
|
- [UltracartClient::AutoOrderEmailsResponse](docs/AutoOrderEmailsResponse.md)
|
|
@@ -1270,6 +1278,17 @@ Class | Method | HTTP request | Description
|
|
|
1270
1278
|
- [UltracartClient::FileManagerPageResponse](docs/FileManagerPageResponse.md)
|
|
1271
1279
|
- [UltracartClient::FileManagerUploadRequest](docs/FileManagerUploadRequest.md)
|
|
1272
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)
|
|
1273
1292
|
- [UltracartClient::FulfillmentInventory](docs/FulfillmentInventory.md)
|
|
1274
1293
|
- [UltracartClient::FulfillmentShipment](docs/FulfillmentShipment.md)
|
|
1275
1294
|
- [UltracartClient::GeoPoint](docs/GeoPoint.md)
|
|
@@ -1710,6 +1729,8 @@ Class | Method | HTTP request | Description
|
|
|
1710
1729
|
- coupon_write: Allows you to write coupon information.
|
|
1711
1730
|
- customer_read: Allows you to read customer information.
|
|
1712
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.
|
|
1713
1734
|
- fulfillment_read: Allows you to read fulfillment information.
|
|
1714
1735
|
- fulfillment_write: Allows you to write fulfillment information.
|
|
1715
1736
|
- gift_certificate_read: Allows you to read gift certificate information.
|
|
@@ -1748,6 +1769,9 @@ Not every change is committed to every SDK.
|
|
|
1748
1769
|
|
|
1749
1770
|
| Version | Date | Comments |
|
|
1750
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 |
|
|
1774
|
+
| 4.1.92 | 05/26/2026 | AutoOrderApi.getAutoOrderCancelReasons |
|
|
1751
1775
|
| 4.1.91 | 05/18/2026 | ChannelPartner - support creation_dts on import of a store_completed (historical) order |
|
|
1752
1776
|
| 4.1.90 | 05/13/2026 | webhook rest api - new method getWebhookEventCategories |
|
|
1753
1777
|
| 4.1.89 | 05/11/2026 | auto order item level webhooks - cancel scheduled, cancel, pause, reactive, and unpause |
|
data/docs/AutoOrderApi.md
CHANGED
|
@@ -10,6 +10,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
|
|
|
10
10
|
| [**get_auto_order**](AutoOrderApi.md#get_auto_order) | **GET** /auto_order/auto_orders/{auto_order_oid} | Retrieve an auto order by oid |
|
|
11
11
|
| [**get_auto_order_by_code**](AutoOrderApi.md#get_auto_order_by_code) | **GET** /auto_order/auto_orders/code/{auto_order_code} | Retrieve an auto order by code |
|
|
12
12
|
| [**get_auto_order_by_reference_order_id**](AutoOrderApi.md#get_auto_order_by_reference_order_id) | **GET** /auto_order/auto_orders/reference_order_id/{reference_order_id} | Retrieve an auto order by order id |
|
|
13
|
+
| [**get_auto_order_cancel_reasons**](AutoOrderApi.md#get_auto_order_cancel_reasons) | **GET** /auto_order/auto_orders/cancel_reasons | Retrieve auto order cancel reasons. |
|
|
13
14
|
| [**get_auto_order_emails**](AutoOrderApi.md#get_auto_order_emails) | **GET** /auto_order/auto_orders/{auto_order_oid}/emails | Retrieve email delivery information for this auto order. |
|
|
14
15
|
| [**get_auto_orders**](AutoOrderApi.md#get_auto_orders) | **GET** /auto_order/auto_orders | Retrieve auto orders |
|
|
15
16
|
| [**get_auto_orders_batch**](AutoOrderApi.md#get_auto_orders_batch) | **POST** /auto_order/auto_orders/batch | Retrieve auto order batch |
|
|
@@ -567,6 +568,57 @@ end
|
|
|
567
568
|
- **Accept**: application/json
|
|
568
569
|
|
|
569
570
|
|
|
571
|
+
## get_auto_order_cancel_reasons
|
|
572
|
+
|
|
573
|
+
> <AutoOrderCancelReasonsResponse> get_auto_order_cancel_reasons
|
|
574
|
+
|
|
575
|
+
Retrieve auto order cancel reasons.
|
|
576
|
+
|
|
577
|
+
Retrieves auto order cancel reasons.
|
|
578
|
+
|
|
579
|
+
|
|
580
|
+
### Examples
|
|
581
|
+
|
|
582
|
+
|
|
583
|
+
(No example for this operation).
|
|
584
|
+
|
|
585
|
+
|
|
586
|
+
#### Using the get_auto_order_cancel_reasons_with_http_info variant
|
|
587
|
+
|
|
588
|
+
This returns an Array which contains the response data, status code and headers.
|
|
589
|
+
|
|
590
|
+
> <Array(<AutoOrderCancelReasonsResponse>, Integer, Hash)> get_auto_order_cancel_reasons_with_http_info
|
|
591
|
+
|
|
592
|
+
```ruby
|
|
593
|
+
begin
|
|
594
|
+
# Retrieve auto order cancel reasons.
|
|
595
|
+
data, status_code, headers = api_instance.get_auto_order_cancel_reasons_with_http_info
|
|
596
|
+
p status_code # => 2xx
|
|
597
|
+
p headers # => { ... }
|
|
598
|
+
p data # => <AutoOrderCancelReasonsResponse>
|
|
599
|
+
rescue UltracartClient::ApiError => e
|
|
600
|
+
puts "Error when calling AutoOrderApi->get_auto_order_cancel_reasons_with_http_info: #{e}"
|
|
601
|
+
end
|
|
602
|
+
```
|
|
603
|
+
|
|
604
|
+
### Parameters
|
|
605
|
+
|
|
606
|
+
This endpoint does not need any parameter.
|
|
607
|
+
|
|
608
|
+
### Return type
|
|
609
|
+
|
|
610
|
+
[**AutoOrderCancelReasonsResponse**](AutoOrderCancelReasonsResponse.md)
|
|
611
|
+
|
|
612
|
+
### Authorization
|
|
613
|
+
|
|
614
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
615
|
+
|
|
616
|
+
### HTTP request headers
|
|
617
|
+
|
|
618
|
+
- **Content-Type**: Not defined
|
|
619
|
+
- **Accept**: application/json
|
|
620
|
+
|
|
621
|
+
|
|
570
622
|
## get_auto_order_emails
|
|
571
623
|
|
|
572
624
|
> <AutoOrderEmailsResponse> get_auto_order_emails(auto_order_oid)
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# UltracartClient::AutoOrderCancelReason
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **myaccount_alternate_description** | **String** | MyAccount alternate description | [optional] |
|
|
8
|
+
| **reason** | **String** | Auto order cancel reason | [optional] |
|
|
9
|
+
| **visible_in_myaccount** | **Boolean** | Visible in MyAccount | [optional] |
|
|
10
|
+
|
|
11
|
+
## Example
|
|
12
|
+
|
|
13
|
+
```ruby
|
|
14
|
+
require 'ultracart_api'
|
|
15
|
+
|
|
16
|
+
instance = UltracartClient::AutoOrderCancelReason.new(
|
|
17
|
+
myaccount_alternate_description: null,
|
|
18
|
+
reason: null,
|
|
19
|
+
visible_in_myaccount: null
|
|
20
|
+
)
|
|
21
|
+
```
|
|
22
|
+
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# UltracartClient::AutoOrderCancelReasonsResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **cancel_reasons** | [**Array<AutoOrderCancelReason>**](AutoOrderCancelReason.md) | cancel_reasons | [optional] |
|
|
8
|
+
| **error** | [**Error**](Error.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::AutoOrderCancelReasonsResponse.new(
|
|
19
|
+
cancel_reasons: null,
|
|
20
|
+
error: null,
|
|
21
|
+
metadata: null,
|
|
22
|
+
success: null,
|
|
23
|
+
warning: null
|
|
24
|
+
)
|
|
25
|
+
```
|
|
26
|
+
|
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
|
+
|