bleumi_pay_sdk_ruby 1.0.3 → 1.0.4

data/docs/PaymentRefundRequest.md

@@ -4,8 +4,7 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**token** | [**Token**](Token.md) | <b>ETH</b> - for Ethereum  <br/> <b>XDAI</b> - for xDai <br/> <b>XDAIT</b> - for xDai Testnet <br/> <b> &lt;contract address of ERC-20 token&gt;</b> - for ERC-20 Tokens  | 
-
+**token** | **String** | <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;  | 
 
 ## Example
 

data/docs/PaymentSettleRequest.md

@@ -4,7 +4,7 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**token** | [**Token**](Token.md) | <b>ETH</b> - for Ethereum  <br/> <b>XDAI</b> - for xDai <br/> <b>XDAIT</b> - for xDai Testnet <br/> <b> &lt;contract address of ERC-20 token&gt;</b> - for ERC-20 Tokens  | 
+**token** | **String** | <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;  | 
 **amount** | **String** | Amount to be settled | 
 
 ## Example

data/docs/PaymentsApi.md

@@ -21,20 +21,20 @@ end
 api_instance = BleumiPay::PayoutsApi.new
 create_payment_request = BleumiPay::CreatePaymentRequest.new # CreatePaymentRequest | 
 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
   
   create_payment_request.id = '<ID>'
-  create_payment_request.buyer_address = BleumiPay::EthAddress.new('<BUYER_ADDR>') # Replace <BUYER_ADDR> with the Buyer's Enthereum Network Address
-  create_payment_request.transfer_address = BleumiPay::EthAddress.new('<MERCHANT_ADDR>') # Replace <MERCHANT_ADDR> with the Merchant's Enthereum Network Address
+  create_payment_request.buyer_address = '<BUYER_ADDR>' # Replace <BUYER_ADDR> with the Buyer's Enthereum Network Address
+  create_payment_request.transfer_address = '<MERCHANT_ADDR>' # Replace <MERCHANT_ADDR> with the Merchant's Enthereum Network Address
 
   #Create a payout.
   result = api_instance.create_payment(create_payment_request, opts)
   p result
 rescue BleumiPay::ApiError => e
-  puts "Exception when calling PayoutsApi->create_payment: #{e}"
+  puts "Exception when calling create_payment: #{e}"
 end
 ```
 
@@ -87,7 +87,7 @@ begin
   result = api_instance.get_payment(id)
   p result
 rescue BleumiPay::ApiError => e
-  puts "Exception when calling PaymentsApi->get_payment: #{e}"
+  puts "Exception when calling get_payment: #{e}"
 end
 ```
 
@@ -146,10 +146,11 @@ end
 
 api_instance = BleumiPay::PaymentsApi.new
 opts = {
-  next_token: '', # String | Cursor to start results from
-  sort_by: '<SORT_BY>', # String | Sort wallets by (optional) | Eg. "createdAt"
-  start_at: '<START_TIMESTAMP>', # String | Get wallets from this timestamp (optional) | Eg. 1546300800 for 1-JAN-2019
-  end_at: '' # String | Get wallets till this timestamp (optional) 
+  next_token: '', # String | Cursor to start results from (optional) |
+  sort_by: '<SORT_BY>', # String | Sort payments by (optional) | Eg. "createdAt"
+  sort_order: '<SORT_ORDER>', # String | Sort Order for payment (optional) | Eg. "ascending"
+  start_at: '<START_TIMESTAMP>', # String | Get wallets from this timestamp (optional) | Eg. 1577836800 for 1-JAN-2020
+  end_at: nil # String | Get wallets till this timestamp (optional) 
 }
 
 begin
@@ -167,7 +168,8 @@ 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 payments by | [optional] 'createdAt' - results will be sorted by created time. <br>'updatedAt' - results will be sorted by last updated time.
+ **sort_order** | **String**| Sort payments by | [optional] 'ascending' - results will be sorted in ascending order. <br>'descending' - results will be sorted in ascending order.
  **start_at** | **String**| Get payments from this timestamp (unix) | [optional] 
  **end_at** | **String**| Get payments till this timestamp (unix) | [optional] 
 
@@ -210,14 +212,14 @@ end
 api_instance = BleumiPay::PaymentsApi.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
   id = '<ID>' # String | Unique identifier of the payment (specified during create payment)
   payment_settle_request = BleumiPay::PaymentSettleRequest.new # PaymentSettleRequest | Request body - used to specify the amount to settle.
   payment_settle_request.amount = '<AMT>' # String | Replace <AMT> with settle amount
-  payment_settle_request.token = BleumiPay::Token.new('<TOKEN>') # String | Replace <TOKEN> with ETH or XDAI or XDAIT or ECR-20 token contract address
+  payment_settle_request.token = '<TOKEN>' # String | Replace <TOKEN> with "ALGO" or "ETH" or "XDAI" or "XDAIT" or ERC-20 'Token Contract Address' or 'Algorand Standard Asset token'
   #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
   result = api_instance.settle_payment(id, payment_settle_request, opts)
   p result
