growwer 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9a0c49ac33e995f010044b32e3655251e8ff84e3828755d9c6799f8e1d14789d
-  data.tar.gz: 846c087bce80fb8d64e0e63af63e14f46b00ba48b12d307aa127c277ab215421
+  metadata.gz: 4380ca0026577125ae52235ddb4841b963468594c5dc67befb9201eb320f8b72
+  data.tar.gz: faa7964ac0ac85851e666fa4aff9ce4a912b5b3726c0bc56afa4a72435c7d4e5
 SHA512:
-  metadata.gz: 5ed381c6f3d9e38bbd1608309229fe250f612587aab80e67c89b0d134a185176395830cbc46f02b639c2decfc50c55f5b63de09577e03d590191f41d7d911dcc
-  data.tar.gz: 672a595a2069af8b7fb59617d5d80231c34f6ffcd4eb7ed82cf53ba42b6334d51853f0421f81f746a6e64d8c5e5971e9b95556b06e9ea0a752f3f1aba2acadf5
+  metadata.gz: d78a77e4694c8155ccbdfabb7fabb1198d2a8e2c596f943c277a33ba488700d857552eb8e30572d3796419b96efdbf12e8c43334586f631e885cb63cbb8b8733
+  data.tar.gz: 98aaec4222d6607582a8f8e3dd7953bcda516c40ce21ee05745ebdfeb49f0eadbc7994a1caf0216df936a571a94f8bfcdf0886016081a4b3ab1d5f32566ed680

data/README.md

@@ -25,6 +25,29 @@ operation. Keys belong to your account, not to one API key.
   409 `idempotency_key_reused`. A write without the header gets 400
   `idempotency_key_required`.
 
+Test mode: a test key (`gw_sk_test_` plus 43 characters) works on your
+account's test data alone, apart from the real catalogue: test projects,
+orders and files, and a test wallet that starts at 1,000.00 EUR. Every
+response to a test key carries `Growwer-Mode: test`, and an id of the other
+mode answers 404 as a missing object would.
+- A test order is validated and debited from the test wallet as a live one
+  is. A simulated seller accepts it a minute later and delivers it two
+  minutes after that; you approve the delivery or request an update.
+- The Test helpers top the test wallet up, move a test order on at once and
+  reset your test data. A live key on them gets 403 `test_mode_only`.
+- A test key on the seller and managed service operations, on a project's
+  catalogue writes and on media requests gets 403
+  `not_available_in_test_mode`.
+- Idempotency keys are scoped per mode: the same `Idempotency-Key` sent with
+  a live and a test key never replays the other mode's response.
+
+Webhooks: a subscription receives the events of its mode, signed as Standard
+Webhooks. A subscription created with a live key gets the events of your
+orders and your wallet; one created with a test key gets those of your test
+orders and test wallet, with `mode: test`, and never a live event.
+`x-webhooks` lists every event Growwer POSTs and its payload; the
+WebhookEvent schema describes the headers, the signature and the retries.
+
 Every response carries `X-Request-Id`. Errors share one shape,
 `{code, message, requestId, details?}`. Money is integer cents plus a
 currency code and dates are ISO-8601.
@@ -33,7 +56,7 @@ currency code and dates are ISO-8601.
 This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: 1
