velopayments 2.18.113 → 2.19.40.beta1

data/docs/PayeeInvitationStatus.md

@@ -13,7 +13,7 @@ Name | Type | Description | Notes
 ```ruby
 require 'VeloPayments'
 
-instance = VeloPayments::PayeeInvitationStatus.new(payee_id: null,
+instance = VeloPayments::PayeeInvitationStatus.new(payee_id: 2aa5d7e0-2ecb-403f-8494-1865ed0454e9,
                                  invitation_status: ACCEPTED,
                                  grace_period_end_date: Sun Feb 03 00:00:00 GMT 2019)
 ```

data/docs/PayeeInvitationStatusResponse.md

@@ -5,7 +5,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **payee_id** | **String** |  | 
-**invitation_status** | [**InvitationStatus**](InvitationStatus.md) |  | 
+**invitation_status** | **String** |  | 
 **grace_period_end_date** | **Date** |  | [optional] 
 
 ## Code Sample
@@ -13,9 +13,9 @@ Name | Type | Description | Notes
 ```ruby
 require 'VeloPayments'
 
-instance = VeloPayments::PayeeInvitationStatusResponse.new(payee_id: null,
+instance = VeloPayments::PayeeInvitationStatusResponse.new(payee_id: 2aa5d7e0-2ecb-403f-8494-1865ed0454e9,
                                  invitation_status: null,
-                                 grace_period_end_date: null)
+                                 grace_period_end_date: Sun Jan 20 00:00:00 GMT 2019)
 ```
 
 

data/docs/PayeeInvitationStatusResponse2.md

@@ -0,0 +1,21 @@
+# VeloPayments::PayeeInvitationStatusResponse2
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**payee_id** | **String** |  | 
+**invitation_status** | **String** |  | 
+**grace_period_end_date** | **Date** |  | [optional] 
+
+## Code Sample
+
+```ruby
+require 'VeloPayments'
+
+instance = VeloPayments::PayeeInvitationStatusResponse2.new(payee_id: 2aa5d7e0-2ecb-403f-8494-1865ed0454e9,
+                                 invitation_status: null,
+                                 grace_period_end_date: Sun Jan 20 00:00:00 GMT 2019)
+```
+
+

data/docs/PayeePaymentChannel.md

@@ -7,8 +7,8 @@ Name | Type | Description | Notes
 **payment_channel_name** | **String** |  | [optional] 
 **iban** | **String** | Must match the regular expression ```^[A-Za-z0-9]+$```. | [optional] 
 **account_number** | **String** |  | 
-**routing_no** | **String** |  | 
-**country_code** | **String** | Must be a 3 character currency code. ISO 4217 | 
+**routing_number** | **String** |  | 
+**country_code** | **String** | Country Code must be a valid 2 letter ISO 3166-1 country code. | 
 **currency** | **String** |  | 
 **account_name** | **String** |  | 
 
@@ -17,13 +17,13 @@ Name | Type | Description | Notes
 ```ruby
 require 'VeloPayments'
 
-instance = VeloPayments::PayeePaymentChannel.new(payment_channel_name: null,
-                                 iban: null,
-                                 account_number: null,
-                                 routing_no: null,
-                                 country_code: null,
+instance = VeloPayments::PayeePaymentChannel.new(payment_channel_name: My payment channel,
+                                 iban: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX1234,
+                                 account_number: XXXXXX5678,
+                                 routing_number: XXXXX6789,
+                                 country_code: UK,
                                  currency: null,
-                                 account_name: null)
+                                 account_name: My account)
 ```
 
 

data/docs/PayeePaymentChannel2.md

@@ -0,0 +1,29 @@
+# VeloPayments::PayeePaymentChannel2
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**payment_channel_name** | **String** |  | [optional] 
+**iban** | **String** | Must match the regular expression ```^[A-Za-z0-9]+$```. | [optional] 
+**account_number** | **String** |  | 
+**routing_number** | **String** |  | 
+**country_code** | **String** | Country Code must be a valid 2 letter ISO 3166-1 country code | 
+**currency** | **String** |  | 
+**account_name** | **String** |  | 
+
+## Code Sample
+
+```ruby
+require 'VeloPayments'
+
+instance = VeloPayments::PayeePaymentChannel2.new(payment_channel_name: null,
+                                 iban: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX1234,
+                                 account_number: XXXXXX5678,
+                                 routing_number: XXXXX6789,
+                                 country_code: US,
+                                 currency: null,
+                                 account_name: My account)
+```
+
+

data/docs/PayeePayorRef.md

