zernio-sdk 0.0.554 → 0.0.556

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35225cb78ab15337945a45e50751bec5852ae05a0b00b7055bc9a3356677bdeb
-  data.tar.gz: 1f504369382afb2282ff0ef5f4578ef7409a6774c0968940dd3cc85fa9db618b
+  metadata.gz: 784e6cc160994ca9f53ea86b12777d2ca34ff07ddbb3ea18a907a8df5c92525b
+  data.tar.gz: 5f2da5babdb04fa73350f46cedd5bd51dd96844bc503a083a8ec29e8d01cde02
 SHA512:
-  metadata.gz: 33b3eae679d40391d2800b55eb045aa5b5cc3bdd731dfe8ae2838869627895be5e47f68d519b2a844851ba5d88aad6a3e6f06bacab83d15328aebb2deff509ca
-  data.tar.gz: d47d4428807b01ae1b6d7cd5985fbfea7726d30bbcee37599551331cfdf8cbf5595a9192f0b13fde73be96c318f6e02e3f06ffb3bd77522df8b563fd59797e2c
+  metadata.gz: ad24d4f24f6aaa1127c09c40ed3a8bc6ff18a4de49d229c0d7579906fa4faf46ec7f09ae86e4d6e595174fa0ac63f477533a26b2f87f1b9ad37d937f4e7f19c2
+  data.tar.gz: c3d61011fa293fc7eb5bed55ddd4f9ce7c693490a51e48131dc1d18f5937561e88544237356ea1f93cf620021dcc95a20e40f94ba7a64f64a568224e8efd4877

data/README.md