-- Package version: 2.0.0
+- Package version: 2.1.0
 - Generator version: 7.24.0
 - Build package: org.openapitools.codegen.languages.RubyClientCodegen
 For more information, please visit [https://growwer.com/contact/](https://growwer.com/contact/)
@@ -51,16 +74,16 @@ gem build growwer.gemspec
 Then either install the gem locally:
 
 ```shell
-gem install ./growwer-2.0.0.gem
+gem install ./growwer-2.1.0.gem
 ```
 
-(for development, run `gem install --dev ./growwer-2.0.0.gem` to install the development dependencies)
+(for development, run `gem install --dev ./growwer-2.1.0.gem` to install the development dependencies)
 
 or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
 
 Finally add this to the Gemfile:
 
-    gem 'growwer', '~> 2.0.0'
+    gem 'growwer', '~> 2.1.0'
 
 ### Install from Git
 
@@ -180,11 +203,26 @@ Class | Method | HTTP request | Description
 *Growwer::SellerWalletApi* | [**get_seller_wallet**](docs/SellerWalletApi.md#get_seller_wallet) | **GET** /api/v1/wallets/seller | Get your seller wallet
 *Growwer::SellerWalletApi* | [**list_seller_transactions**](docs/SellerWalletApi.md#list_seller_transactions) | **GET** /api/v1/wallets/seller/transactions | List your seller wallet movements
 *Growwer::SellerWalletApi* | [**list_withdrawals**](docs/SellerWalletApi.md#list_withdrawals) | **GET** /api/v1/withdrawals | List your withdrawals
+*Growwer::TestHelpersApi* | [**advance_test_order**](docs/TestHelpersApi.md#advance_test_order) | **POST** /api/v1/test-helpers/orders/{id}/advance | Advance a test order
+*Growwer::TestHelpersApi* | [**reset_test_data**](docs/TestHelpersApi.md#reset_test_data) | **POST** /api/v1/test-helpers/reset | Reset your test data
+*Growwer::TestHelpersApi* | [**top_up_test_wallet**](docs/TestHelpersApi.md#top_up_test_wallet) | **POST** /api/v1/test-helpers/wallet/top-up | Top up your test wallet
+*Growwer::WebhooksApi* | [**create_webhook**](docs/WebhooksApi.md#create_webhook) | **POST** /api/v1/webhooks | Create a webhook subscription
+*Growwer::WebhooksApi* | [**delete_webhook**](docs/WebhooksApi.md#delete_webhook) | **DELETE** /api/v1/webhooks/{id} | Delete a webhook subscription
+*Growwer::WebhooksApi* | [**get_webhook**](docs/WebhooksApi.md#get_webhook) | **GET** /api/v1/webhooks/{id} | Get a webhook subscription
+*Growwer::WebhooksApi* | [**list_webhook_deliveries**](docs/WebhooksApi.md#list_webhook_deliveries) | **GET** /api/v1/webhooks/{id}/deliveries | List the deliveries of a webhook subscription
+*Growwer::WebhooksApi* | [**list_webhooks**](docs/WebhooksApi.md#list_webhooks) | **GET** /api/v1/webhooks | List your webhook subscriptions
+*Growwer::WebhooksApi* | [**redeliver_webhook**](docs/WebhooksApi.md#redeliver_webhook) | **POST** /api/v1/webhooks/{id}/deliveries/{deliveryId}/redeliver | Redeliver a webhook event
+*Growwer::WebhooksApi* | [**rotate_webhook_secret**](docs/WebhooksApi.md#rotate_webhook_secret) | **POST** /api/v1/webhooks/{id}/rotate-secret | Rotate a webhook secret
+*Growwer::WebhooksApi* | [**send_webhook_test**](docs/WebhooksApi.md#send_webhook_test) | **POST** /api/v1/webhooks/{id}/test | Send a test event
+*Growwer::WebhooksApi* | [**update_webhook**](docs/WebhooksApi.md#update_webhook) | **PATCH** /api/v1/webhooks/{id} | Edit a webhook subscription
 
 
 ## Documentation for Models
 
+ - [Growwer::AdvanceTestOrderRequest](docs/AdvanceTestOrderRequest.md)
  - [Growwer::Balance](docs/Balance.md)
+ - [Growwer::BalanceLowEventData](docs/BalanceLowEventData.md)
+ - [Growwer::BalanceLowEventDataWallet](docs/BalanceLowEventDataWallet.md)
  - [Growwer::CatalogueMedia](docs/CatalogueMedia.md)
  - [Growwer::CatalogueMediaFlashOffer](docs/CatalogueMediaFlashOffer.md)
  - [Growwer::CatalogueMediaMetrics](docs/CatalogueMediaMetrics.md)
@@ -199,6 +237,7 @@ Class | Method | HTTP request | Description
  - [Growwer::CreateSavedFilterRequest](docs/CreateSavedFilterRequest.md)
  - [Growwer::CreateSellerMediaRequest](docs/CreateSellerMediaRequest.md)
  - [Growwer::CreateSellerMediaRequestPostOffer](docs/CreateSellerMediaRequestPostOffer.md)
+ - [Growwer::CreateWebhookRequest](docs/CreateWebhookRequest.md)
  - [Growwer::Error](docs/Error.md)
  - [Growwer::GetBuyerWallet200Response](docs/GetBuyerWallet200Response.md)
  - [Growwer::GetMe200Response](docs/GetMe200Response.md)
@@ -223,6 +262,8 @@ Class | Method | HTTP request | Description
  - [Growwer::ListSellerMedias200Response](docs/ListSellerMedias200Response.md)
  - [Growwer::ListSellerOrders200Response](docs/ListSellerOrders200Response.md)
  - [Growwer::ListSellerTransactions200Response](docs/ListSellerTransactions200Response.md)
+ - [Growwer::ListWebhookDeliveries200Response](docs/ListWebhookDeliveries200Response.md)
+ - [Growwer::ListWebhooks200Response](docs/ListWebhooks200Response.md)
  - [Growwer::ListWithdrawals200Response](docs/ListWithdrawals200Response.md)
  - [Growwer::ManagedServiceCampaign](docs/ManagedServiceCampaign.md)
  - [Growwer::ManagedServiceCampaignProject](docs/ManagedServiceCampaignProject.md)
@@ -251,6 +292,7 @@ Class | Method | HTTP request | Description
  - [Growwer::OrderEstimate](docs/OrderEstimate.md)
  - [Growwer::OrderEstimateRequest](docs/OrderEstimateRequest.md)
  - [Growwer::OrderEstimateRequestBriefing](docs/OrderEstimateRequestBriefing.md)
+ - [Growwer::OrderEventData](docs/OrderEventData.md)
  - [Growwer::OrderLink](docs/OrderLink.md)
  - [Growwer::OrderLinkRequest](docs/OrderLinkRequest.md)
  - [Growwer::OrderMedia](docs/OrderMedia.md)
@@ -289,6 +331,8 @@ Class | Method | HTTP request | Description
  - [Growwer::SellerOrderRejectionReason](docs/SellerOrderRejectionReason.md)
  - [Growwer::SellerPostOrderBriefing](docs/SellerPostOrderBriefing.md)
  - [Growwer::SellerTransaction](docs/SellerTransaction.md)
+ - [Growwer::TopUpTestWallet200Response](docs/TopUpTestWallet200Response.md)
+ - [Growwer::TopUpTestWalletRequest](docs/TopUpTestWalletRequest.md)
  - [Growwer::Transaction](docs/Transaction.md)
  - [Growwer::UpdateProjectRequest](docs/UpdateProjectRequest.md)
  - [Growwer::UpdateSellerMediaRequest](docs/UpdateSellerMediaRequest.md)
@@ -297,7 +341,16 @@ Class | Method | HTTP request | Description
  - [Growwer::UpdateSellerMediaRequestLinkAdditionOfferPricingOptionsInner](docs/UpdateSellerMediaRequestLinkAdditionOfferPricingOptionsInner.md)
  - [Growwer::UpdateSellerMediaRequestPostOffer](docs/UpdateSellerMediaRequestPostOffer.md)
  - [Growwer::UpdateSellerMediaRequestPostOfferPricingOptionsInner](docs/UpdateSellerMediaRequestPostOfferPricingOptionsInner.md)
+ - [Growwer::UpdateWebhookRequest](docs/UpdateWebhookRequest.md)
  - [Growwer::UploadFile201Response](docs/UploadFile201Response.md)
+ - [Growwer::Webhook](docs/Webhook.md)
+ - [Growwer::WebhookDelivery](docs/WebhookDelivery.md)
+ - [Growwer::WebhookDeliveryAttempt](docs/WebhookDeliveryAttempt.md)
+ - [Growwer::WebhookEvent](docs/WebhookEvent.md)
+ - [Growwer::WebhookEventData](docs/WebhookEventData.md)
+ - [Growwer::WebhookEventType](docs/WebhookEventType.md)
+ - [Growwer::WebhookTestEventData](docs/WebhookTestEventData.md)
+ - [Growwer::WebhookWithSecret](docs/WebhookWithSecret.md)
  - [Growwer::Withdrawal](docs/Withdrawal.md)
 
 

data/docs/AccountApi.md

@@ -14,7 +14,7 @@ All URIs are relative to *https://tool.growwer.com*
 
 Your account
 
-Profile basics, the buyer and seller balances, whether your seller account is restricted, whether the catalogue is open to you, and whether you have a managed service.
+Profile basics, the buyer and seller balances, whether your seller account is restricted, whether the catalogue is open to you, whether you have a managed service, and whether the key you called with is live or test. A test key reads its test wallet as the buyer balance (1,000.00 EUR until test orders and top-ups move it), never your real balance, and no seller side.
 
 ### Examples
 

data/docs/AdvanceTestOrderRequest.md

@@ -0,0 +1,18 @@
+# Growwer::AdvanceTestOrderRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **to** | **String** | The state to move the test order to. |  |
+
+## Example
+
+```ruby
+require 'growwer'
+
+instance = Growwer::AdvanceTestOrderRequest.new(
+  to: null
+)
+```
+

data/docs/BalanceLowEventData.md

@@ -0,0 +1,20 @@
+# Growwer::BalanceLowEventData
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **wallet** | [**BalanceLowEventDataWallet**](BalanceLowEventDataWallet.md) |  |  |
+| **threshold** | [**Money**](Money.md) | The subscription's `lowBalanceThreshold` that the balance dropped below. |  |
+
+## Example
+
+```ruby
+require 'growwer'
+
+instance = Growwer::BalanceLowEventData.new(
+  wallet: null,
+  threshold: null
+)
+```
+

data/docs/BalanceLowEventDataWallet.md

@@ -0,0 +1,20 @@
+# Growwer::BalanceLowEventDataWallet
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **available_balance** | [**Money**](Money.md) |  |  |
+| **currency** | **String** | The currency of the wallet. |  |
+
+## Example
+
+```ruby
+require 'growwer'
+
+instance = Growwer::BalanceLowEventDataWallet.new(
+  available_balance: null,
+  currency: EUR
+)
+```
+

data/docs/CatalogueApi.md

@@ -592,7 +592,7 @@ end
 
 Restore a discarded media for a project
 
-Restores a media you discarded for one of your projects. Restoring one that is not discarded changes nothing. It works for any media, even one the catalogue no longer shows.
+Restores a media you discarded for one of your projects. Restoring one that is not discarded, or an id no media has, changes nothing and answers the same. It works for any media, even one the catalogue no longer shows.
 
 ### Examples
 
@@ -664,7 +664,7 @@ nil (empty response body)
 
 Remove a media from the favourites of a project
 
-Removes a media from the favourites of one of your projects. Removing one that is not a favourite changes nothing. It works for any media, even one the catalogue no longer shows.
+Removes a media from the favourites of one of your projects. Removing one that is not a favourite, or an id no media has, changes nothing and answers the same. It works for any media, even one the catalogue no longer shows.
 
 ### Examples
 

data/docs/CreateWebhookRequest.md

@@ -0,0 +1,24 @@
+# Growwer::CreateWebhookRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **url** | **String** | An HTTPS URL of at most 2048 characters, without a backslash or credentials. Its host is an IP address or a domain name of two labels or more, such as hooks.example.com, with one trailing dot allowed; a single-label host such as localhost is refused (`validation_failed` on `url`). The host is checked, and resolved at each delivery, in lower case and with a Unicode name in punycode, the form a delivery connects to. |  |
+| **events** | [**Array<WebhookEventType>**](WebhookEventType.md) | The events to send, at least one. |  |
+| **low_balance_threshold** | [**Money**](Money.md) | With `balance.low`: the available buyer balance below which the event fires, in EUR. | [optional] |
+| **description** | **String** | A note of yours, at most 255 characters. | [optional] |
+
+## Example
+
+```ruby
+require 'growwer'
+
+instance = Growwer::CreateWebhookRequest.new(
+  url: null,
+  events: null,
+  low_balance_threshold: null,
+  description: null
+)
+```
+

data/docs/GetMe200Response.md

@@ -13,6 +13,7 @@
 | **seller** | [**GetMe200ResponseSeller**](GetMe200ResponseSeller.md) |  |  |
 | **catalogue** | [**GetMe200ResponseCatalogue**](GetMe200ResponseCatalogue.md) |  |  |
 | **managed_service** | [**GetMe200ResponseManagedService**](GetMe200ResponseManagedService.md) |  |  |
+| **mode** | **String** | The mode of the key you called with. `live` works on your real account; `test` works in test mode, where nothing you do reaches real sellers, money or orders. Every response to a test key also carries the header `Growwer-Mode: test`. |  |
 
 ## Example
 
@@ -28,7 +29,8 @@ instance = Growwer::GetMe200Response.new(
   buyer: null,
   seller: null,
   catalogue: null,
-  managed_service: null
+  managed_service: null,
+  mode: null
 )
 ```
 

data/docs/ListWebhookDeliveries200Response.md

@@ -0,0 +1,20 @@
+# Growwer::ListWebhookDeliveries200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **items** | [**Array<WebhookDelivery>**](WebhookDelivery.md) |  |  |
+| **total** | **Integer** |  |  |
+
+## Example
+
+```ruby
+require 'growwer'
+
+instance = Growwer::ListWebhookDeliveries200Response.new(
+  items: null,
+  total: null
+)
+```
+

data/docs/ListWebhooks200Response.md

@@ -0,0 +1,20 @@
+# Growwer::ListWebhooks200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **items** | [**Array<Webhook>**](Webhook.md) |  |  |
+| **total** | **Integer** |  |  |
+
+## Example
+
+```ruby
+require 'growwer'
+
+instance = Growwer::ListWebhooks200Response.new(
+  items: null,
+  total: null
+)
+```
+

data/docs/OrderEventData.md

@@ -0,0 +1,18 @@
+# Growwer::OrderEventData
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **order** | [**Order**](Order.md) |  |  |
+
+## Example
+
+```ruby
+require 'growwer'
+
+instance = Growwer::OrderEventData.new(
+  order: null
+)
+```
+

data/docs/TestHelpersApi.md

@@ -0,0 +1,222 @@
+# Growwer::TestHelpersApi
+
+All URIs are relative to *https://tool.growwer.com*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**advance_test_order**](TestHelpersApi.md#advance_test_order) | **POST** /api/v1/test-helpers/orders/{id}/advance | Advance a test order |
+| [**reset_test_data**](TestHelpersApi.md#reset_test_data) | **POST** /api/v1/test-helpers/reset | Reset your test data |
+| [**top_up_test_wallet**](TestHelpersApi.md#top_up_test_wallet) | **POST** /api/v1/test-helpers/wallet/top-up | Top up your test wallet |
+
+
+## advance_test_order
+
+> <Order> advance_test_order(id, idempotency_key, advance_test_order_request)
+
+Advance a test order
+
+Test keys only. Moves one of your test orders at once to `to`, without waiting for the simulated seller: `accepted` or `rejected` (by the seller, from `pending_acceptance`), `draft_delivered` (the sample draft, from `pending_draft` or `pending_draft_update`), `draft_update_requested` (as if you sent the draft back, from `pending_draft_review`), `published` (delivered for your review, from `pending_order_delivery`, `scheduled` or `pending_order_delivery_update`), `update_requested` (as if you sent the delivery back, from `pending_order_delivery_review`) or `cancelled_by_growwer` (from any state that is not finished). The order and your test wallet change as that move changes them live, a rejection or a cancellation refunding the price, and the simulated seller carries on from the new state. A post with a future `scheduledPublicationDate` waits in `scheduled` until that date once the simulated seller delivers it; `published` skips the wait. A target its state does not allow answers 409 `invalid_transition` with the targets it allows. A live key gets 403 `test_mode_only`.
+
+### Examples
+
+```ruby
+require 'time'
+require 'growwer'
+# setup authorization
+Growwer.configure do |config|
+  # Configure Bearer authorization: apiKey
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Growwer::TestHelpersApi.new
+id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+idempotency_key = 'idempotency_key_example' # String | A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (`!` to `~`); any other value answers 400 `invalid_idempotency_key`.
+advance_test_order_request = Growwer::AdvanceTestOrderRequest.new({to: 'accepted'}) # AdvanceTestOrderRequest | 
+
+begin
+  # Advance a test order
+  result = api_instance.advance_test_order(id, idempotency_key, advance_test_order_request)
+  p result
+rescue Growwer::ApiError => e
+  puts "Error when calling TestHelpersApi->advance_test_order: #{e}"
+end
+```
+
+#### Using the advance_test_order_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<Order>, Integer, Hash)> advance_test_order_with_http_info(id, idempotency_key, advance_test_order_request)
+
+```ruby
+begin
+  # Advance a test order
+  data, status_code, headers = api_instance.advance_test_order_with_http_info(id, idempotency_key, advance_test_order_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <Order>
+rescue Growwer::ApiError => e
+  puts "Error when calling TestHelpersApi->advance_test_order_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+| **idempotency_key** | **String** | A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (&#x60;!&#x60; to &#x60;~&#x60;); any other value answers 400 &#x60;invalid_idempotency_key&#x60;. |  |
+| **advance_test_order_request** | [**AdvanceTestOrderRequest**](AdvanceTestOrderRequest.md) |  |  |
+
+### Return type
+
+[**Order**](Order.md)
+
+### Authorization
+
+[apiKey](../README.md#apiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## reset_test_data
+
+> reset_test_data(idempotency_key)
+
+Reset your test data
+
+Test keys only. Deletes your test projects, orders and uploaded test files, and returns your test wallet to its opening balance of 1,000.00 EUR with no movements. Your API keys and webhook subscriptions stay, and nothing of your live account changes. It takes no body. A live key gets 403 `test_mode_only`.
+
+### Examples
+
+```ruby
+require 'time'
+require 'growwer'
+# setup authorization
+Growwer.configure do |config|
+  # Configure Bearer authorization: apiKey
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Growwer::TestHelpersApi.new
+idempotency_key = 'idempotency_key_example' # String | A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (`!` to `~`); any other value answers 400 `invalid_idempotency_key`.
+
+begin
+  # Reset your test data
+  api_instance.reset_test_data(idempotency_key)
+rescue Growwer::ApiError => e
+  puts "Error when calling TestHelpersApi->reset_test_data: #{e}"
+end
+```
+
+#### Using the reset_test_data_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> reset_test_data_with_http_info(idempotency_key)
+
+```ruby
+begin
+  # Reset your test data
+  data, status_code, headers = api_instance.reset_test_data_with_http_info(idempotency_key)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue Growwer::ApiError => e
+  puts "Error when calling TestHelpersApi->reset_test_data_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **idempotency_key** | **String** | A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (&#x60;!&#x60; to &#x60;~&#x60;); any other value answers 400 &#x60;invalid_idempotency_key&#x60;. |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[apiKey](../README.md#apiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## top_up_test_wallet
+
+> <TopUpTestWallet200Response> top_up_test_wallet(idempotency_key, top_up_test_wallet_request)
+
+Top up your test wallet
+
+Test keys only. Credits your test wallet, the buyer wallet a test key spends from, with fictitious money: more than nothing and at most 10,000.00 EUR per call. It never touches your real wallets, takes no payment and issues no invoice; the movement shows in GET /wallets/buyer/transactions for a test key as a confirmed `deposit`. A live key gets 403 `test_mode_only`.
+
+### Examples
+
+```ruby
+require 'time'
+require 'growwer'
+# setup authorization
+Growwer.configure do |config|
+  # Configure Bearer authorization: apiKey
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Growwer::TestHelpersApi.new
+idempotency_key = 'idempotency_key_example' # String | A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (`!` to `~`); any other value answers 400 `invalid_idempotency_key`.
+top_up_test_wallet_request = Growwer::TopUpTestWalletRequest.new({amount: Growwer::Money.new({amount: 12500, currency: 'EUR'})}) # TopUpTestWalletRequest | 
+
+begin
+  # Top up your test wallet
+  result = api_instance.top_up_test_wallet(idempotency_key, top_up_test_wallet_request)
+  p result
+rescue Growwer::ApiError => e
+  puts "Error when calling TestHelpersApi->top_up_test_wallet: #{e}"
+end
+```
+
+#### Using the top_up_test_wallet_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<TopUpTestWallet200Response>, Integer, Hash)> top_up_test_wallet_with_http_info(idempotency_key, top_up_test_wallet_request)
+
+```ruby
+begin
+  # Top up your test wallet
+  data, status_code, headers = api_instance.top_up_test_wallet_with_http_info(idempotency_key, top_up_test_wallet_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <TopUpTestWallet200Response>
+rescue Growwer::ApiError => e
+  puts "Error when calling TestHelpersApi->top_up_test_wallet_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **idempotency_key** | **String** | A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (&#x60;!&#x60; to &#x60;~&#x60;); any other value answers 400 &#x60;invalid_idempotency_key&#x60;. |  |
+| **top_up_test_wallet_request** | [**TopUpTestWalletRequest**](TopUpTestWalletRequest.md) |  |  |
+
+### Return type
+
+[**TopUpTestWallet200Response**](TopUpTestWallet200Response.md)
+
+### Authorization
+
+[apiKey](../README.md#apiKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+

data/docs/TopUpTestWallet200Response.md

@@ -0,0 +1,20 @@
+# Growwer::TopUpTestWallet200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **balance** | [**Balance**](Balance.md) |  |  |
+| **top_up_url** | **String** | The wallet page where a live buyer tops up, as GET /wallets/buyer gives it. |  |
+
+## Example
+
+```ruby
+require 'growwer'
+
+instance = Growwer::TopUpTestWallet200Response.new(
+  balance: null,
+  top_up_url: null
+)
+```
+

data/docs/TopUpTestWalletRequest.md

@@ -0,0 +1,18 @@
+# Growwer::TopUpTestWalletRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **amount** | [**Money**](Money.md) | What to credit, in EUR: from 1 to 1000000 cents. |  |
+
+## Example
+
+```ruby
+require 'growwer'
+
+instance = Growwer::TopUpTestWalletRequest.new(
+  amount: null
+)
+```
+

data/docs/UpdateWebhookRequest.md

@@ -0,0 +1,26 @@
+# Growwer::UpdateWebhookRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **url** | **String** | An HTTPS URL of at most 2048 characters, without a backslash or credentials. Its host is an IP address or a domain name of two labels or more, such as hooks.example.com, with one trailing dot allowed; a single-label host such as localhost is refused (`validation_failed` on `url`). The host is checked, and resolved at each delivery, in lower case and with a Unicode name in punycode, the form a delivery connects to. | [optional] |
+| **events** | [**Array<WebhookEventType>**](WebhookEventType.md) | The events to send, at least one; replaces the list. | [optional] |
+| **low_balance_threshold** | [**MoneyOrNull**](MoneyOrNull.md) | With `balance.low`: the available buyer balance below which the event fires, in EUR. Null removes it. | [optional] |
+| **description** | **String** | A note of yours, at most 255 characters. Null removes it. | [optional] |
+| **enabled** | **Boolean** | Whether the subscription gets events. | [optional] |
+
+## Example
+
+```ruby
+require 'growwer'
+
+instance = Growwer::UpdateWebhookRequest.new(
+  url: null,
+  events: null,
+  low_balance_threshold: null,
+  description: null,
+  enabled: null
+)
+```
+