@@ -15,7 +15,7 @@ require 'VeloPayments'
 
 instance = VeloPayments::PayeePayorRef.new(payor_id: ba08877f-9d96-41e4-9c26-44a872d856ae,
                                  remote_id: uniqueIdForRemoteEntity,
-                                 invitation_status: null)
+                                 invitation_status: ACCEPTED)
 ```
 
 

data/docs/PayeePayorRefV2.md

@@ -0,0 +1,25 @@
+# VeloPayments::PayeePayorRefV2
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**payor_id** | **String** |  | [optional] 
+**remote_id** | **String** |  | [optional] 
+**invitation_status** | **String** |  | [optional] 
+**invitation_status_timestamp** | **DateTime** | The timestamp when the invitation status is updated | [optional] 
+**payment_channel_id** | **String** |  | [optional] 
+
+## Code Sample
+
+```ruby
+require 'VeloPayments'
+
+instance = VeloPayments::PayeePayorRefV2.new(payor_id: ba08877f-9d96-41e4-9c26-44a872d856ae,
+                                 remote_id: uniqueIdForRemoteEntity,
+                                 invitation_status: ACCEPTED,
+                                 invitation_status_timestamp: 2019-01-20T09:00Z,
+                                 payment_channel_id: 70faaff7-2c32-4b44-b27f-f0b6c484e6f3)
+```
+
+

data/docs/PayeePayorRefV3.md

@@ -0,0 +1,25 @@
+# VeloPayments::PayeePayorRefV3
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**payor_id** | **String** |  | [optional] 
+**remote_id** | **String** |  | [optional] 
+**invitation_status** | **String** |  | [optional] 
+**invitation_status_timestamp** | **DateTime** | The timestamp when the invitation status is updated | [optional] 
+**payment_channel_id** | **String** |  | [optional] 
+
+## Code Sample
+
+```ruby
+require 'VeloPayments'
+
+instance = VeloPayments::PayeePayorRefV3.new(payor_id: ba08877f-9d96-41e4-9c26-44a872d856ae,
+                                 remote_id: uniqueIdForRemoteEntity,
+                                 invitation_status: ACCEPTED,
+                                 invitation_status_timestamp: 2019-01-20T09:00Z,
+                                 payment_channel_id: 70faaff7-2c32-4b44-b27f-f0b6c484e6f3)
+```
+
+

data/docs/PayeeResponse.md

@@ -30,23 +30,23 @@ Name | Type | Description | Notes
 ```ruby
 require 'VeloPayments'
 