@@ -380,6 +380,7 @@ Class | Method | HTTP request | Description
 *Zernio::PhoneNumbersApi* | [**upload_phone_number_kyc_document**](docs/PhoneNumbersApi.md#upload_phone_number_kyc_document) | **POST** /v1/phone-numbers/kyc/upload-document | Upload a KYC document
 *Zernio::PhoneNumbersApi* | [**upload_phone_number_port_in_document**](docs/PhoneNumbersApi.md#upload_phone_number_port_in_document) | **POST** /v1/phone-numbers/port-in/documents | Upload a porting document
 *Zernio::PhoneNumbersApi* | [**validate_phone_number_kyc_address**](docs/PhoneNumbersApi.md#validate_phone_number_kyc_address) | **POST** /v1/phone-numbers/kyc/validate-address | Pre-validate KYC address
+*Zernio::PhoneNumbersApi* | [**view_phone_number_kyc_document**](docs/PhoneNumbersApi.md#view_phone_number_kyc_document) | **GET** /v1/phone-numbers/kyc/document/{documentId} | View a KYC document on file
 *Zernio::PostsApi* | [**bulk_upload_posts**](docs/PostsApi.md#bulk_upload_posts) | **POST** /v1/posts/bulk-upload | Bulk upload from CSV
 *Zernio::PostsApi* | [**create_post**](docs/PostsApi.md#create_post) | **POST** /v1/posts | Create post
 *Zernio::PostsApi* | [**delete_post**](docs/PostsApi.md#delete_post) | **DELETE** /v1/posts/{postId} | Delete post
@@ -1180,6 +1181,7 @@ Class | Method | HTTP request | Description
  - [Zernio::GetPhoneNumberKycForm200ResponseReusable](docs/GetPhoneNumberKycForm200ResponseReusable.md)
  - [Zernio::GetPhoneNumberKycForm200ResponseReusableDetailsInner](docs/GetPhoneNumberKycForm200ResponseReusableDetailsInner.md)
  - [Zernio::GetPhoneNumberKycForm200ResponseReusableOptionsInner](docs/GetPhoneNumberKycForm200ResponseReusableOptionsInner.md)
+ - [Zernio::GetPhoneNumberKycForm200ResponseReusableOptionsInnerDetailsInner](docs/GetPhoneNumberKycForm200ResponseReusableOptionsInnerDetailsInner.md)
  - [Zernio::GetPhoneNumberPortInOrderRequirements200Response](docs/GetPhoneNumberPortInOrderRequirements200Response.md)
  - [Zernio::GetPhoneNumberPortInOrderRequirements200ResponseRequirementsInner](docs/GetPhoneNumberPortInOrderRequirements200ResponseRequirementsInner.md)
  - [Zernio::GetPhoneNumberPortInRequirements200Response](docs/GetPhoneNumberPortInRequirements200Response.md)

data/docs/GetPhoneNumberKycForm200ResponseReusableOptionsInner.md

@@ -4,8 +4,10 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **from_phone_number** | **String** |  | [optional] |
-| **details** | [**Array<GetPhoneNumberKycForm200ResponseReusableDetailsInner>**](GetPhoneNumberKycForm200ResponseReusableDetailsInner.md) |  | [optional] |
+| **id** | **String** | Opaque option id — pass as `reuseOptionId` on POST. Stable selection key (a phone number is not unique across verifications). | [optional] |
+| **from_phone_number** | **String** | Display only — the number this verification was submitted for. Not a selection key. | [optional] |
+| **instant** | **Boolean** | true = group-approved, a new order activates in minutes; false = documents are reused but the order still queues for carrier review (1-3 days). | [optional] |
+| **details** | [**Array<GetPhoneNumberKycForm200ResponseReusableOptionsInnerDetailsInner>**](GetPhoneNumberKycForm200ResponseReusableOptionsInnerDetailsInner.md) |  | [optional] |
 
 ## Example
 
@@ -13,7 +15,9 @@
 require 'zernio-sdk'
 
 instance = Zernio::GetPhoneNumberKycForm200ResponseReusableOptionsInner.new(
+  id: null,
   from_phone_number: null,
+  instant: null,
   details: null
 )
 ```

data/docs/GetPhoneNumberKycForm200ResponseReusableOptionsInnerDetailsInner.md

@@ -0,0 +1,22 @@
+# Zernio::GetPhoneNumberKycForm200ResponseReusableOptionsInnerDetailsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **label** | **String** |  | [optional] |
+| **value** | **String** |  | [optional] |
+| **document_id** | **String** | Present on document rows — the Telnyx document id. GET /v1/whatsapp/phone-numbers/kyc/document/{documentId} streams it (auth-scoped, inline PDF). | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetPhoneNumberKycForm200ResponseReusableOptionsInnerDetailsInner.new(
+  label: null,
+  value: null,
+  document_id: null
+)
+```
+

data/docs/PhoneNumbersApi.md

@@ -26,6 +26,7 @@ All URIs are relative to *https://zernio.com/api*
 | [**upload_phone_number_kyc_document**](PhoneNumbersApi.md#upload_phone_number_kyc_document) | **POST** /v1/phone-numbers/kyc/upload-document | Upload a KYC document |
 | [**upload_phone_number_port_in_document**](PhoneNumbersApi.md#upload_phone_number_port_in_document) | **POST** /v1/phone-numbers/port-in/documents | Upload a porting document |
 | [**validate_phone_number_kyc_address**](PhoneNumbersApi.md#validate_phone_number_kyc_address) | **POST** /v1/phone-numbers/kyc/validate-address | Pre-validate KYC address |
+| [**view_phone_number_kyc_document**](PhoneNumbersApi.md#view_phone_number_kyc_document) | **GET** /v1/phone-numbers/kyc/document/{documentId} | View a KYC document on file |
 
 
 ## cancel_phone_number_port_in
@@ -1577,3 +1578,72 @@ end
 - **Content-Type**: application/json
 - **Accept**: application/json
 
+
+## view_phone_number_kyc_document
+
+> File view_phone_number_kyc_document(document_id)
+
+View a KYC document on file
+
+Stream a document backing a reusable verification (the `documentId` values from GET /v1/phone-numbers/kyc `reusable.options[].details[]`), so the account holder can see what's on file before reusing it. Returned inline as `application/pdf` (uploads are normalized to PDF). Auth-scoped: a document is viewable only when its id is referenced by one of the caller's own numbers — otherwise `404`. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'zernio-sdk'
+# setup authorization
+Zernio.configure do |config|
+  # Configure Bearer authorization (JWT): bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Zernio::PhoneNumbersApi.new
+document_id = 'document_id_example' # String | The Telnyx document id (from `reusable.options[].details[].documentId`).
+
+begin
+  # View a KYC document on file
+  result = api_instance.view_phone_number_kyc_document(document_id)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling PhoneNumbersApi->view_phone_number_kyc_document: #{e}"
+end
+```
+
+#### Using the view_phone_number_kyc_document_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(File, Integer, Hash)> view_phone_number_kyc_document_with_http_info(document_id)
+
+```ruby
+begin
+  # View a KYC document on file
+  data, status_code, headers = api_instance.view_phone_number_kyc_document_with_http_info(document_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => File
+rescue Zernio::ApiError => e
+  puts "Error when calling PhoneNumbersApi->view_phone_number_kyc_document_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **document_id** | **String** | The Telnyx document id (from &#x60;reusable.options[].details[].documentId&#x60;). |  |
+
+### Return type
+
+**File**
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/pdf, application/json
+

data/docs/SubmitPhoneNumberKycRequest.md

@@ -9,7 +9,8 @@
 | **submission_id** | **String** | Idempotency token for this submission attempt. A retry/double-submit with the same token returns the same number; omit and each call creates a new number. | [optional] |
 | **quantity** | **Integer** | Provision several same-country numbers from one submission (1-5). The single verification covers all of them; each number is billed only when it activates. Numbers that fail to order are skipped (best-effort). | [optional][default to 1] |
 | **reuse** | **Boolean** | Reuse a prior approved verification for this country (skips document/field collection; places the order immediately). | [optional] |
-| **reuse_from** | **String** | Which approved verification to reuse when several exist: the phone number it was originally approved for (GET reusable.options[].fromPhoneNumber). Omitted = newest. No match = 409. | [optional] |
+| **reuse_option_id** | **String** | Which reusable verification to use (GET reusable.options[].id). The unambiguous selection key. Omitted = the approved default. No match = 409. | [optional] |
+| **reuse_from** | **String** | Legacy fallback for `reuseOptionId`: the source phone number (GET reusable.options[].fromPhoneNumber). Ambiguous when a number labels two verifications — prefer `reuseOptionId`. Omitted = the approved default. No match = 409. | [optional] |
 | **end_user_first_name** | **String** | End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement. | [optional] |
 | **end_user_last_name** | **String** | End user's legal last name. Same condition as endUserFirstName. | [optional] |
 | **values** | **Hash<String, String>** | requirementId → textual value | [optional] |
@@ -27,6 +28,7 @@ instance = Zernio::SubmitPhoneNumberKycRequest.new(
   submission_id: null,
   quantity: null,
   reuse: null,
+  reuse_option_id: null,
   reuse_from: null,
   end_user_first_name: null,
   end_user_last_name: null,

data/docs/SubmitWhatsAppNumberKycRequest.md

@@ -9,7 +9,8 @@
 | **submission_id** | **String** | Idempotency token for this submission attempt. A retry/double-submit with the same token returns the same number; omit and each call creates a new number. | [optional] |
 | **quantity** | **Integer** | Provision several same-country numbers from one submission (1-5). The single verification covers all of them; each number is billed only when it activates. Numbers that fail to order are skipped (best-effort). | [optional][default to 1] |
 | **reuse** | **Boolean** | Reuse a prior approved verification for this country (skips document/field collection; places the order immediately). | [optional] |
-| **reuse_from** | **String** | Which approved verification to reuse when several exist: the phone number it was originally approved for (GET reusable.options[].fromPhoneNumber). Omitted = newest. No match = 409. | [optional] |
+| **reuse_option_id** | **String** | Which reusable verification to use (GET reusable.options[].id). The unambiguous selection key. Omitted = the approved default. No match = 409. | [optional] |
+| **reuse_from** | **String** | Legacy fallback for `reuseOptionId`: the source phone number (GET reusable.options[].fromPhoneNumber). Ambiguous when a number labels two verifications — prefer `reuseOptionId`. Omitted = the approved default. No match = 409. | [optional] |
 | **end_user_first_name** | **String** | End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement. | [optional] |
 | **end_user_last_name** | **String** | End user's legal last name. Same condition as endUserFirstName. | [optional] |
 | **values** | **Hash<String, String>** | requirementId → textual value | [optional] |
@@ -27,6 +28,7 @@ instance = Zernio::SubmitWhatsAppNumberKycRequest.new(
   submission_id: null,
   quantity: null,
   reuse: null,
+  reuse_option_id: null,
   reuse_from: null,
   end_user_first_name: null,
   end_user_last_name: null,

data/lib/zernio-sdk/api/phone_numbers_api.rb

@@ -1514,5 +1514,68 @@ module Zernio
       end
       return data, status_code, headers
     end
+
+    # View a KYC document on file
+    # Stream a document backing a reusable verification (the `documentId` values from GET /v1/phone-numbers/kyc `reusable.options[].details[]`), so the account holder can see what's on file before reusing it. Returned inline as `application/pdf` (uploads are normalized to PDF). Auth-scoped: a document is viewable only when its id is referenced by one of the caller's own numbers — otherwise `404`. 
+    # @param document_id [String] The Telnyx document id (from `reusable.options[].details[].documentId`).
+    # @param [Hash] opts the optional parameters
+    # @return [File]
+    def view_phone_number_kyc_document(document_id, opts = {})
+      data, _status_code, _headers = view_phone_number_kyc_document_with_http_info(document_id, opts)
+      data
+    end
+
+    # View a KYC document on file
+    # Stream a document backing a reusable verification (the `documentId` values from GET /v1/phone-numbers/kyc `reusable.options[].details[]`), so the account holder can see what's on file before reusing it. Returned inline as `application/pdf` (uploads are normalized to PDF). Auth-scoped: a document is viewable only when its id is referenced by one of the caller's own numbers — otherwise `404`. 
+    # @param document_id [String] The Telnyx document id (from `reusable.options[].details[].documentId`).
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
+    def view_phone_number_kyc_document_with_http_info(document_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PhoneNumbersApi.view_phone_number_kyc_document ...'
+      end
+      # verify the required parameter 'document_id' is set
+      if @api_client.config.client_side_validation && document_id.nil?
+        fail ArgumentError, "Missing the required parameter 'document_id' when calling PhoneNumbersApi.view_phone_number_kyc_document"
+      end
+      # resource path
+      local_var_path = '/v1/phone-numbers/kyc/document/{documentId}'.sub('{' + 'documentId' + '}', CGI.escape(document_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/pdf', 'application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'File'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"PhoneNumbersApi.view_phone_number_kyc_document",
+        :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(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PhoneNumbersApi#view_phone_number_kyc_document\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
   end
 end

data/lib/zernio-sdk/models/get_phone_number_kyc_form200_response_reusable.rb

@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module Zernio
-  # Present when this account already has an approved verification for the country that can be reused (skip the form). `fromPhoneNumber`/`details` mirror the newest option; `options` lists ALL approved verifications (agencies hold one per end client) — pass the chosen option's `fromPhoneNumber` as `reuseFrom` on POST.
+  # Present when this account already has a reusable verification for the country (skip the form). `fromPhoneNumber`/`details` mirror the first option; `options` lists ALL reusable verifications (agencies hold one per end client), approved-first. Pass the chosen option's `id` as `reuseOptionId` on POST. Each option's `instant` says whether it activates in minutes (group-approved) or still queues for carrier review (1-3 days).
   class GetPhoneNumberKycForm200ResponseReusable < ApiModelBase
     attr_accessor :available
 

data/lib/zernio-sdk/models/get_phone_number_kyc_form200_response_reusable_options_inner.rb

@@ -15,14 +15,23 @@ require 'time'
 
 module Zernio
   class GetPhoneNumberKycForm200ResponseReusableOptionsInner < ApiModelBase
+    # Opaque option id — pass as `reuseOptionId` on POST. Stable selection key (a phone number is not unique across verifications).
+    attr_accessor :id
+
+    # Display only — the number this verification was submitted for. Not a selection key.
     attr_accessor :from_phone_number
 
+    # true = group-approved, a new order activates in minutes; false = documents are reused but the order still queues for carrier review (1-3 days).
+    attr_accessor :instant
+
     attr_accessor :details
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
+        :'id' => :'id',
         :'from_phone_number' => :'fromPhoneNumber',
+        :'instant' => :'instant',
         :'details' => :'details'
       }
     end
@@ -40,8 +49,10 @@ module Zernio
     # Attribute type mapping.
     def self.openapi_types
       {
+        :'id' => :'String',
         :'from_phone_number' => :'String',
-        :'details' => :'Array<GetPhoneNumberKycForm200ResponseReusableDetailsInner>'
+        :'instant' => :'Boolean',
+        :'details' => :'Array<GetPhoneNumberKycForm200ResponseReusableOptionsInnerDetailsInner>'
       }
     end
 
@@ -67,10 +78,18 @@ module Zernio
         h[k.to_sym] = v
       }
 
+      if attributes.key?(:'id')
+        self.id = attributes[:'id']
+      end
+
       if attributes.key?(:'from_phone_number')
         self.from_phone_number = attributes[:'from_phone_number']
       end
 
+      if attributes.key?(:'instant')
+        self.instant = attributes[:'instant']
+      end
+
       if attributes.key?(:'details')
         if (value = attributes[:'details']).is_a?(Array)
           self.details = value
@@ -98,7 +117,9 @@ module Zernio
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
+          id == o.id &&
           from_phone_number == o.from_phone_number &&
+          instant == o.instant &&
           details == o.details
     end
 
@@ -111,7 +132,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [from_phone_number, details].hash
+      [id, from_phone_number, instant, details].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/get_phone_number_kyc_form200_response_reusable_options_inner_details_inner.rb

@@ -0,0 +1,166 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Zernio
+  class GetPhoneNumberKycForm200ResponseReusableOptionsInnerDetailsInner < ApiModelBase
+    attr_accessor :label
+
+    attr_accessor :value
+
+    # Present on document rows — the Telnyx document id. GET /v1/whatsapp/phone-numbers/kyc/document/{documentId} streams it (auth-scoped, inline PDF).
+    attr_accessor :document_id
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'label' => :'label',
+        :'value' => :'value',
+        :'document_id' => :'documentId'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'label' => :'String',
+        :'value' => :'String',
+        :'document_id' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::GetPhoneNumberKycForm200ResponseReusableOptionsInnerDetailsInner` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::GetPhoneNumberKycForm200ResponseReusableOptionsInnerDetailsInner`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'label')
+        self.label = attributes[:'label']
+      end
+
+      if attributes.key?(:'value')
+        self.value = attributes[:'value']
+      end
+
+      if attributes.key?(:'document_id')
+        self.document_id = attributes[:'document_id']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          label == o.label &&
+          value == o.value &&
+          document_id == o.document_id
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [label, value, document_id].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/zernio-sdk/models/submit_phone_number_kyc_request.rb

@@ -28,7 +28,10 @@ module Zernio
     # Reuse a prior approved verification for this country (skips document/field collection; places the order immediately).
     attr_accessor :reuse
 
-    # Which approved verification to reuse when several exist: the phone number it was originally approved for (GET reusable.options[].fromPhoneNumber). Omitted = newest. No match = 409.
+    # Which reusable verification to use (GET reusable.options[].id). The unambiguous selection key. Omitted = the approved default. No match = 409.
+    attr_accessor :reuse_option_id
+
+    # Legacy fallback for `reuseOptionId`: the source phone number (GET reusable.options[].fromPhoneNumber). Ambiguous when a number labels two verifications — prefer `reuseOptionId`. Omitted = the approved default. No match = 409.
     attr_accessor :reuse_from
 
     # End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement.
@@ -53,6 +56,7 @@ module Zernio
         :'submission_id' => :'submissionId',
         :'quantity' => :'quantity',
         :'reuse' => :'reuse',
+        :'reuse_option_id' => :'reuseOptionId',
         :'reuse_from' => :'reuseFrom',
         :'end_user_first_name' => :'endUserFirstName',
         :'end_user_last_name' => :'endUserLastName',
@@ -80,6 +84,7 @@ module Zernio
         :'submission_id' => :'String',
         :'quantity' => :'Integer',
         :'reuse' => :'Boolean',
+        :'reuse_option_id' => :'String',
         :'reuse_from' => :'String',
         :'end_user_first_name' => :'String',
         :'end_user_last_name' => :'String',
@@ -137,6 +142,10 @@ module Zernio
         self.reuse = attributes[:'reuse']
       end
 
+      if attributes.key?(:'reuse_option_id')
+        self.reuse_option_id = attributes[:'reuse_option_id']
+      end
+
       if attributes.key?(:'reuse_from')
         self.reuse_from = attributes[:'reuse_from']
       end
@@ -249,6 +258,7 @@ module Zernio
           submission_id == o.submission_id &&
           quantity == o.quantity &&
           reuse == o.reuse &&
+          reuse_option_id == o.reuse_option_id &&
           reuse_from == o.reuse_from &&
           end_user_first_name == o.end_user_first_name &&
           end_user_last_name == o.end_user_last_name &&
@@ -266,7 +276,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [profile_id, country, submission_id, quantity, reuse, reuse_from, end_user_first_name, end_user_last_name, values, documents, address].hash
+      [profile_id, country, submission_id, quantity, reuse, reuse_option_id, reuse_from, end_user_first_name, end_user_last_name, values, documents, address].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/submit_whats_app_number_kyc_request.rb

@@ -28,7 +28,10 @@ module Zernio
     # Reuse a prior approved verification for this country (skips document/field collection; places the order immediately).
     attr_accessor :reuse
 
-    # Which approved verification to reuse when several exist: the phone number it was originally approved for (GET reusable.options[].fromPhoneNumber). Omitted = newest. No match = 409.
+    # Which reusable verification to use (GET reusable.options[].id). The unambiguous selection key. Omitted = the approved default. No match = 409.
+    attr_accessor :reuse_option_id
+
+    # Legacy fallback for `reuseOptionId`: the source phone number (GET reusable.options[].fromPhoneNumber). Ambiguous when a number labels two verifications — prefer `reuseOptionId`. Omitted = the approved default. No match = 409.
     attr_accessor :reuse_from
 
     # End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement.
@@ -53,6 +56,7 @@ module Zernio
         :'submission_id' => :'submissionId',
         :'quantity' => :'quantity',
         :'reuse' => :'reuse',
+        :'reuse_option_id' => :'reuseOptionId',
         :'reuse_from' => :'reuseFrom',
         :'end_user_first_name' => :'endUserFirstName',
         :'end_user_last_name' => :'endUserLastName',
@@ -80,6 +84,7 @@ module Zernio
         :'submission_id' => :'String',
         :'quantity' => :'Integer',
         :'reuse' => :'Boolean',
+        :'reuse_option_id' => :'String',
         :'reuse_from' => :'String',
         :'end_user_first_name' => :'String',
         :'end_user_last_name' => :'String',
@@ -137,6 +142,10 @@ module Zernio
         self.reuse = attributes[:'reuse']
       end
 
+      if attributes.key?(:'reuse_option_id')
+        self.reuse_option_id = attributes[:'reuse_option_id']
+      end
+
       if attributes.key?(:'reuse_from')
         self.reuse_from = attributes[:'reuse_from']
       end
@@ -249,6 +258,7 @@ module Zernio
           submission_id == o.submission_id &&
           quantity == o.quantity &&
           reuse == o.reuse &&
+          reuse_option_id == o.reuse_option_id &&
           reuse_from == o.reuse_from &&
           end_user_first_name == o.end_user_first_name &&
           end_user_last_name == o.end_user_last_name &&
@@ -266,7 +276,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [profile_id, country, submission_id, quantity, reuse, reuse_from, end_user_first_name, end_user_last_name, values, documents, address].hash
+      [profile_id, country, submission_id, quantity, reuse, reuse_option_id, reuse_from, end_user_first_name, end_user_last_name, values, documents, address].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.19.0
 =end
 
 module Zernio
-  VERSION = '0.0.554'
+  VERSION = '0.0.556'
 end

data/lib/zernio-sdk.rb

@@ -612,6 +612,7 @@ require 'zernio-sdk/models/get_phone_number_kyc_form200_response_fields_inner'
 require 'zernio-sdk/models/get_phone_number_kyc_form200_response_reusable'
 require 'zernio-sdk/models/get_phone_number_kyc_form200_response_reusable_details_inner'
 require 'zernio-sdk/models/get_phone_number_kyc_form200_response_reusable_options_inner'
+require 'zernio-sdk/models/get_phone_number_kyc_form200_response_reusable_options_inner_details_inner'
 require 'zernio-sdk/models/get_phone_number_port_in_order_requirements200_response'
 require 'zernio-sdk/models/get_phone_number_port_in_order_requirements200_response_requirements_inner'
 require 'zernio-sdk/models/get_phone_number_port_in_requirements200_response'