bleumi_pay_sdk_ruby 1.0.3 → 1.0.8

data/docs/Payout.md

@@ -5,7 +5,8 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **transfer_address** | **String** | Address of receiver. This address must be able to receive payments from smart contracts. | 
-**amount** | **String** | Amount of token to transfer | 
+**amount** | **String** | Amount of token to transfer |
+**authorization** <br> (Optional)| **String** | (Only for Algorand) Base64 serialization of an encoded LogicSig signed by the source of the payout |
 
 ## Example
 

data/docs/PayoutItem.md

@@ -5,7 +5,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **txid** | **String** | Unique identifier for this payout | 
-**status** | **Boolean** | <b>null</b> - Operation in progress </br> <b>true</b> - Operation confirmed by network </br> <b>false</b> - Operation rejected by network </br> |
+**status** | **Boolean** | <b>null</b> - Operation in progress </br> <b>true</b> - Operation confirmed by network </br> <b>false</b> - Operation rejected by network </br> | 
 **hash** | **String** | Transaction hash of the operation submitted to the network. This field is blank when the operation is in progress. | 
 **created_at** | **Integer** | UNIX timestamp when the payout was created | 
 **updated_at** | **Integer** | UNIX timestamp when the lastest operation was performed | 

data/docs/PayoutItemInputs.md