@@ -233,7 +235,7 @@ Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **id** | **String**| Unique identifier of the payment (specified during [Create a Payment](#create_payment)) | 
  **payment_settle_request** | [**PaymentSettleRequest**](PaymentSettleRequest.md)| Request body - used to specify the amount to settle. | 
- **chain** | [**Chain**](.md)| Ethereum network in which payment is to be created. | [optional] 
+ **chain** | [**Chain**](Chain.md)| Network in which payment is to be created. | [optional] 
 
 ### Return type
 
@@ -270,13 +272,13 @@ end
 api_instance = BleumiPay::PaymentsApi.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
   id = '<ID>' # String | Unique identifier of the payment (specified during create payment)
   payment_refund_request = BleumiPay::PaymentRefundRequest.new # PaymentRefundRequest | Request body - used to specify the token to refund.
-  payment_refund_request.token = BleumiPay::Token.new('<TOKEN>') # String | Replace <TOKEN> with ETH or XDAI or XDAIT or ECR-20 token contract address
+  payment_refund_request.token = '<TOKEN>' # String | Replace <TOKEN> with "ALGO" or "ETH" or "XDAI" or "XDAIT" or ERC-20 'Token Contract Address' or 'Algorand Standard Asset token'
 
   #Refund the balance of a token for a given payment to the buyerAddress
   result = api_instance.refund_payment(id, payment_refund_request, opts)

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 and xDAI 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> with Token. Eg. ETH or ECR-20 token contract address or XDAI or XDAIT
   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/ValidateCheckoutRequest.md

@@ -13,7 +13,7 @@ Name | Type | Description | Notes
 
 ```json
 {
-    "hmac_input": "ropsten|0xbe98e68c0ffbead18f94882b0f5d15eb31930cee|0x84df8548086ec9025e9c93297058bed706e90ddd|10|12",
+    "hmac_input": "goerli|0xbe98e68c0ffbead18f94882b0f5d15eb31930cee|0x84df8548086ec9025e9c93297058bed706e90ddd|10|12",
     "hmac_keyId": "v1",
     "hmac_alg": "HMAC-SHA256-HEX",
     "hmac_value": "e842bb5f3f62319864293ecb7ccc01674a0af08e4e74a01ab16b2157c3fce5d6"

data/docs/WalletAddress.md

@@ -5,6 +5,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **addr** | **String** | Wallet address for the payment in the network | 
+
 ## Example
 
 ```json

data/docs/WalletBalance.md

@@ -5,7 +5,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **balance** | **String** | Token balance for the wallet | 
-**token_balance** | **String** | Token balance for the wallet in Ethereum format | 
+**token_balance** | **String** | Token balance for the wallet in Network format | 
 **token_decimals** | **Integer** | Token decimal places | 
 **block_num** | **String** | Block in which the balance was last updated | 
 

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,6 +17,7 @@ require 'bleumi_pay_sdk_ruby/version'
 require 'bleumi_pay_sdk_ruby/configuration'
 
 # Models
+require 'bleumi_pay_sdk_ruby/models/algorand_balance'
 require 'bleumi_pay_sdk_ruby/models/bad_request'
 require 'bleumi_pay_sdk_ruby/models/chain'
 require 'bleumi_pay_sdk_ruby/models/checkout_token'
@@ -26,8 +27,7 @@ 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_balance'
 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,7 +42,6 @@ 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/validate_checkout_request'
 require 'bleumi_pay_sdk_ruby/models/validate_checkout_response'
 require 'bleumi_pay_sdk_ruby/models/wallet_address'
@@ -52,6 +51,7 @@ require 'bleumi_pay_sdk_ruby/models/wallet_balance'
 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,14 +15,16 @@ 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
+    # @option opts [Chain] :chain 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)
@@ -32,7 +34,7 @@ module BleumiPay
     # 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
+    # @option opts [Chain] :chain 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
@@ -42,12 +44,20 @@ module BleumiPay
       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
+
+      # verify the values in the request body are valid
+      chain = opts[:'chain'] if !opts[:'chain'].nil?
+      msg = @request_validator.validate_create_payment_request(create_payment_request, chain)
+      if (@request_validator.is_not_empty(msg))
+        fail ArgumentError, "`#{msg}` 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?
+      query_params[:'chain'] = chain
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -85,7 +95,7 @@ module BleumiPay
     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 +104,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 +287,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 +300,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 +312,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 +323,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 +361,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 +372,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,12 +389,18 @@ 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))
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'chain'] = opts[:'chain'] if !opts[:'chain'].nil?
+      query_params[:'chain'] = chain
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -415,10 +438,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 +449,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 +466,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))