-instance = VeloPayments::PayeeResponse.new(payee_id: null,
+instance = VeloPayments::PayeeResponse.new(payee_id: 2aa5d7e0-2ecb-403f-8494-1865ed0454e9,
                                  payor_refs: null,
-                                 email: null,
+                                 email: bob@example.com,
                                  address: null,
-                                 country: null,
-                                 display_name: null,
+                                 country: US,
+                                 display_name: ABC,
                                  payment_channel: null,
                                  challenge: null,
                                  language: null,
-                                 accept_terms_and_conditions_timestamp: null,
-                                 cellphone_number: null,
+                                 accept_terms_and_conditions_timestamp: 2019-01-20T09:00Z,
+                                 cellphone_number: 1234567890,
                                  payee_type: null,
                                  company: null,
                                  individual: null,
-                                 created: null,
-                                 grace_period_end_date: null,
-                                 last_ofac_check_timestamp: null,
+                                 created: 2019-01-20T09:00Z,
+                                 grace_period_end_date: Sun Jan 20 00:00:00 GMT 2019,
+                                 last_ofac_check_timestamp: 2019-01-20T09:00:00+00:00,
                                  marketing_opt_ins: null,
                                  ofac_status: null,
                                  onboarded_status: null)

data/docs/PayeeResponse2.md

@@ -5,7 +5,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **payee_id** | **String** |  | [optional] [readonly] 
-**payor_refs** | [**Array<PayeePayorRef>**](PayeePayorRef.md) |  | [optional] [readonly] 
+**payor_refs** | [**Array<PayeePayorRefV3>**](PayeePayorRefV3.md) |  | [optional] [readonly] 
 **email** | **String** |  | [optional] 
 **address** | [**PayeeAddress**](PayeeAddress.md) |  | [optional] 
 **country** | **String** |  | [optional] 
@@ -30,23 +30,23 @@ Name | Type | Description | Notes
 ```ruby
 require 'VeloPayments'
 
-instance = VeloPayments::PayeeResponse2.new(payee_id: null,
+instance = VeloPayments::PayeeResponse2.new(payee_id: 2aa5d7e0-2ecb-403f-8494-1865ed0454e9,
                                  payor_refs: null,
-                                 email: null,
+                                 email: bob@example.com,
                                  address: null,
-                                 country: null,
-                                 display_name: null,
+                                 country: US,
+                                 display_name: ABC,
                                  payment_channel: null,
                                  challenge: null,
                                  language: null,
-                                 accept_terms_and_conditions_timestamp: null,
-                                 cellphone_number: null,
+                                 accept_terms_and_conditions_timestamp: 2019-01-20T09:00Z,
+                                 cellphone_number: 1234567890,
                                  payee_type: null,
                                  company: null,
                                  individual: null,
-                                 created: null,
-                                 grace_period_end_date: null,
-                                 watchlist_status_updated_timestamp: null,
+                                 created: 2019-01-20T09:00Z,
+                                 grace_period_end_date: Sun Jan 20 00:00:00 GMT 2019,
+                                 watchlist_status_updated_timestamp: 2019-01-20T09:00:00+00:00,
                                  marketing_opt_ins: null,
                                  watchlist_status: null,
                                  onboarded_status: null)

data/docs/PayeeResponseV2.md

@@ -0,0 +1,73 @@
+# VeloPayments::PayeeResponseV2
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**payee_id** | **String** |  | [optional] [readonly] 
+**payor_refs** | [**Array<PayeePayorRefV2>**](PayeePayorRefV2.md) |  | [optional] [readonly] 
+**email** | **String** |  | [optional] 
+**onboarded_status** | [**OnboardedStatus2**](OnboardedStatus2.md) |  | [optional] 
+**ofac_status** | [**OfacStatus2**](OfacStatus2.md) |  | [optional] 
+**language** | [**Language2**](Language2.md) |  | [optional] 
+**created** | **DateTime** |  | [optional] 
+**country** | **String** |  | [optional] 
+**display_name** | **String** |  | [optional] 
+**payee_type** | [**PayeeType**](PayeeType.md) |  | [optional] 
+**disabled** | **Boolean** |  | [optional] 
+**disabled_comment** | **String** |  | [optional] 
+**disabled_updated_timestamp** | **DateTime** |  | [optional] 
+**address** | [**PayeeAddress2**](PayeeAddress2.md) |  | [optional] 
+**individual** | [**Individual**](Individual.md) |  | [optional] 
+**company** | [**Company**](Company.md) |  | [optional] 
+**cellphone_number** | **String** |  | [optional] 
+**last_ofac_check_timestamp** | **String** |  | [optional] [readonly] 
+**ofac_override** | **Boolean** |  | [optional] 
+**ofac_override_reason** | **String** |  | [optional] 
+**ofac_override_timestamp** | **String** |  | [optional] 
+**grace_period_end_date** | **Date** |  | [optional] [readonly] 
+**enhanced_kyc_completed** | **Boolean** |  | [optional] 
+**kyc_completed_timestamp** | **String** |  | [optional] 
+**pause_payment** | **Boolean** |  | [optional] 
+**pause_payment_timestamp** | **String** |  | [optional] 
+**marketing_opt_in_decision** | **Boolean** |  | [optional] 
+**marketing_opt_in_timestamp** | **String** |  | [optional] 
+**accept_terms_and_conditions_timestamp** | **DateTime** | The timestamp when the payee last accepted T&Cs | [optional] [readonly] 
+
+## Code Sample
+
+```ruby
+require 'VeloPayments'
+
+instance = VeloPayments::PayeeResponseV2.new(payee_id: 2aa5d7e0-2ecb-403f-8494-1865ed0454e9,
+                                 payor_refs: null,
+                                 email: bob@example.com,
+                                 onboarded_status: null,
+                                 ofac_status: null,
+                                 language: null,
+                                 created: 2019-01-20T09:00Z,
+                                 country: US,
+                                 display_name: Bob,
+                                 payee_type: null,
+                                 disabled: null,
+                                 disabled_comment: reason for disabled,
+                                 disabled_updated_timestamp: 2019-01-20T09:00Z,
+                                 address: null,
+                                 individual: null,
+                                 company: null,
+                                 cellphone_number: 1234567890,
+                                 last_ofac_check_timestamp: 2019-01-20T09:00:00+00:00,
+                                 ofac_override: null,
+                                 ofac_override_reason: ofac override reason,
+                                 ofac_override_timestamp: 2019-01-20T09:00:00+00:00,
+                                 grace_period_end_date: Sun Jan 20 00:00:00 GMT 2019,
+                                 enhanced_kyc_completed: null,
+                                 kyc_completed_timestamp: 2019-01-20T09:00:00+00:00,
+                                 pause_payment: null,
+                                 pause_payment_timestamp: 2019-01-20T09:00:00+00:00,
+                                 marketing_opt_in_decision: null,
+                                 marketing_opt_in_timestamp: 2019-01-20T09:00:00+00:00,
+                                 accept_terms_and_conditions_timestamp: 2019-01-20T09:00Z)
+```
+
+

data/docs/PayeeResponseV3.md

@@ -0,0 +1,71 @@
+# VeloPayments::PayeeResponseV3
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**payee_id** | **String** |  | [optional] [readonly] 
+**payor_refs** | [**Array<PayeePayorRefV3>**](PayeePayorRefV3.md) |  | [optional] [readonly] 
+**email** | **String** |  | [optional] 
+**onboarded_status** | [**OnboardedStatus2**](OnboardedStatus2.md) |  | [optional] 
+**watchlist_status** | [**WatchlistStatus**](WatchlistStatus.md) |  | [optional] 
+**watchlist_override_expires_at_timestamp** | **DateTime** |  | [optional] 
+**watchlist_override_comment** | **String** |  | [optional] 
+**language** | [**Language2**](Language2.md) |  | [optional] 
+**created** | **DateTime** |  | [optional] 
+**country** | **String** |  | [optional] 
+**display_name** | **String** |  | [optional] 
+**payee_type** | [**PayeeType**](PayeeType.md) |  | [optional] 
+**disabled** | **Boolean** |  | [optional] 
+**disabled_comment** | **String** |  | [optional] 
+**disabled_updated_timestamp** | **DateTime** |  | [optional] 
+**address** | [**PayeeAddress2**](PayeeAddress2.md) |  | [optional] 
+**individual** | [**Individual2**](Individual2.md) |  | [optional] 
+**company** | [**Company2**](Company2.md) |  | [optional] 
+**cellphone_number** | **String** |  | [optional] 
+**watchlist_status_updated_timestamp** | **String** |  | [optional] [readonly] 
+**grace_period_end_date** | **Date** |  | [optional] [readonly] 
+**enhanced_kyc_completed** | **Boolean** |  | [optional] 
+**kyc_completed_timestamp** | **String** |  | [optional] 
+**pause_payment** | **Boolean** |  | [optional] 
+**pause_payment_timestamp** | **String** |  | [optional] 
+**marketing_opt_in_decision** | **Boolean** |  | [optional] 
+**marketing_opt_in_timestamp** | **String** |  | [optional] 
+**accept_terms_and_conditions_timestamp** | **DateTime** | The timestamp when the payee last accepted T&Cs | [optional] [readonly] 
+
+## Code Sample
+
+```ruby
+require 'VeloPayments'
+
+instance = VeloPayments::PayeeResponseV3.new(payee_id: 2aa5d7e0-2ecb-403f-8494-1865ed0454e9,
+                                 payor_refs: null,
+                                 email: bob@example.com,
+                                 onboarded_status: null,
+                                 watchlist_status: null,
+                                 watchlist_override_expires_at_timestamp: 2019-01-20T09:00Z,
+                                 watchlist_override_comment: watchlist override comment,
+                                 language: null,
+                                 created: 2019-01-20T09:00Z,
+                                 country: US,
+                                 display_name: Bob,
+                                 payee_type: null,
+                                 disabled: null,
+                                 disabled_comment: reason for disabled,
+                                 disabled_updated_timestamp: 2019-01-20T09:00Z,
+                                 address: null,
+                                 individual: null,
+                                 company: null,
+                                 cellphone_number: 1234567890,
+                                 watchlist_status_updated_timestamp: 2019-01-20T09:00:00+00:00,
+                                 grace_period_end_date: Sun Jan 20 00:00:00 GMT 2019,
+                                 enhanced_kyc_completed: null,
+                                 kyc_completed_timestamp: 2019-01-20T09:00:00+00:00,
+                                 pause_payment: null,
+                                 pause_payment_timestamp: 2019-01-20T09:00:00+00:00,
+                                 marketing_opt_in_decision: null,
+                                 marketing_opt_in_timestamp: 2019-01-20T09:00:00+00:00,
+                                 accept_terms_and_conditions_timestamp: 2019-01-20T09:00Z)
+```
+
+

data/docs/PayeesApi.md

@@ -4,22 +4,27 @@ All URIs are relative to *https://api.sandbox.velopayments.com*
 
 Method | HTTP request | Description
 ------------- | ------------- | -------------
-[**delete_payee_by_id**](PayeesApi.md#delete_payee_by_id) | **DELETE** /v1/payees/{payeeId} | Delete Payee by Id
-[**get_payee_by_id**](PayeesApi.md#get_payee_by_id) | **GET** /v1/payees/{payeeId} | Get Payee by Id
+[**delete_payee_by_id_v1**](PayeesApi.md#delete_payee_by_id_v1) | **DELETE** /v1/payees/{payeeId} | Delete Payee by Id
+[**delete_payee_by_id_v3**](PayeesApi.md#delete_payee_by_id_v3) | **DELETE** /v3/payees/{payeeId} | Delete Payee by Id
+[**get_payee_by_id_v1**](PayeesApi.md#get_payee_by_id_v1) | **GET** /v1/payees/{payeeId} | Get Payee by Id
+[**get_payee_by_id_v2**](PayeesApi.md#get_payee_by_id_v2) | **GET** /v2/payees/{payeeId} | Get Payee by Id
+[**get_payee_by_id_v3**](PayeesApi.md#get_payee_by_id_v3) | **GET** /v3/payees/{payeeId} | Get Payee by Id
 [**list_payee_changes**](PayeesApi.md#list_payee_changes) | **GET** /v1/deltas/payees | List Payee Changes
-[**list_payees**](PayeesApi.md#list_payees) | **GET** /v1/payees | List Payees
+[**list_payee_changes_v3**](PayeesApi.md#list_payee_changes_v3) | **GET** /v3/payees/deltas | List Payee Changes
+[**list_payees_v1**](PayeesApi.md#list_payees_v1) | **GET** /v1/payees | List Payees V1
 [**list_payees_v3**](PayeesApi.md#list_payees_v3) | **GET** /v3/payees | List Payees
 [**v1_payees_payee_id_remote_id_update_post**](PayeesApi.md#v1_payees_payee_id_remote_id_update_post) | **POST** /v1/payees/{payeeId}/remoteIdUpdate | Update Payee Remote Id
+[**v3_payees_payee_id_remote_id_update_post**](PayeesApi.md#v3_payees_payee_id_remote_id_update_post) | **POST** /v3/payees/{payeeId}/remoteIdUpdate | Update Payee Remote Id
 
 
 
-## delete_payee_by_id
+## delete_payee_by_id_v1
 
-> delete_payee_by_id(payee_id)
+> delete_payee_by_id_v1(payee_id)
 
 Delete Payee by Id
 
-This API will delete Payee by Id (UUID). Deletion by ID is not allowed if: * Payee ID is not found * If Payee has not been on-boarded * If Payee is in grace period * If Payee has existing payments 
+<p>This API will delete Payee by Id (UUID). Deletion by ID is not allowed if:</p> <p>* Payee ID is not found</p> <p>* If Payee has not been on-boarded</p> <p>* If Payee is in grace period</p> <p>* If Payee has existing payments</p> <p>Please use V3 instead.</p> 
 
 ### Example
 
@@ -33,13 +38,13 @@ VeloPayments.configure do |config|
 end
 
 api_instance = VeloPayments::PayeesApi.new
-payee_id = 'payee_id_example' # String | The UUID of the payee.
+payee_id = '2aa5d7e0-2ecb-403f-8494-1865ed0454e9' # String | The UUID of the payee.
 
 begin
   #Delete Payee by Id
-  api_instance.delete_payee_by_id(payee_id)
+  api_instance.delete_payee_by_id_v1(payee_id)
 rescue VeloPayments::ApiError => e
-  puts "Exception when calling PayeesApi->delete_payee_by_id: #{e}"
+  puts "Exception when calling PayeesApi->delete_payee_by_id_v1: #{e}"
 end
 ```
 
@@ -64,14 +69,65 @@ nil (empty response body)
 - **Accept**: Not defined
 
 
-## get_payee_by_id
+## delete_payee_by_id_v3
 
-> Payee get_payee_by_id(payee_id, opts)
+> delete_payee_by_id_v3(payee_id)
 
-Get Payee by Id
+Delete Payee by Id
+
+<p>This API will delete Payee by Id (UUID). Deletion by ID is not allowed if:</p> <p>* Payee ID is not found</p> <p>* If Payee has not been on-boarded</p> <p>* If Payee is in grace period</p> <p>* If Payee has existing payments</p> 
+
+### Example
+
+```ruby
+# load the gem
+require 'velopayments'
+# setup authorization
+VeloPayments.configure do |config|
+  # Configure OAuth2 access token for authorization: OAuth2
+  config.access_token = 'YOUR ACCESS TOKEN'
+end
+
+api_instance = VeloPayments::PayeesApi.new
+payee_id = '2aa5d7e0-2ecb-403f-8494-1865ed0454e9' # String | The UUID of the payee.
+
+begin
+  #Delete Payee by Id
+  api_instance.delete_payee_by_id_v3(payee_id)
+rescue VeloPayments::ApiError => e
+  puts "Exception when calling PayeesApi->delete_payee_by_id_v3: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **payee_id** | [**String**](.md)| The UUID of the payee. | 
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: Not defined
+
+
+## get_payee_by_id_v1
+
+> Payee get_payee_by_id_v1(payee_id, opts)
 
 Get Payee by Id
 
+<p>Get Payee by Id</p> <p>Please use V3 instead.</p> 
+
 ### Example
 
 ```ruby
@@ -84,17 +140,17 @@ VeloPayments.configure do |config|
 end
 
 api_instance = VeloPayments::PayeesApi.new
-payee_id = 'payee_id_example' # String | The UUID of the payee.
+payee_id = '2aa5d7e0-2ecb-403f-8494-1865ed0454e9' # String | The UUID of the payee.
 opts = {
   sensitive: true # Boolean | Optional. If omitted or set to false, any Personal Identifiable Information (PII) values are returned masked. If set to true, and you have permission, the PII values will be returned as their original unmasked values. 
 }
 
 begin
   #Get Payee by Id
-  result = api_instance.get_payee_by_id(payee_id, opts)
+  result = api_instance.get_payee_by_id_v1(payee_id, opts)
   p result
 rescue VeloPayments::ApiError => e
-  puts "Exception when calling PayeesApi->get_payee_by_id: #{e}"
+  puts "Exception when calling PayeesApi->get_payee_by_id_v1: #{e}"
 end
 ```
 
@@ -120,13 +176,125 @@ Name | Type | Description  | Notes
 - **Accept**: application/json
 
 
+## get_payee_by_id_v2
+
+> PayeeResponseV2 get_payee_by_id_v2(payee_id, opts)
+
+Get Payee by Id
+
+<p>Get Payee by Id</p> <p>Please use V3 instead.</p> 
+
+### Example
+
+```ruby
+# load the gem
+require 'velopayments'
+# setup authorization
+VeloPayments.configure do |config|
+  # Configure OAuth2 access token for authorization: OAuth2
+  config.access_token = 'YOUR ACCESS TOKEN'
+end
+
+api_instance = VeloPayments::PayeesApi.new
+payee_id = '2aa5d7e0-2ecb-403f-8494-1865ed0454e9' # String | The UUID of the payee.
+opts = {
+  sensitive: true # Boolean | Optional. If omitted or set to false, any Personal Identifiable Information (PII) values are returned masked. If set to true, and you have permission, the PII values will be returned as their original unmasked values. 
+}
+
+begin
+  #Get Payee by Id
+  result = api_instance.get_payee_by_id_v2(payee_id, opts)
+  p result
+rescue VeloPayments::ApiError => e
+  puts "Exception when calling PayeesApi->get_payee_by_id_v2: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **payee_id** | [**String**](.md)| The UUID of the payee. | 
+ **sensitive** | **Boolean**| Optional. If omitted or set to false, any Personal Identifiable Information (PII) values are returned masked. If set to true, and you have permission, the PII values will be returned as their original unmasked values.  | [optional] 
+
+### Return type
+
+[**PayeeResponseV2**](PayeeResponseV2.md)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_payee_by_id_v3
+
+> PayeeResponseV3 get_payee_by_id_v3(payee_id, opts)
+
+Get Payee by Id
+
+Get Payee by Id
+
+### Example
+
+```ruby
+# load the gem
+require 'velopayments'
+# setup authorization
+VeloPayments.configure do |config|
+  # Configure OAuth2 access token for authorization: OAuth2
+  config.access_token = 'YOUR ACCESS TOKEN'
+end
+
+api_instance = VeloPayments::PayeesApi.new
+payee_id = '2aa5d7e0-2ecb-403f-8494-1865ed0454e9' # String | The UUID of the payee.
+opts = {
+  sensitive: true # Boolean | Optional. If omitted or set to false, any Personal Identifiable Information (PII) values are returned masked. If set to true, and you have permission, the PII values will be returned as their original unmasked values. 
+}
+
+begin
+  #Get Payee by Id
+  result = api_instance.get_payee_by_id_v3(payee_id, opts)
+  p result
+rescue VeloPayments::ApiError => e
+  puts "Exception when calling PayeesApi->get_payee_by_id_v3: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **payee_id** | [**String**](.md)| The UUID of the payee. | 
+ **sensitive** | **Boolean**| Optional. If omitted or set to false, any Personal Identifiable Information (PII) values are returned masked. If set to true, and you have permission, the PII values will be returned as their original unmasked values.  | [optional] 
+
+### Return type
+
+[**PayeeResponseV3**](PayeeResponseV3.md)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## list_payee_changes
 
 > PayeeDeltaResponse list_payee_changes(payor_id, updated_since, opts)
 
 List Payee Changes
 
-Get a paginated response listing payee changes.
+<p>Get a paginated response listing payee changes.</p> <p>Please use V3 instead.</p> 
 
 ### Example
 
@@ -180,13 +348,73 @@ Name | Type | Description  | Notes
 - **Accept**: application/json
 
 
-## list_payees
+## list_payee_changes_v3
 
-> PagedPayeeResponse list_payees(payor_id, opts)
+> PayeeDeltaResponse2 list_payee_changes_v3(payor_id, updated_since, opts)
 
-List Payees
+List Payee Changes
 
-Get a paginated response listing the payees for a payor.
+Get a paginated response listing payee changes.
+
+### Example
+
+```ruby
+# load the gem
+require 'velopayments'
+# setup authorization
+VeloPayments.configure do |config|
+  # Configure OAuth2 access token for authorization: OAuth2
+  config.access_token = 'YOUR ACCESS TOKEN'
+end
+
+api_instance = VeloPayments::PayeesApi.new
+payor_id = 'payor_id_example' # String | The Payor ID to find associated Payees
+updated_since = DateTime.parse('2013-10-20T19:20:30+01:00') # DateTime | The updatedSince filter in the format YYYY-MM-DDThh:mm:ss+hh:mm
+opts = {
+  page: 1, # Integer | Page number. Default is 1.
+  page_size: 100 # Integer | Page size. Default is 100. Max allowable is 1000.
+}
+
+begin
+  #List Payee Changes
+  result = api_instance.list_payee_changes_v3(payor_id, updated_since, opts)
+  p result
+rescue VeloPayments::ApiError => e
+  puts "Exception when calling PayeesApi->list_payee_changes_v3: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **payor_id** | [**String**](.md)| The Payor ID to find associated Payees | 
+ **updated_since** | **DateTime**| The updatedSince filter in the format YYYY-MM-DDThh:mm:ss+hh:mm | 
+ **page** | **Integer**| Page number. Default is 1. | [optional] [default to 1]
+ **page_size** | **Integer**| Page size. Default is 100. Max allowable is 1000. | [optional] [default to 100]
+
+### Return type
+
+[**PayeeDeltaResponse2**](PayeeDeltaResponse2.md)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_payees_v1
+
+> PagedPayeeResponse list_payees_v1(payor_id, opts)
+
+List Payees V1
+
+<p>Get a paginated response listing the payees for a payor.</p> <p>Please use V3 instead.</> 
 
 ### Example
 
@@ -204,22 +432,22 @@ payor_id = 'payor_id_example' # String | The account owner Payor ID
 opts = {
   ofac_status: VeloPayments::OfacStatus.new, # OfacStatus | The ofacStatus of the payees.
   onboarded_status: VeloPayments::OnboardedStatus.new, # OnboardedStatus | The onboarded status of the payees.
-  email: 'email_example', # String | Email address
-  display_name: 'display_name_example', # String | The display name of the payees.
-  remote_id: 'remote_id_example', # String | The remote id of the payees.
+  email: 'bob@example.com', # String | Email address
+  display_name: 'Bob Smith', # String | The display name of the payees.
+  remote_id: 'remoteId123', # String | The remote id of the payees.
   payee_type: VeloPayments::PayeeType.new, # PayeeType | The onboarded status of the payees.
-  payee_country: 'payee_country_example', # String | The country of the payee - 2 letter ISO 3166-1 country code (upper case)
+  payee_country: 'US', # String | The country of the payee - 2 letter ISO 3166-1 country code (upper case)
   page: 1, # Integer | Page number. Default is 1.
   page_size: 25, # Integer | Page size. Default is 25. Max allowable is 100.
   sort: 'displayName:asc' # String | List of sort fields (e.g. ?sort=onboardedStatus:asc,name:asc) Default is name:asc 'name' is treated as company name for companies - last name + ',' + firstName for individuals The supported sort fields are - payeeId, displayName, payoutStatus, onboardedStatus. 
 }
 
 begin
-  #List Payees
-  result = api_instance.list_payees(payor_id, opts)
+  #List Payees V1
+  result = api_instance.list_payees_v1(payor_id, opts)
   p result
 rescue VeloPayments::ApiError => e
-  puts "Exception when calling PayeesApi->list_payees: #{e}"
+  puts "Exception when calling PayeesApi->list_payees_v1: #{e}"
 end
 ```
 
@@ -278,11 +506,11 @@ payor_id = 'payor_id_example' # String | The account owner Payor ID
 opts = {
   ofac_status: VeloPayments::WatchlistStatus.new, # WatchlistStatus | The watchlistStatus of the payees.
   onboarded_status: VeloPayments::OnboardedStatus.new, # OnboardedStatus | The onboarded status of the payees.
-  email: 'email_example', # String | Email address
-  display_name: 'display_name_example', # String | The display name of the payees.
-  remote_id: 'remote_id_example', # String | The remote id of the payees.
+  email: 'bob@example.com', # String | Email address
+  display_name: 'Bob Smith', # String | The display name of the payees.
+  remote_id: 'remoteId123', # String | The remote id of the payees.
   payee_type: VeloPayments::PayeeType.new, # PayeeType | The onboarded status of the payees.
-  payee_country: 'payee_country_example', # String | The country of the payee - 2 letter ISO 3166-1 country code (upper case)
+  payee_country: 'US', # String | The country of the payee - 2 letter ISO 3166-1 country code (upper case)
   page: 1, # Integer | Page number. Default is 1.
   page_size: 25, # Integer | Page size. Default is 25. Max allowable is 100.
   sort: 'displayName:asc' # String | List of sort fields (e.g. ?sort=onboardedStatus:asc,name:asc) Default is name:asc 'name' is treated as company name for companies - last name + ',' + firstName for individuals The supported sort fields are - payeeId, displayName, payoutStatus, onboardedStatus. 
@@ -334,7 +562,7 @@ Name | Type | Description  | Notes
 
 Update Payee Remote Id
 
-Update the remote Id for the given Payee Id.
+<p>Update the remote Id for the given Payee Id.</p> <p>Please use V3 instead</p> 
 
 ### Example
 
@@ -348,8 +576,8 @@ VeloPayments.configure do |config|
 end
 
 api_instance = VeloPayments::PayeesApi.new
-payee_id = 'payee_id_example' # String | The UUID of the payee.
-update_remote_id_request = VeloPayments::UpdateRemoteIdRequest.new # UpdateRemoteIdRequest | Request to update payee remote id
+payee_id = '2aa5d7e0-2ecb-403f-8494-1865ed0454e9' # String | The UUID of the payee.
+update_remote_id_request = VeloPayments::UpdateRemoteIdRequest.new # UpdateRemoteIdRequest | Request to update payee remote id v1
 
 begin
   #Update Payee Remote Id
@@ -365,7 +593,60 @@ end
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **payee_id** | [**String**](.md)| The UUID of the payee. | 
- **update_remote_id_request** | [**UpdateRemoteIdRequest**](UpdateRemoteIdRequest.md)| Request to update payee remote id | 
+ **update_remote_id_request** | [**UpdateRemoteIdRequest**](UpdateRemoteIdRequest.md)| Request to update payee remote id v1 | 
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## v3_payees_payee_id_remote_id_update_post
+
+> v3_payees_payee_id_remote_id_update_post(payee_id, update_remote_id_request)
+
+Update Payee Remote Id
+
+<p>Update the remote Id for the given Payee Id.</p> 
+
+### Example
+
+```ruby
+# load the gem
+require 'velopayments'
+# setup authorization
+VeloPayments.configure do |config|
+  # Configure OAuth2 access token for authorization: OAuth2
+  config.access_token = 'YOUR ACCESS TOKEN'
+end
+
+api_instance = VeloPayments::PayeesApi.new
+payee_id = '2aa5d7e0-2ecb-403f-8494-1865ed0454e9' # String | The UUID of the payee.
+update_remote_id_request = VeloPayments::UpdateRemoteIdRequest.new # UpdateRemoteIdRequest | Request to update payee remote id v3
+
+begin
+  #Update Payee Remote Id
+  api_instance.v3_payees_payee_id_remote_id_update_post(payee_id, update_remote_id_request)
+rescue VeloPayments::ApiError => e
+  puts "Exception when calling PayeesApi->v3_payees_payee_id_remote_id_update_post: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **payee_id** | [**String**](.md)| The UUID of the payee. | 
+ **update_remote_id_request** | [**UpdateRemoteIdRequest**](UpdateRemoteIdRequest.md)| Request to update payee remote id v3 | 
 
 ### Return type