@@ -5,7 +5,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **salt** | **String** | Unique identifier generated for the txid of the payout (specified during Create a Payout). | 
-**token** | **String** | Token used for the payout | 
+**token** | **String** | Token used for the payout | <b>ETH</b> - for Ethereum  <br/> <b>XDAI</b> - for xDai <br/> <b>XDAIT</b> - for xDai Testnet <br/> <b>ALGO</b> - for Algo <br/> <b>&lt;asset id&gt;</b> - for Algorand Standard Asset payouts <br/> <b> &lt;contract address of ERC-20 token&gt;</b> - for ERC-20 payouts; Please refer to [ERC-20 Tokens](https://pay.bleumi.com/docs/#erc-20) for contract address;  | 
 **payouts** | [**Array&lt;Payout&gt;**](Payout.md) | Array of payments to be made in this payout. This is an atomic transaction (i.e. either all payments are processed or all of them are rejected). | 
 
 ## Example

data/docs/PayoutsApi.md

@@ -1,7 +1,6 @@
 # BleumiPay::PayoutsApi
 
-Payouts are available only for the Ethereum network today and require you to set up a Private Payment Processor and link it to your account. Please contact support@bleumi.com if you want to enable payouts for your account.
-
+Payouts are available only for the Ethereum, xDAI and RSK networks today and require you to set up a Private Payment Processor and link it to your account. Please contact support@bleumi.com if you want to enable payouts for your account.
 
 ## create_payout
 
@@ -23,7 +22,7 @@ end
 api_instance = BleumiPay::PayoutsApi.new
 
 opts = {
-  chain: BleumiPay::Chain::ROPSTEN # Chain | Ethereum network in which payment is to be created.
+  chain: BleumiPay::Chain::GOERLI # Chain | Network in which payment is to be created.
 }
 
 begin
@@ -42,14 +41,14 @@ begin
   payouts = [payout1, payout2]
 
   create_payout_request.txid = '<TXID>' # str | Replace with unique payout ID 
-  create_payout_request.token = BleumiPay::Token.new('<TOKEN>') # str | Replace <TOKEN> with Token. Eg. ETH or ECR-20 token contract address or XDAI or XDAIT
+  create_payout_request.token = '<TOKEN>' # str | Replace <TOKEN>  by anyone of the following values: 'ETH' or 'XDAI' or 'XDAIT' or ECR-20 Contract Address or 'RBTC' or RSK ECR-20 Contract Address or 'Asset ID' of Algorand Standard Asset.
   create_payout_request.payouts = payouts # setting the payouts array to the payout create request
   
   #Create a payout.
   result = api_instance.create_payout(create_payout_request, opts)
   p result
 rescue BleumiPay::ApiError => e
-  puts "Exception when calling PayoutsApi->create_payout: #{e}"
+  puts "Exception when calling create_payout: #{e}"
 end
 ```
 
@@ -58,8 +57,9 @@ end
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **create_payout_request** | [**CreatePayoutRequest**](CreatePayoutRequest.md)| Request body - used to specify payout creation parameters. | 
- **chain** | [**Chain**](.md)| Ethereum network in which payment is to be created. Please refer documentation for Supported Networks | [optional] 
+ **create_payout_request** | [**CreatePayoutRequest**](CreatePayoutRequest.md)| Specify payout creation parameters. |
+ **chain** | [**Chain**](Chain.md)| Network in which the payout is to be made. Please refer documentation for [Supported Networks](https://pay.bleumi.com/docs/#supported-networks) |
+
 
 ### Return type
 
@@ -108,7 +108,7 @@ api_instance = BleumiPay::PayoutsApi.new
 opts = {
   next_token: '', # String | Cursor to start results from
   sort_by: '<SORT_BY>', # String | Sort payouts by (optional) | Eg. "createdAt"
-  start_at: '<START_TIMESTAMP>', # String | Get payouts from this timestamp (optional) | Eg. 1546300800 for 1-JAN-2019
+  start_at: '<START_TIMESTAMP>', # String | Get payouts from this timestamp (optional) | Eg. 1577836800 for 1-JAN-2020
   end_at: '' # String | Get payouts till this timestamp (optional) 
 }
 
@@ -117,7 +117,7 @@ begin
   result = api_instance.list_payouts(opts)
   p result
 rescue BleumiPay::ApiError => e
-  puts "Exception when calling PayoutsApi->list_payouts: #{e}"
+  puts "Exception when calling list_payouts: #{e}"
 end
 ```
 
@@ -127,7 +127,7 @@ end
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **next_token** | **String**| Cursor to start results from | [optional] 
- **sort_by** | **String**| Sort payments by | [optional] 
+ **sort_by** | **String**| Sort payouts by | [optional] 'createdAt' - results will be sorted by created time in ascending order. <br>'updatedAt' - results will be sorted by last updated time in ascending order.
  **start_at** | **String**| Get payouts from this timestamp (unix) | [optional] 
  **end_at** | **String**| Get payouts till this timestamp (unix) | [optional] 
 

data/docs/RskAddress.md

@@ -0,0 +1,29 @@
+# BleumiPay::RskAddress
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**rsk** <br> (Optional)| [**Hash&lt;String, EthereumWalletAddress&gt;**](EthereumWalletAddress.md) | A dictionary which gives the address of the wallet generated for Rsk MainNet |
+**rsk_testnet** <br> (Optional)| [**Hash&lt;String, EthereumWalletAddress&gt;**](EthereumWalletAddress.md) | A dictionary which gives the address of the wallet generated for Rsk TestNet | 
+
+## Example
+
+```json
+ {
+    "rsk": {
+        "rsk_testnet": {
+            "0x5db2d6542d55b2aec1f10d0c0df3b0169bf41e41|0x5db2d6542d55b2aec1f10d0c0df3b0169bf41e41": {
+              "inputs": {
+                "salt": "0x5d5fe1e5024cb6e9175da30a963919054db612f2f857cbfe3151747e96267f58",
+                "walletProxy": "0xe5f208073c717c076271b695324112779c6f8820",
+                "walletLibrary": "0x8cdf9b11ad8db65f94197d21d25fbff107cd02de",
+                "buyer": "0x5db2d6542d55b2aec1f10d0c0df3b0169bf41e41",
+                "merchant": "0x5db2d6542d55b2aec1f10d0c0df3b0169bf41e41"
+              },
+              "addr": "0xbe17b427aad1a29bff91e1e85d8324bc34b033b0"
+            }
+          }
+        }
+    }
+```

data/docs/RskBalance.md

@@ -0,0 +1,28 @@
+# BleumiPay::RskBalance
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**rsk** <br>(Optional) | [**Hash&lt;String, WalletBalance&gt;**](WalletBalance.md) | A dictionary which gives the token balances in RSK MainNet  |
+**rsk_testnet** <br>(Optional) | [**Hash&lt;String, WalletBalance&gt;**](WalletBalance.md) | A dictionary which gives the token balances in RSK TestNet  |
+
+## Example - TestNet
+
+```json
+{
+    "balances": {
+        "rsk": {
+            "rsk_testnet": {
+                "0x1efeabf46ca3270a9a41d324350692664f1ea105": {
+                    "blockNum": "889362",
+                    "token_balance": "300",
+                    "balance": "3",
+                    "safety": "high",
+                    "token_decimals": 2
+                }
+            }
+        }
+    }
+}
+```

data/docs/ValidateCheckoutRequest.md

@@ -13,9 +13,9 @@ Name | Type | Description | Notes
 
 ```json
 {
-    "hmac_input": "ropsten|0xbe98e68c0ffbead18f94882b0f5d15eb31930cee|0x84df8548086ec9025e9c93297058bed706e90ddd|10|12",
+    "hmac_input": "rsk_testnet|0xbed61c55cc290b55c1c4c327148bdede56a831f4|0xb9f624160bb2755aa25366cc307ed27e39a4f296|10|0|0x16e54beb3ea4b4206b62ca32b1d2cf4ad15d9af2234564c2166ff3ccc817d5c1",
     "hmac_keyId": "v1",
     "hmac_alg": "HMAC-SHA256-HEX",
-    "hmac_value": "e842bb5f3f62319864293ecb7ccc01674a0af08e4e74a01ab16b2157c3fce5d6"
+    "hmac_value": "c782cbad4394383599b7cf9f9d62990f289649b35edd82cd1c7d58dd65e9fc03"
 }
 ```

data/docs/WalletBalance.md

@@ -8,14 +8,18 @@ Name | Type | Description | Notes
 **token_balance** | **String** | Token balance for the wallet in Ethereum format | 
 **token_decimals** | **Integer** | Token decimal places | 
 **block_num** | **String** | Block in which the balance was last updated | 
+**safety** | **String** | Safety level indicator | 
+
+## Code Sample
+
+```ruby
+require 'BleumiPay'
+
+instance = BleumiPay::WalletBalance.new(balance: null,
+                                 token_balance: null,
+                                 token_decimals: null,
+                                 block_num: null,
+                                 safety: null)
+```
 
-## Example
 
-```json
-{
-    "balance": "1",
-    "token_decimals": 15,
-    "blockNum": "1698324",
-    "token_balance": "1000000000000000"
-}
-```

data/lib/bleumi_pay_sdk_ruby.rb

@@ -1,7 +1,7 @@
 =begin
-#Bleumi Pay API
+#Bleumi Pay REST API
 
-#A simple and powerful REST API to integrate ERC-20, Ethereum, xDai payments and/or payouts into your business or application
+#A simple and powerful REST API to integrate ERC-20, Ethereum, xDai, Algorand payments and/or payouts into your business or application
 
 The version of the OpenAPI document: 1.0.0
 Contact: info@bleumi.com
@@ -17,17 +17,21 @@ require 'bleumi_pay_sdk_ruby/version'
 require 'bleumi_pay_sdk_ruby/configuration'
 
 # Models
+require 'bleumi_pay_sdk_ruby/models/algorand_address'
+require 'bleumi_pay_sdk_ruby/models/algorand_balance'
+require 'bleumi_pay_sdk_ruby/models/algorand_wallet_address'
+require 'bleumi_pay_sdk_ruby/models/algorand_wallet_inputs'
 require 'bleumi_pay_sdk_ruby/models/bad_request'
 require 'bleumi_pay_sdk_ruby/models/chain'
 require 'bleumi_pay_sdk_ruby/models/checkout_token'
 require 'bleumi_pay_sdk_ruby/models/create_checkout_url_request'
 require 'bleumi_pay_sdk_ruby/models/create_checkout_url_response'
-require 'bleumi_pay_sdk_ruby/models/create_payment_request'
-require 'bleumi_pay_sdk_ruby/models/create_payment_response'
 require 'bleumi_pay_sdk_ruby/models/create_payout_request'
 require 'bleumi_pay_sdk_ruby/models/create_payout_response'
-require 'bleumi_pay_sdk_ruby/models/eth_address'
-require 'bleumi_pay_sdk_ruby/models/network_balance'
+require 'bleumi_pay_sdk_ruby/models/ethereum_address'
+require 'bleumi_pay_sdk_ruby/models/ethereum_balance'
+require 'bleumi_pay_sdk_ruby/models/ethereum_wallet_address'
+require 'bleumi_pay_sdk_ruby/models/ethereum_wallet_inputs'
 require 'bleumi_pay_sdk_ruby/models/paginated_payment_operations'
 require 'bleumi_pay_sdk_ruby/models/paginated_payments'
 require 'bleumi_pay_sdk_ruby/models/paginated_payout_items'
@@ -42,16 +46,17 @@ require 'bleumi_pay_sdk_ruby/models/payment_settle_request'
 require 'bleumi_pay_sdk_ruby/models/payout'
 require 'bleumi_pay_sdk_ruby/models/payout_item'
 require 'bleumi_pay_sdk_ruby/models/payout_item_inputs'
-require 'bleumi_pay_sdk_ruby/models/token'
+require 'bleumi_pay_sdk_ruby/models/rsk_address'
+require 'bleumi_pay_sdk_ruby/models/rsk_balance'
 require 'bleumi_pay_sdk_ruby/models/validate_checkout_request'
 require 'bleumi_pay_sdk_ruby/models/validate_checkout_response'
-require 'bleumi_pay_sdk_ruby/models/wallet_address'
 require 'bleumi_pay_sdk_ruby/models/wallet_balance'
 
 # APIs
 require 'bleumi_pay_sdk_ruby/api/hosted_checkouts_api'
 require 'bleumi_pay_sdk_ruby/api/payments_api'
 require 'bleumi_pay_sdk_ruby/api/payouts_api'
+require 'bleumi_pay_sdk_ruby/api/request_validator'
 
 module BleumiPay
   class << self

data/lib/bleumi_pay_sdk_ruby/api/hosted_checkouts_api.rb

@@ -1,7 +1,7 @@
 =begin
-#Bleumi Pay API
+#Bleumi Pay REST API
 
-#A simple and powerful REST API to integrate ERC-20, Ethereum, xDai payments and/or payouts into your business or application
+#A simple and powerful REST API to integrate ERC-20, Ethereum, xDai, Algorand payments and/or payouts into your business or application
 
 The version of the OpenAPI document: 1.0.0
 Contact: info@bleumi.com
@@ -15,9 +15,11 @@ require 'cgi'
 module BleumiPay
   class HostedCheckoutsApi
     attr_accessor :api_client
+    attr_accessor :request_validator
 
-    def initialize(api_client = ApiClient.default)
+    def initialize(api_client = ApiClient.default, request_validator = RequestValidator.default)
       @api_client = api_client
+      @request_validator = request_validator
     end
     # Generate a unique checkout URL to accept payment.
     # @param create_checkout_url_request [CreateCheckoutUrlRequest] Specify checkout URL creation parameters.
@@ -40,6 +42,11 @@ module BleumiPay
       if @api_client.config.client_side_validation && create_checkout_url_request.nil?
         fail ArgumentError, "Missing the required parameter 'create_checkout_url_request' when calling HostedCheckoutsApi.create_checkout_url"
       end
+      # verify the values in the request body are valid
+      msg = @request_validator.validate_create_checkout_url_request(create_checkout_url_request)
+      if (@request_validator.is_not_empty(msg))
+        fail ArgumentError, "`#{msg}` when calling HostedCheckoutsApi.create_checkout_url"
+      end 
       # resource path
       local_var_path = '/v1/payment/hc'
 
@@ -81,7 +88,7 @@ module BleumiPay
       return data, status_code, headers
     end
 
-    # Retrieve all tokens configured for the Hosted Checkout in your account in the [Bleumi Pay Dashboard](https://pay.bleumi.com/app/).
+    # Retrieve all tokens configured for the Hosted Checkout in your account in the Bleumi Pay Dashboard.
     # @param [Hash] opts the optional parameters
     # @return [Array<CheckoutToken>]
     def list_tokens(opts = {})
@@ -89,7 +96,7 @@ module BleumiPay
       data
     end
 
-    # Retrieve all tokens configured for the Hosted Checkout in your account in the [Bleumi Pay Dashboard](https://pay.bleumi.com/app/).
+    # Retrieve all tokens configured for the Hosted Checkout in your account in the Bleumi Pay Dashboard.
     # @param [Hash] opts the optional parameters
     # @return [Array<(Array<CheckoutToken>, Integer, Hash)>] Array<CheckoutToken> data, response status code and response headers
     def list_tokens_with_http_info(opts = {})
@@ -156,6 +163,11 @@ module BleumiPay
       if @api_client.config.client_side_validation && validate_checkout_request.nil?
         fail ArgumentError, "Missing the required parameter 'validate_checkout_request' when calling HostedCheckoutsApi.validate_checkout_payment"
       end
+      # verify the values in the request body are valid
+      msg = @request_validator.validate_checkout_payment_params(validate_checkout_request)
+      if (@request_validator.is_not_empty(msg))
+        fail ArgumentError, "`#{msg}` when calling HostedCheckoutsApi.validate_checkout_payment"
+      end 
       # resource path
       local_var_path = '/v1/payment/hc/validate'
 

data/lib/bleumi_pay_sdk_ruby/api/payments_api.rb

@@ -1,7 +1,7 @@
 =begin
-#Bleumi Pay API
+#Bleumi Pay REST API
 
-#A simple and powerful REST API to integrate ERC-20, Ethereum, xDai payments and/or payouts into your business or application
+#A simple and powerful REST API to integrate ERC-20, Ethereum, xDai, Algorand payments and/or payouts into your business or application
 
 The version of the OpenAPI document: 1.0.0
 Contact: info@bleumi.com
@@ -15,77 +15,14 @@ require 'cgi'
 module BleumiPay
   class PaymentsApi
     attr_accessor :api_client
+    attr_accessor :request_validator
 
-    def initialize(api_client = ApiClient.default)
+    def initialize(api_client = ApiClient.default, request_validator = RequestValidator.default)
       @api_client = api_client
+      @request_validator = request_validator
     end
-    # Generate a unique wallet address in the specified network to accept payment
-    # @param create_payment_request [CreatePaymentRequest] 
-    # @param [Hash] opts the optional parameters
-    # @option opts [Chain] :chain Ethereum network in which payment is to be created. Please refer documentation for Supported Networks
-    # @return [CreatePaymentResponse]
-    def create_payment(create_payment_request, opts = {})
-      data, _status_code, _headers = create_payment_with_http_info(create_payment_request, opts)
-      data
-    end
-
-    # Generate a unique wallet address in the specified network to accept payment
-    # @param create_payment_request [CreatePaymentRequest] 
-    # @param [Hash] opts the optional parameters
-    # @option opts [Chain] :chain Ethereum network in which payment is to be created. Please refer documentation for Supported Networks
-    # @return [Array<(CreatePaymentResponse, Integer, Hash)>] CreatePaymentResponse data, response status code and response headers
-    def create_payment_with_http_info(create_payment_request, opts = {})
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: PaymentsApi.create_payment ...'
-      end
-      # verify the required parameter 'create_payment_request' is set
-      if @api_client.config.client_side_validation && create_payment_request.nil?
-        fail ArgumentError, "Missing the required parameter 'create_payment_request' when calling PaymentsApi.create_payment"
-      end
-      # resource path
-      local_var_path = '/v1/payment'
-
-      # query parameters
-      query_params = opts[:query_params] || {}
-      query_params[:'chain'] = opts[:'chain'] if !opts[:'chain'].nil?
-
-      # header parameters
-      header_params = opts[:header_params] || {}
-      # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
-      # HTTP header 'Content-Type'
-      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
-
-      # form parameters
-      form_params = opts[:form_params] || {}
-
-      # http body (model)
-      post_body = opts[:body] || @api_client.object_to_http_body(create_payment_request) 
-
-      # return_type
-      return_type = opts[:return_type] || 'CreatePaymentResponse' 
-
-      # auth_names
-      auth_names = opts[:auth_names] || ['ApiKeyAuth']
-
-      new_options = opts.merge(
-        :header_params => header_params,
-        :query_params => query_params,
-        :form_params => form_params,
-        :body => post_body,
-        :auth_names => auth_names,
-        :return_type => return_type
-      )
-
-      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
-      if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: PaymentsApi#create_payment\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
-      end
-      return data, status_code, headers
-    end
-
     # Retrieve the wallet addresses & token balances for a given payment
-    # @param id [String] Unique identifier of the payment (specified during [Create a Payment](#createPayment)) to retrieve
+    # @param id [String] Unique identifier of the payment (specified during createPayment) to retrieve
     # @param [Hash] opts the optional parameters
     # @return [Payment]
     def get_payment(id, opts = {})
@@ -94,7 +31,7 @@ module BleumiPay
     end
 
     # Retrieve the wallet addresses &amp; token balances for a given payment
-    # @param id [String] Unique identifier of the payment (specified during [Create a Payment](#createPayment)) to retrieve
+    # @param id [String] Unique identifier of the payment (specified during createPayment) to retrieve
     # @param [Hash] opts the optional parameters
     # @return [Array<(Payment, Integer, Hash)>] Payment data, response status code and response headers
     def get_payment_with_http_info(id, opts = {})
@@ -277,6 +214,7 @@ module BleumiPay
     # @param [Hash] opts the optional parameters
     # @option opts [String] :next_token Cursor to start results from
     # @option opts [String] :sort_by Sort payments by
+    # @option opts [String] :sort_order Sort Order
     # @option opts [String] :start_at Get payments from this timestamp (unix)
     # @option opts [String] :end_at Get payments till this timestamp (unix)
     # @return [PaginatedPayments]
@@ -289,6 +227,7 @@ module BleumiPay
     # @param [Hash] opts the optional parameters
     # @option opts [String] :next_token Cursor to start results from
     # @option opts [String] :sort_by Sort payments by
+    # @option opts [String] :sort_order Sort Order
     # @option opts [String] :start_at Get payments from this timestamp (unix)
     # @option opts [String] :end_at Get payments till this timestamp (unix)
     # @return [Array<(PaginatedPayments, Integer, Hash)>] PaginatedPayments data, response status code and response headers
@@ -300,6 +239,10 @@ module BleumiPay
       if @api_client.config.client_side_validation && opts[:'sort_by'] && !allowable_values.include?(opts[:'sort_by'])
         fail ArgumentError, "invalid value for \"sort_by\", must be one of #{allowable_values}"
       end
+      allowable_values = ["ascending", "descending"]
+      if @api_client.config.client_side_validation && opts[:'sort_order'] && !allowable_values.include?(opts[:'sort_order'])
+        fail ArgumentError, "invalid value for \"sort_order\", must be one of #{allowable_values}"
+      end
       # resource path
       local_var_path = '/v1/payment'
 
@@ -307,6 +250,7 @@ module BleumiPay
       query_params = opts[:query_params] || {}
       query_params[:'nextToken'] = opts[:'next_token'] if !opts[:'next_token'].nil?
       query_params[:'sortBy'] = opts[:'sort_by'] if !opts[:'sort_by'].nil?
+      query_params[:'sortOrder'] = opts[:'sort_order'] if !opts[:'sort_order'].nil?
       query_params[:'startAt'] = opts[:'start_at'] if !opts[:'start_at'].nil?
       query_params[:'endAt'] = opts[:'end_at'] if !opts[:'end_at'].nil?
 
@@ -344,10 +288,10 @@ module BleumiPay
     end
 
     # Refund the balance of a token for a given payment to the buyerAddress
-    # @param id [String] Unique identifier of the payment (specified during [Create a Payment](#createPayment))
+    # @param id [String] Unique identifier of the payment (specified during createPayment)
     # @param payment_refund_request [PaymentRefundRequest] Request body - used to specify the token to refund.
     # @param [Hash] opts the optional parameters
-    # @option opts [Chain] :chain Ethereum network in which payment is to be created.
+    # @option opts [Chain] :chain Network in which payment is to be refunded.
     # @return [PaymentOperationResponse]
     def refund_payment(id, payment_refund_request, opts = {})
       data, _status_code, _headers = refund_payment_with_http_info(id, payment_refund_request, opts)
@@ -355,10 +299,10 @@ module BleumiPay
     end
 
     # Refund the balance of a token for a given payment to the buyerAddress
-    # @param id [String] Unique identifier of the payment (specified during [Create a Payment](#createPayment))
+    # @param id [String] Unique identifier of the payment (specified during createPayment)
     # @param payment_refund_request [PaymentRefundRequest] Request body - used to specify the token to refund.
     # @param [Hash] opts the optional parameters
-    # @option opts [Chain] :chain Ethereum network in which payment is to be created.
+    # @option opts [Chain] :chain Network in which payment is to be refunded.
     # @return [Array<(PaymentOperationResponse, Integer, Hash)>] PaymentOperationResponse data, response status code and response headers
     def refund_payment_with_http_info(id, payment_refund_request, opts = {})
       if @api_client.config.debugging
@@ -372,6 +316,12 @@ module BleumiPay
       if @api_client.config.client_side_validation && payment_refund_request.nil?
         fail ArgumentError, "Missing the required parameter 'payment_refund_request' when calling PaymentsApi.refund_payment"
       end
+      # verify the values in the request body are valid
+      chain = opts[:'chain'] if !opts[:'chain'].nil?
+      msg = @request_validator.validate_refund_payment_request(payment_refund_request, chain)
+      if (@request_validator.is_not_empty(msg))
+        fail ArgumentError, "`#{msg}` when calling PaymentsApi.refund_payment"
+      end
       # resource path
       local_var_path = '/v1/payment/{id}/refund'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
 
@@ -415,10 +365,10 @@ module BleumiPay
     end
 
     # Settle a specific amount of a token for a given payment to the transferAddress and remaining balance (if any) will be refunded to the buyerAddress
-    # @param id [String] Unique identifier of the payment (specified during [Create a Payment](#createPayment))
+    # @param id [String] Unique identifier of the payment (specified during createPayment)
     # @param payment_settle_request [PaymentSettleRequest] Request body - used to specify the amount to settle.
     # @param [Hash] opts the optional parameters
-    # @option opts [Chain] :chain Ethereum network in which payment is to be created.
+    # @option opts [Chain] :chain Network in which payment is to be settled.
     # @return [PaymentOperationResponse]
     def settle_payment(id, payment_settle_request, opts = {})
       data, _status_code, _headers = settle_payment_with_http_info(id, payment_settle_request, opts)
@@ -426,10 +376,10 @@ module BleumiPay
     end
 
     # Settle a specific amount of a token for a given payment to the transferAddress and remaining balance (if any) will be refunded to the buyerAddress
-    # @param id [String] Unique identifier of the payment (specified during [Create a Payment](#createPayment))
+    # @param id [String] Unique identifier of the payment (specified during createPayment)
     # @param payment_settle_request [PaymentSettleRequest] Request body - used to specify the amount to settle.
     # @param [Hash] opts the optional parameters
-    # @option opts [Chain] :chain Ethereum network in which payment is to be created.
+    # @option opts [Chain] :chain Network in which payment is to be settled.
     # @return [Array<(PaymentOperationResponse, Integer, Hash)>] PaymentOperationResponse data, response status code and response headers
     def settle_payment_with_http_info(id, payment_settle_request, opts = {})
       if @api_client.config.debugging
@@ -443,6 +393,12 @@ module BleumiPay
       if @api_client.config.client_side_validation && payment_settle_request.nil?
         fail ArgumentError, "Missing the required parameter 'payment_settle_request' when calling PaymentsApi.settle_payment"
       end
+      # verify the values in the request body are valid
+      chain = opts[:'chain'] if !opts[:'chain'].nil?
+      msg = @request_validator.validate_settle_payment_request(payment_settle_request, chain)
+      if (@request_validator.is_not_empty(msg))
+        fail ArgumentError, "`#{msg}` when calling PaymentsApi.settle_payment"
+      end      
       # resource path
       local_var_path = '/v1/payment/{id}/settle'.sub('{' + 'id' + '}', CGI.escape(id.to_s))