trinsic_api 2.0.0.pre.alpha3 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (183) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +1 -1
  3. data/docs/AttachmentsApi.md +1 -1
  4. data/docs/BrazilDigitalCnhInput.md +2 -2
  5. data/docs/CreateAdvancedProviderSessionRequest.md +3 -3
  6. data/docs/CreateHostedProviderSessionResponse.md +4 -2
  7. data/docs/CreateWidgetSessionRequest.md +3 -3
  8. data/docs/CreateWidgetSessionResponse.md +4 -2
  9. data/docs/IdentityData.md +2 -0
  10. data/docs/IdinInput.md +18 -0
  11. data/docs/IntegrationStep.md +1 -1
  12. data/docs/Language.md +15 -0
  13. data/docs/ListProviderContractsResponse.md +18 -0
  14. data/docs/MobileIdInput.md +22 -0
  15. data/docs/NetworkApi.md +71 -4
  16. data/docs/ProviderContract.md +48 -0
  17. data/docs/ProviderHealth.md +15 -0
  18. data/docs/ProviderInfo.md +1 -3
  19. data/docs/ProviderInformation.md +3 -3
  20. data/docs/ProviderInput.md +24 -12
  21. data/docs/RecommendRequest.md +2 -10
  22. data/docs/RecommendationInfo.md +24 -0
  23. data/docs/ResultCollection.md +2 -2
  24. data/docs/Session.md +3 -3
  25. data/docs/SessionsApi.md +2 -2
  26. data/docs/SmartIdInput.md +18 -0
  27. data/docs/SpidInput.md +18 -0
  28. data/docs/StepRefreshInfo.md +1 -1
  29. data/docs/SubProviderMetadata.md +24 -0
  30. data/docs/TrinsicTestDatabaseLookupInput.md +24 -0
  31. data/docs/TrinsicTestSubProvidersInput.md +18 -0
  32. data/docs/WellKnownApi.md +71 -0
  33. data/lib/trinsic_api/api/attachments_api.rb +3 -3
  34. data/lib/trinsic_api/api/network_api.rb +60 -3
  35. data/lib/trinsic_api/api/sessions_api.rb +5 -5
  36. data/lib/trinsic_api/api/well_known_api.rb +75 -0
  37. data/lib/trinsic_api/api_client.rb +8 -9
  38. data/lib/trinsic_api/api_error.rb +1 -1
  39. data/lib/trinsic_api/configuration.rb +1 -1
  40. data/lib/trinsic_api/models/aadhaar_input.rb +10 -4
  41. data/lib/trinsic_api/models/address.rb +10 -4
  42. data/lib/trinsic_api/models/attachment_access_keys.rb +20 -4
  43. data/lib/trinsic_api/models/bangladesh_national_id_input.rb +10 -4
  44. data/lib/trinsic_api/models/brazil_cpf_check_input.rb +10 -4
  45. data/lib/trinsic_api/models/brazil_digital_cnh_input.rb +12 -6
  46. data/lib/trinsic_api/models/cancel_session_response.rb +20 -4
  47. data/lib/trinsic_api/models/create_advanced_provider_session_request.rb +13 -7
  48. data/lib/trinsic_api/models/create_advanced_provider_session_response.rb +40 -4
  49. data/lib/trinsic_api/models/create_hosted_provider_session_request.rb +10 -4
  50. data/lib/trinsic_api/models/create_hosted_provider_session_response.rb +69 -10
  51. data/lib/trinsic_api/models/create_widget_session_request.rb +20 -14
  52. data/lib/trinsic_api/models/create_widget_session_response.rb +69 -10
  53. data/lib/trinsic_api/models/document_data.rb +10 -4
  54. data/lib/trinsic_api/models/document_scan_attachments.rb +10 -4
  55. data/lib/trinsic_api/models/document_type.rb +1 -1
  56. data/lib/trinsic_api/models/get_attachment_request.rb +10 -4
  57. data/lib/trinsic_api/models/get_attachment_response.rb +30 -4
  58. data/lib/trinsic_api/models/get_session_response.rb +20 -4
  59. data/lib/trinsic_api/models/get_session_result_request.rb +20 -4
  60. data/lib/trinsic_api/models/get_session_result_response.rb +20 -4
  61. data/lib/trinsic_api/models/http_validation_problem_details.rb +10 -4
  62. data/lib/trinsic_api/models/identity_data.rb +21 -5
  63. data/lib/trinsic_api/models/{known_identity_data.rb → idin_input.rb} +21 -16
  64. data/lib/trinsic_api/models/indonesia_nik_input.rb +20 -4
  65. data/lib/trinsic_api/models/integration_capability.rb +1 -1
  66. data/lib/trinsic_api/models/integration_launch_method.rb +3 -3
  67. data/lib/trinsic_api/models/integration_step.rb +30 -6
  68. data/lib/trinsic_api/models/kenya_nid_input.rb +20 -4
  69. data/lib/trinsic_api/models/language.rb +42 -0
  70. data/lib/trinsic_api/models/{known_address.rb → list_provider_contracts_response.rb} +39 -86
  71. data/lib/trinsic_api/models/list_providers_response.rb +20 -4
  72. data/lib/trinsic_api/models/list_sessions_response.rb +40 -4
  73. data/lib/trinsic_api/models/mexico_curp_input.rb +10 -4
  74. data/lib/trinsic_api/models/mobile_id_input.rb +266 -0
  75. data/lib/trinsic_api/models/nigeria_nin_input.rb +20 -4
  76. data/lib/trinsic_api/models/order_direction.rb +1 -1
  77. data/lib/trinsic_api/models/person_data.rb +10 -4
  78. data/lib/trinsic_api/models/philippine_match_input.rb +10 -4
  79. data/lib/trinsic_api/models/philippine_qr_input.rb +10 -4
  80. data/lib/trinsic_api/models/problem_details.rb +10 -4
  81. data/lib/trinsic_api/models/provider_attachments.rb +10 -4
  82. data/lib/trinsic_api/models/provider_contract.rb +655 -0
  83. data/lib/trinsic_api/models/provider_health.rb +40 -0
  84. data/lib/trinsic_api/models/provider_info.rb +44 -21
  85. data/lib/trinsic_api/models/provider_information.rb +40 -4
  86. data/lib/trinsic_api/models/provider_input.rb +92 -20
  87. data/lib/trinsic_api/models/recommend_request.rb +19 -63
  88. data/lib/trinsic_api/models/recommend_response.rb +40 -4
  89. data/lib/trinsic_api/models/recommendation_info.rb +262 -0
  90. data/lib/trinsic_api/models/refresh_step_content_request.rb +10 -4
  91. data/lib/trinsic_api/models/refresh_step_content_response.rb +20 -4
  92. data/lib/trinsic_api/models/result_collection.rb +38 -6
  93. data/lib/trinsic_api/models/result_collection_method.rb +1 -1
  94. data/lib/trinsic_api/models/session.rb +63 -7
  95. data/lib/trinsic_api/models/session_error_code.rb +1 -1
  96. data/lib/trinsic_api/models/session_ordering.rb +1 -1
  97. data/lib/trinsic_api/models/sex.rb +1 -1
  98. data/lib/trinsic_api/models/smart_id_input.rb +222 -0
  99. data/lib/trinsic_api/models/south_africa_nid_input.rb +20 -4
  100. data/lib/trinsic_api/models/spid_input.rb +222 -0
  101. data/lib/trinsic_api/models/step_refresh_info.rb +41 -5
  102. data/lib/trinsic_api/models/sub_provider_metadata.rb +320 -0
  103. data/lib/trinsic_api/models/{known_person_data.rb → trinsic_test_database_lookup_input.rb} +31 -69
  104. data/lib/trinsic_api/models/trinsic_test_sub_providers_input.rb +222 -0
  105. data/lib/trinsic_api/version.rb +2 -2
  106. data/lib/trinsic_api.rb +14 -4
  107. data/spec/api/attachments_api_spec.rb +2 -2
  108. data/spec/api/network_api_spec.rb +13 -2
  109. data/spec/api/sessions_api_spec.rb +3 -3
  110. data/spec/api/well_known_api_spec.rb +44 -0
  111. data/spec/models/aadhaar_input_spec.rb +1 -1
  112. data/spec/models/address_spec.rb +1 -1
  113. data/spec/models/attachment_access_keys_spec.rb +1 -1
  114. data/spec/models/bangladesh_national_id_input_spec.rb +1 -1
  115. data/spec/models/brazil_cpf_check_input_spec.rb +1 -1
  116. data/spec/models/brazil_digital_cnh_input_spec.rb +1 -1
  117. data/spec/models/cancel_session_response_spec.rb +1 -1
  118. data/spec/models/create_advanced_provider_session_request_spec.rb +1 -1
  119. data/spec/models/create_advanced_provider_session_response_spec.rb +1 -1
  120. data/spec/models/create_hosted_provider_session_request_spec.rb +1 -1
  121. data/spec/models/create_hosted_provider_session_response_spec.rb +7 -1
  122. data/spec/models/create_widget_session_request_spec.rb +2 -2
  123. data/spec/models/create_widget_session_response_spec.rb +7 -1
  124. data/spec/models/document_data_spec.rb +1 -1
  125. data/spec/models/document_scan_attachments_spec.rb +1 -1
  126. data/spec/models/document_type_spec.rb +1 -1
  127. data/spec/models/get_attachment_request_spec.rb +1 -1
  128. data/spec/models/get_attachment_response_spec.rb +1 -1
  129. data/spec/models/get_session_response_spec.rb +1 -1
  130. data/spec/models/get_session_result_request_spec.rb +1 -1
  131. data/spec/models/get_session_result_response_spec.rb +1 -1
  132. data/spec/models/http_validation_problem_details_spec.rb +1 -1
  133. data/spec/models/identity_data_spec.rb +7 -1
  134. data/spec/models/{known_identity_data_spec.rb → idin_input_spec.rb} +8 -8
  135. data/spec/models/indonesia_nik_input_spec.rb +1 -1
  136. data/spec/models/integration_capability_spec.rb +1 -1
  137. data/spec/models/integration_launch_method_spec.rb +1 -1
  138. data/spec/models/integration_step_spec.rb +1 -1
  139. data/spec/models/kenya_nid_input_spec.rb +1 -1
  140. data/spec/models/language_spec.rb +30 -0
  141. data/spec/models/list_provider_contracts_response_spec.rb +36 -0
  142. data/spec/models/list_providers_response_spec.rb +1 -1
  143. data/spec/models/list_sessions_response_spec.rb +1 -1
  144. data/spec/models/mexico_curp_input_spec.rb +1 -1
  145. data/spec/models/mobile_id_input_spec.rb +48 -0
  146. data/spec/models/nigeria_nin_input_spec.rb +1 -1
  147. data/spec/models/order_direction_spec.rb +1 -1
  148. data/spec/models/person_data_spec.rb +1 -1
  149. data/spec/models/philippine_match_input_spec.rb +1 -1
  150. data/spec/models/philippine_qr_input_spec.rb +1 -1
  151. data/spec/models/problem_details_spec.rb +1 -1
  152. data/spec/models/provider_attachments_spec.rb +1 -1
  153. data/spec/models/provider_contract_spec.rb +126 -0
  154. data/spec/models/provider_health_spec.rb +30 -0
  155. data/spec/models/provider_info_spec.rb +1 -7
  156. data/spec/models/provider_information_spec.rb +1 -1
  157. data/spec/models/provider_input_spec.rb +37 -1
  158. data/spec/models/recommend_request_spec.rb +2 -26
  159. data/spec/models/recommend_response_spec.rb +1 -1
  160. data/spec/models/recommendation_info_spec.rb +54 -0
  161. data/spec/models/refresh_step_content_request_spec.rb +1 -1
  162. data/spec/models/refresh_step_content_response_spec.rb +1 -1
  163. data/spec/models/result_collection_method_spec.rb +1 -1
  164. data/spec/models/result_collection_spec.rb +1 -1
  165. data/spec/models/session_error_code_spec.rb +1 -1
  166. data/spec/models/session_ordering_spec.rb +1 -1
  167. data/spec/models/session_spec.rb +1 -1
  168. data/spec/models/sex_spec.rb +1 -1
  169. data/spec/models/smart_id_input_spec.rb +36 -0
  170. data/spec/models/south_africa_nid_input_spec.rb +1 -1
  171. data/spec/models/spid_input_spec.rb +36 -0
  172. data/spec/models/step_refresh_info_spec.rb +1 -1
  173. data/spec/models/sub_provider_metadata_spec.rb +54 -0
  174. data/spec/models/trinsic_test_database_lookup_input_spec.rb +54 -0
  175. data/spec/models/trinsic_test_sub_providers_input_spec.rb +36 -0
  176. data/spec/spec_helper.rb +1 -1
  177. data/trinsic_api.gemspec +1 -1
  178. metadata +96 -56
  179. data/docs/KnownAddress.md +0 -32
  180. data/docs/KnownIdentityData.md +0 -18
  181. data/docs/KnownPersonData.md +0 -32
  182. data/spec/models/known_address_spec.rb +0 -78
  183. data/spec/models/known_person_data_spec.rb +0 -78
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 52a9b11625e2f73927d0a96e3c33c2755eae31d9c04a162ab7a85b91be2f6fa6
4
- data.tar.gz: 189f8f249163f376410a00d52c13f3997d09a8ce19e27cce24cbfbeb96e91454
3
+ metadata.gz: c4f23ecceaf01bbc42f2fa2089457277132aa516d5820a316da9d9ea75f3cfb6
4
+ data.tar.gz: 10caa0a74ff4142f0c536c2a95adc0cc04888d80f2f3fd357af99a87a9c2560b
5
5
  SHA512:
6
- metadata.gz: b44904314be04019690dc752bd2943229a7570a7abaf618ac8da70a5ec72597ff7387c8621c7d5d440b6aa23f1e00ee69eb1180eaa6a28e0ccb3bb048a3e3ec2
7
- data.tar.gz: 2ead6f95554841b749d19d97a5e49319b8962e018f2ad61ec1a6a6f5debb4ebda1953994420af4154212dfefc702bdf777bd789490b2f9f87da14fb153e25155
6
+ metadata.gz: 4024fb98584c58df4d3cb55d4e3330a68db481f8ce495b9ff7ae669a0105454a9902bd4eb8d036b555f125d1838acd590c1e94d50c5127905a866c58958c76e5
7
+ data.tar.gz: c3766c8b8116a393e621f711ba475fb3659f48874d7531ef810884d3285f84cc5628d652b7262c33664e2e1a0572ee83e6e62fffd16277a5957e6d03d90b3b4d
data/README.md CHANGED
@@ -38,7 +38,7 @@ attachments = TrinsicApi::AttachmentsApi.new
38
38
  network = TrinsicApi::NetworkApi.new
39
39
  sessions = TrinsicApi::SessionsApi.new
40
40
 
41
- sessions.create_session({})
41
+ sessions.create_widget_session({})
42
42
  ```
43
43
 
44
44
  You can find a full Ruby server example in the [samples](https://github.com/trinsic-id/sdk/tree/main/api-ruby/samples) folder.
@@ -13,7 +13,7 @@ All URIs are relative to *https://api.trinsic.id*
13
13
 
14
14
  Get Attachment
15
15
 
16
- Exchange an Attachment Access Key (from `IdentityData.Attachments`) for the raw contents of the attachment. Use this API to fetch document (front, back, portrait) or other (selfie) images from a verification, if relevant. In some cases, attachments may not be immediately available after a verification is completed. If so, this endpoint will return an HTTP 503 code, and you should try again later.
16
+ Exchange an Attachment Access Key (from `IdentityData.Attachments`) for the raw contents of the attachment. Use this API to fetch document (front, back, portrait) or other (selfie) images from a verification, if relevant. In some cases, attachments may not be immediately available after a verification is completed. If so, this endpoint will return an HTTP 503 code, and you should try again later.
17
17
 
18
18
  ### Examples
19
19
 
@@ -5,8 +5,8 @@
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
7
  | **cpf_number** | **String** | The user's 11-digit, numeric CPF Number | |
8
- | **digital_cnh_file** | **String** | The raw bytes of the digital CNH file collected from the user. TODO: Lucas or JP help me describe these below vvvvvvvv This can be: - An image containing a physical or digital QR code - A PDF file exported from the CNH app - Some scary third thing? | [optional] |
9
- | **digital_cnh_file_content_type** | **String** | The MIME Type of the file contained in `DigitalCnhFile`. Must be one of `application/pdf`, `image/jpeg`, or `image/png`. | [optional] |
8
+ | **digital_cnh_file** | **String** | The raw bytes of the digital CNH file collected from the user. TODO: Lucas or JP help me describe these below vvvvvvvv This can be: - An image containing a physical or digital QR code - A PDF file exported from the CNH app - Some scary third thing? | [optional] |
9
+ | **digital_cnh_file_content_type** | **String** | The MIME Type of the file contained in `DigitalCnhFile`. Must be one of `application/pdf`, `image/jpeg`, or `image/png`. | [optional] |
10
10
  | **facial_biometry_photo** | **String** | The raw bytes of the image of the user's face, collected for biometric comparison. | [optional] |
11
11
 
12
12
  ## Example
@@ -6,9 +6,9 @@
6
6
  | ---- | ---- | ----------- | ----- |
7
7
  | **provider** | **String** | The ID of the provider to launch | |
8
8
  | **provider_input** | [**ProviderInput**](ProviderInput.md) | Provider-specific input for those providers which require it. | [optional] |
9
- | **redirect_url** | **String** | The Redirect URL to which the user should be sent after the session is complete. This field is required for providers which employ a redirect-based flow. | [optional] |
10
- | **capabilities** | [**Array<IntegrationCapability>**](IntegrationCapability.md) | The list of capabilities your integration supports. Capabilities are the core of Trinsic's whitelabel-with-optional-fallback offering. Most capabilities align with either an `IntegrationLaunchMethod` or an `IntegrationCollectionMethod`. The exception being refresh content to support updating the content of the launch method. For example, to support a basic redirect-based flow, you must include the `LaunchRedirect` and `CaptureRedirect` capabilities. To support a mobile deeplink / polling flow, you must include the `DeeplinkToMobile` and `PollForResults` capabilities. If `FallbackToHostedUi` is `true`, Trinsic will automatically fall back to a Trinsic-hosted UI to cover any gaps in your integration's capabilities. If `FallbackToHostedUi` is `false`, gaps in your integration's capabilities will result in an error during Session creation. Read more on how to integrate at <a href=\"https://docs.trinsic.id/docs/advanced-provider-sessions\">the guide on Advanced Provider Sessions</a> | |
11
- | **fallback_to_hosted_ui** | **Boolean** | Whether the session should fall back to a Trinsic-hosted UI in certain instances. Specifically, fallback will occur if any of the following are true: - You attempted to launch a provider which requires a capability you did not express support for - In this case, Trinsic's hosted UI will perform the necessary capability - You attempted to launch a provider which requires input, and the input was either not provided or incomplete - In this case, Trinsic's hosted UI will collect the necessary input from the user If fallback occurs, the session's NextStep will always be LaunchBrowser, and the CollectionMethod will always be CaptureRedirect. If this field is set to `true`, you must also: 1. Set the `RedirectUrl` field to a non-empty value 2. Include the `LaunchBrowser` and `CaptureRedirect` capabilities in the `Capabilities` field | [optional] |
9
+ | **redirect_url** | **String** | The Redirect URL to which the user should be sent after the session is complete. This field is required for providers which employ a redirect-based flow. | [optional] |
10
+ | **capabilities** | [**Array<IntegrationCapability>**](IntegrationCapability.md) | The list of capabilities your integration supports. Capabilities are the core of Trinsic's whitelabel-with-optional-fallback offering. Most capabilities align with either an `IntegrationLaunchMethod` or an `IntegrationCollectionMethod`. The exception being refresh content to support updating the content of the launch method. For example, to support a basic redirect-based flow, you must include the `LaunchRedirect` and `CaptureRedirect` capabilities. To support a mobile deeplink / polling flow, you must include the `DeeplinkToMobile` and `PollForResults` capabilities. If `FallbackToHostedUi` is `true`, Trinsic will automatically fall back to a Trinsic-hosted UI to cover any gaps in your integration's capabilities. If `FallbackToHostedUi` is `false`, gaps in your integration's capabilities will result in an error during Session creation. Read more on how to integrate at <a href=\"https://docs.trinsic.id/docs/advanced-provider-sessions\">the guide on Advanced Provider Sessions</a> | |
11
+ | **fallback_to_hosted_ui** | **Boolean** | Whether the session should fall back to a Trinsic-hosted UI in certain instances. Specifically, fallback will occur if any of the following are true: - You attempted to launch a provider which requires a capability you did not express support for - In this case, Trinsic's hosted UI will perform the necessary capability - You attempted to launch a provider which requires input, and the input was either not provided or incomplete - In this case, Trinsic's hosted UI will collect the necessary input from the user If fallback occurs, the session's NextStep will always be LaunchBrowser, and the CollectionMethod will always be CaptureRedirect. If this field is set to `true`, you must also: 1. Set the `RedirectUrl` field to a non-empty value 2. Include the `LaunchBrowser` and `CaptureRedirect` capabilities in the `Capabilities` field | [optional] |
12
12
 
13
13
  ## Example
14
14
 
@@ -5,7 +5,8 @@
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
7
  | **session_id** | **String** | The ID of the newly-created Acceptance Session | |
8
- | **launch_url** | **String** | The URL that should be used to launch the Hosted Provider Session on your user's device. There are two recommended ways to do so: - Redirect their browser to the `LaunchUrl` as a top-level navigation - Open a popup window and navigate it to the `LaunchUrl` This URL is sensitive and as such can only be obtained once. If you need to obtain it again, you will need to create a new Acceptance Session. | [optional] |
8
+ | **launch_url** | **String** | The URL that should be used to launch the Hosted Provider Session on your user's device. There are two recommended ways to do so: - Redirect their browser to the `LaunchUrl` as a top-level navigation - Open a popup window and navigate it to the `LaunchUrl` This URL is sensitive and as such can only be obtained once. If you need to obtain it again, you will need to create a new Acceptance Session. | |
9
+ | **results_access_key** | **String** | The `resultsAccessKey` for the Acceptance Session. This is an encrypted payload which contains the decryption key necessary to access the Session's Data Vault. Save this securely in your systems; it must be passed back with any API call which requires access to the Session's Data Vault. Trinsic cannot access a Session's Data Vault without this key. | |
9
10
 
10
11
  ## Example
11
12
 
@@ -14,7 +15,8 @@ require 'trinsic_api'
14
15
 
15
16
  instance = TrinsicApi::CreateHostedProviderSessionResponse.new(
16
17
  session_id: null,
17
- launch_url: https://api.trinsic.id/api/session/launch?clientToken=...
18
+ launch_url: https://api.trinsic.id/api/session/launch?clientToken=...,
19
+ results_access_key: 417zNGHMJp6Ht2jCoktTLNGDRZEt4BqTwwQ8Q9ZaQz8aS4Jd7nD1xff2WLhPS69j5q9QT4gvgV79Gv7QtaXwu5YC9Utr35...
18
20
  )
19
21
  ```
20
22
 
@@ -4,9 +4,9 @@
4
4
 
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
- | **redirect_url** | **String** | The URL to redirect the user to after the widget session is complete. *Note*: this should NOT be set if you intend to use Trinsic's Web UI SDK to launch the Widget as an embedded iFrame or popup; in that case, session resolution is handled by our SDK, not via redirect. | [optional] |
7
+ | **redirect_url** | **String** | The URL to redirect the user to after the widget session is complete. *Note*: this should NOT be set if you intend to use Trinsic's Web UI SDK to launch the Widget as an embedded iFrame or popup; in that case, session resolution is handled by our SDK, not via redirect. | [optional] |
8
8
  | **providers** | **Array<String>** | The list of allowed identity providers. If not specified, all available providers will be allowed. | [optional] |
9
- | **known_identity_data** | [**KnownIdentityData**](KnownIdentityData.md) | Known identity data of an individual being verified. Provide this to Trinsic during Session creation to enable improved identity provider selection recommendations. | [optional] |
9
+ | **recommendation_info** | [**RecommendationInfo**](RecommendationInfo.md) | Data that you already know about the user being verified. This data is used to improve the user experience during provider selection, by surfacing the most relevant providers first. | [optional] |
10
10
 
11
11
  ## Example
12
12
 
@@ -16,7 +16,7 @@ require 'trinsic_api'
16
16
  instance = TrinsicApi::CreateWidgetSessionRequest.new(
17
17
  redirect_url: null,
18
18
  providers: null,
19
- known_identity_data: null
19
+ recommendation_info: null
20
20
  )
21
21
  ```
22
22
 
@@ -5,7 +5,8 @@
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
7
  | **session_id** | **String** | The ID of the newly-created Acceptance Session | |
8
- | **launch_url** | **String** | The URL that should be used to invoke the Acceptance Session on your user's device. You can use our frontend SDKs to launch the user into the Acceptance Session, or you can redirect the user's browser to this URL. This URL is sensitive and as such can only be obtained once. If you need to obtain it again, you will need to create a new Acceptance Session. | [optional] |
8
+ | **launch_url** | **String** | The URL that should be used to invoke the Acceptance Session on your user's device. You can use our frontend SDKs to launch the user into the Acceptance Session, or you can redirect the user's browser to this URL. This URL is sensitive and as such can only be obtained once. If you need to obtain it again, you will need to create a new Acceptance Session. | |
9
+ | **results_access_key** | **String** | The `resultsAccessKey` for the Acceptance Session. This is an encrypted payload which contains the decryption key necessary to access the Session's Data Vault. Save this securely in your systems; it must be passed back with any API call which requires access to the Session's Data Vault. Trinsic cannot access a Session's Data Vault without this key. | |
9
10
 
10
11
  ## Example
11
12
 
@@ -14,7 +15,8 @@ require 'trinsic_api'
14
15
 
15
16
  instance = TrinsicApi::CreateWidgetSessionResponse.new(
16
17
  session_id: null,
17
- launch_url: https://api.trinsic.id/api/session/launch?clientToken=...
18
+ launch_url: https://api.trinsic.id/api/session/launch?clientToken=...,
19
+ results_access_key: 417zNGHMJp6Ht2jCoktTLNGDRZEt4BqTwwQ8Q9ZaQz8aS4Jd7nD1xff2WLhPS69j5q9QT4gvgV79Gv7QtaXwu5YC9Utr35...
18
20
  )
19
21
  ```
20
22
 
data/docs/IdentityData.md CHANGED
@@ -5,6 +5,7 @@
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
7
  | **originating_provider_id** | **String** | | [optional] |
8
+ | **originating_sub_provider_id** | **String** | | [optional] |
8
9
  | **person** | [**PersonData**](PersonData.md) | | [optional] |
9
10
  | **document** | [**DocumentData**](DocumentData.md) | | [optional] |
10
11
  | **attachment_access_keys** | [**AttachmentAccessKeys**](AttachmentAccessKeys.md) | | [optional] |
@@ -16,6 +17,7 @@ require 'trinsic_api'
16
17
 
17
18
  instance = TrinsicApi::IdentityData.new(
18
19
  originating_provider_id: null,
20
+ originating_sub_provider_id: null,
19
21
  person: null,
20
22
  document: null,
21
23
  attachment_access_keys: null
data/docs/IdinInput.md ADDED
@@ -0,0 +1,18 @@
1
+ # TrinsicApi::IdinInput
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **sub_provider_id** | **String** | The ID of the specific bank to invoke with IDIN. If not specified, the user will be prompted to select a bank. | [optional] |
8
+
9
+ ## Example
10
+
11
+ ```ruby
12
+ require 'trinsic_api'
13
+
14
+ instance = TrinsicApi::IdinInput.new(
15
+ sub_provider_id: null
16
+ )
17
+ ```
18
+
@@ -6,7 +6,7 @@
6
6
  | ---- | ---- | ----------- | ----- |
7
7
  | **method** | [**IntegrationLaunchMethod**](IntegrationLaunchMethod.md) | The launch method to perform | |
8
8
  | **content** | **String** | Step type-specific content related to the step: a URL for `LaunchBrowser`, a deeplink for `DeeplinkToMobile` or a string to show to the user for `ShowContent`. | |
9
- | **refresh** | [**StepRefreshInfo**](StepRefreshInfo.md) | If non-null, contains metadata about how to refresh the value of `content`. | |
9
+ | **refresh** | [**StepRefreshInfo**](StepRefreshInfo.md) | If non-null, contains metadata about how to refresh the value of `content`. | [optional] |
10
10
 
11
11
  ## Example
12
12
 
data/docs/Language.md ADDED
@@ -0,0 +1,15 @@
1
+ # TrinsicApi::Language
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+
8
+ ## Example
9
+
10
+ ```ruby
11
+ require 'trinsic_api'
12
+
13
+ instance = TrinsicApi::Language.new()
14
+ ```
15
+
@@ -0,0 +1,18 @@
1
+ # TrinsicApi::ListProviderContractsResponse
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **provider_contracts** | [**Array<ProviderContract>**](ProviderContract.md) | Contracts for all Providers available to your App, filtered by your App's current test mode setting. | |
8
+
9
+ ## Example
10
+
11
+ ```ruby
12
+ require 'trinsic_api'
13
+
14
+ instance = TrinsicApi::ListProviderContractsResponse.new(
15
+ provider_contracts: null
16
+ )
17
+ ```
18
+
@@ -0,0 +1,22 @@
1
+ # TrinsicApi::MobileIdInput
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **mobile_id_phone_number** | **String** | The user's phone number in E.164 format | [optional] |
8
+ | **mobile_id_national_identity_number** | **String** | The user's National ID number | [optional] |
9
+ | **mobile_id_language** | [**Language**](Language.md) | The user's language -- LIT, EST, ENG, or RUS | [optional] |
10
+
11
+ ## Example
12
+
13
+ ```ruby
14
+ require 'trinsic_api'
15
+
16
+ instance = TrinsicApi::MobileIdInput.new(
17
+ mobile_id_phone_number: null,
18
+ mobile_id_national_identity_number: null,
19
+ mobile_id_language: null
20
+ )
21
+ ```
22
+
data/docs/NetworkApi.md CHANGED
@@ -4,15 +4,82 @@ All URIs are relative to *https://api.trinsic.id*
4
4
 
5
5
  | Method | HTTP request | Description |
6
6
  | ------ | ------------ | ----------- |
7
- | [**list_providers**](NetworkApi.md#list_providers) | **GET** /api/v1/network/providers | List Identity Providers |
7
+ | [**list_provider_contracts**](NetworkApi.md#list_provider_contracts) | **GET** /api/v1/network/providers/contracts | List Provider Contracts |
8
+ | [**list_providers**](NetworkApi.md#list_providers) | **GET** /api/v1/network/providers | List Providers |
8
9
  | [**recommend_providers**](NetworkApi.md#recommend_providers) | **POST** /api/v1/network/recommend | Recommend Providers |
9
10
 
10
11
 
12
+ ## list_provider_contracts
13
+
14
+ > <ListProviderContractsResponse> list_provider_contracts
15
+
16
+ List Provider Contracts
17
+
18
+ List the contracts for all Providers available to your App. If your App is in test mode, this call will only return Providers available in test mode. If your App is not in test mode, this call will only return Providers available in production.
19
+
20
+ ### Examples
21
+
22
+ ```ruby
23
+ require 'time'
24
+ require 'trinsic_api'
25
+ # setup authorization
26
+ TrinsicApi.configure do |config|
27
+ # Configure Bearer authorization: Bearer
28
+ config.access_token = 'YOUR_BEARER_TOKEN'
29
+ end
30
+
31
+ api_instance = TrinsicApi::NetworkApi.new
32
+
33
+ begin
34
+ # List Provider Contracts
35
+ result = api_instance.list_provider_contracts
36
+ p result
37
+ rescue TrinsicApi::ApiError => e
38
+ puts "Error when calling NetworkApi->list_provider_contracts: #{e}"
39
+ end
40
+ ```
41
+
42
+ #### Using the list_provider_contracts_with_http_info variant
43
+
44
+ This returns an Array which contains the response data, status code and headers.
45
+
46
+ > <Array(<ListProviderContractsResponse>, Integer, Hash)> list_provider_contracts_with_http_info
47
+
48
+ ```ruby
49
+ begin
50
+ # List Provider Contracts
51
+ data, status_code, headers = api_instance.list_provider_contracts_with_http_info
52
+ p status_code # => 2xx
53
+ p headers # => { ... }
54
+ p data # => <ListProviderContractsResponse>
55
+ rescue TrinsicApi::ApiError => e
56
+ puts "Error when calling NetworkApi->list_provider_contracts_with_http_info: #{e}"
57
+ end
58
+ ```
59
+
60
+ ### Parameters
61
+
62
+ This endpoint does not need any parameter.
63
+
64
+ ### Return type
65
+
66
+ [**ListProviderContractsResponse**](ListProviderContractsResponse.md)
67
+
68
+ ### Authorization
69
+
70
+ [Bearer](../README.md#Bearer)
71
+
72
+ ### HTTP request headers
73
+
74
+ - **Content-Type**: Not defined
75
+ - **Accept**: text/plain, application/json, text/json
76
+
77
+
11
78
  ## list_providers
12
79
 
13
80
  > <ListProvidersResponse> list_providers
14
81
 
15
- List Identity Providers
82
+ List Providers
16
83
 
17
84
  List all identity providers available for use
18
85
 
@@ -30,7 +97,7 @@ end
30
97
  api_instance = TrinsicApi::NetworkApi.new
31
98
 
32
99
  begin
33
- # List Identity Providers
100
+ # List Providers
34
101
  result = api_instance.list_providers
35
102
  p result
36
103
  rescue TrinsicApi::ApiError => e
@@ -46,7 +113,7 @@ This returns an Array which contains the response data, status code and headers.
46
113
 
47
114
  ```ruby
48
115
  begin
49
- # List Identity Providers
116
+ # List Providers
50
117
  data, status_code, headers = api_instance.list_providers_with_http_info
51
118
  p status_code # => 2xx
52
119
  p headers # => { ... }
@@ -0,0 +1,48 @@
1
+ # TrinsicApi::ProviderContract
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **id** | **String** | The ID of the Provider for this contract. | |
8
+ | **name** | **String** | The Provider&#39;s Name as it appears in Trinsic&#39;s Dashboard and Widget | |
9
+ | **description** | **String** | The Provider&#39;s description as it appears in Trinsic&#39;s Widget. This is flavor text, not a full, human-readable description of the provider. | |
10
+ | **logo_url** | **String** | A URL pointing to the Provider&#39;s logo on Trinsic&#39;s CDN. May be a PNG, JPG, or SVG image. | |
11
+ | **available** | **Boolean** | Whether the Provider is available for use in your App. If &#x60;false&#x60;, you will need to contact Trinsic to enable this Provider for your App. | |
12
+ | **geography** | **Array&lt;String&gt;** | The geographies within the Regions the Provider is available. | |
13
+ | **regions** | **Array&lt;String&gt;** | The regions within which the Provider is available. | |
14
+ | **launch_method** | [**IntegrationLaunchMethod**](IntegrationLaunchMethod.md) | Relevant only to Advanced Provider Sessions. The &#x60;LaunchMethod&#x60; which must be supported to launch the Provider Session in Advanced Provider Sessions. | |
15
+ | **collection_method** | [**ResultCollectionMethod**](ResultCollectionMethod.md) | Relevant only to Advanced Provider Sessions. The &#x60;CollectionMethod&#x60; which must be supported to launch the Provider Session in Advanced Provider Sessions. | |
16
+ | **results_may_be_delayed_after_redirect** | **Boolean** | If &#x60;true&#x60;, then the results for this Provider may not be available immediately after the user is redirected back to your application. In this case, the &#x60;GetSessionResults&#x60; API must be called until results are available. This is an uncommon scenario, and typically only applies to Providers which use a biometric check or traditional document scan. | |
17
+ | **has_refreshable_content** | **Boolean** | Relevant only to Advanced Provider Sessions. Whether the Provider requires the &#x60;RefreshStepContent&#x60; capability. For example, Samsung Wallet&#39;s deep links expire every 30 seconds, and must be refreshed periodically for a resilient user flow. | |
18
+ | **requires_input** | **Boolean** | Relevant to Hosted Provider Sessions and Advanced Provider Sessions. If &#x60;true&#x60;, this Provider requires provider-specific input on Session creation. If this input is not provided, Trinsic&#39;s Hosted UI will be invoked to collect the input from the user. | |
19
+ | **has_trinsic_interface** | **Boolean** | Whether there exists a Trinsic-hosted UI for this Provider. This is &#x60;true&#x60; for any Provider which is not a simple, OIDC-like redirect flow. | |
20
+ | **supports_advanced_provider_sessions** | **Boolean** | Whether this Provider can be fully whitelabeled/OEMed through the Advanced Provider Sessions API. If &#x60;false&#x60;, the Provider may still be launched through Advanced Provider Sessions; however, it will necessarily require a Trinsic-hosted UI to function. | |
21
+ | **sub_providers** | [**Array&lt;SubProviderMetadata&gt;**](SubProviderMetadata.md) | Metadata about the sub-providers which are available for this Provider. For example, Italy&#39;s SPID is a Provider which aggregates access to multiple sub-providers. | [optional] |
22
+ | **status** | [**ProviderHealth**](ProviderHealth.md) | The current status of the provider and if it is available to launch. If the status is disabled, there is an issue that prevents a provider being able to launch a session. | |
23
+
24
+ ## Example
25
+
26
+ ```ruby
27
+ require 'trinsic_api'
28
+
29
+ instance = TrinsicApi::ProviderContract.new(
30
+ id: ca-mdl,
31
+ name: CA DMV,
32
+ description: dmv.ca.gov,
33
+ logo_url: https://content.trinsic.id/connect/integrations/ca-dmv.png,
34
+ available: true,
35
+ geography: [&quot;CA&quot;],
36
+ regions: [&quot;United States&quot;],
37
+ launch_method: null,
38
+ collection_method: null,
39
+ results_may_be_delayed_after_redirect: false,
40
+ has_refreshable_content: false,
41
+ requires_input: false,
42
+ has_trinsic_interface: true,
43
+ supports_advanced_provider_sessions: true,
44
+ sub_providers: null,
45
+ status: null
46
+ )
47
+ ```
48
+
@@ -0,0 +1,15 @@
1
+ # TrinsicApi::ProviderHealth
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+
8
+ ## Example
9
+
10
+ ```ruby
11
+ require 'trinsic_api'
12
+
13
+ instance = TrinsicApi::ProviderHealth.new()
14
+ ```
15
+
data/docs/ProviderInfo.md CHANGED
@@ -7,7 +7,6 @@
7
7
  | **id** | **String** | The ID of the provider | |
8
8
  | **name** | **String** | The friendly, human-readable name of the provider | |
9
9
  | **logo_url** | **String** | A URL pointing to the provider&#39;s logo | |
10
- | **child_provider_ids** | **Array&lt;String&gt;** | List of child provider id&#39;s where the provider allows deep-launching of a specific provider. | [optional] |
11
10
 
12
11
  ## Example
13
12
 
@@ -17,8 +16,7 @@ require 'trinsic_api'
17
16
  instance = TrinsicApi::ProviderInfo.new(
18
17
  id: yoti | clear | ...,
19
18
  name: Yoti | CLEAR | ...,
20
- logo_url: null,
21
- child_provider_ids: null
19
+ logo_url: null
22
20
  )
23
21
  ```
24
22
 
@@ -4,9 +4,9 @@
4
4
 
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
- | **provider_id** | **String** | | |
8
- | **provider_display_name** | **String** | | |
9
- | **provider_logo** | **String** | | |
7
+ | **provider_id** | **String** | | [readonly] |
8
+ | **provider_display_name** | **String** | | [readonly] |
9
+ | **provider_logo** | **String** | | [readonly] |
10
10
 
11
11
  ## Example
12
12
 
@@ -4,17 +4,23 @@
4
4
 
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
- | **indonesia_nik** | [**IndonesiaNikInput**](IndonesiaNikInput.md) | Input for the &#x60;f-indonesia-nik&#x60; integration | [optional] |
8
- | **mexico_curp** | [**MexicoCurpInput**](MexicoCurpInput.md) | Input for the &#x60;f-mexico-curp&#x60; integration | [optional] |
9
- | **south_africa_nid** | [**SouthAfricaNidInput**](SouthAfricaNidInput.md) | Input for the &#x60;f-south-africa-nid&#x60; integration | [optional] |
10
- | **kenya_nid** | [**KenyaNidInput**](KenyaNidInput.md) | Input for the &#x60;f-kenya-nid&#x60; integration | [optional] |
11
- | **nigeria_nin** | [**NigeriaNinInput**](NigeriaNinInput.md) | Input for the &#x60;f-nigeria-nin&#x60; integration | [optional] |
12
- | **aadhaar** | [**AadhaarInput**](AadhaarInput.md) | Input for the &#x60;f-india-aadhaar-match&#x60; integration | [optional] |
13
- | **bangladesh_national_id** | [**BangladeshNationalIdInput**](BangladeshNationalIdInput.md) | Input for the &#x60;bangladesh-nid&#x60; integration | [optional] |
14
- | **brazil_cpf_check** | [**BrazilCpfCheckInput**](BrazilCpfCheckInput.md) | Input for the &#x60;g-brazil-cpf&#x60; integration | [optional] |
15
- | **brazil_digital_cnh** | [**BrazilDigitalCnhInput**](BrazilDigitalCnhInput.md) | Input for the &#x60;g-brazil-digital-cnh&#x60; integration | [optional] |
16
- | **philippine_match** | [**PhilippineMatchInput**](PhilippineMatchInput.md) | Input for the &#x60;b-philsys-biometric&#x60; integration | [optional] |
17
- | **philippine_qr** | [**PhilippineQRInput**](PhilippineQRInput.md) | Input for the &#x60;b-philippine-qr-digital-national-id&#x60; and &#x60;b-philippine-qr-ephill-id&#x60; integrations | [optional] |
7
+ | **indonesia_nik** | [**IndonesiaNikInput**](IndonesiaNikInput.md) | Input for the &#x60;f-indonesia-nik&#x60; provider | [optional] |
8
+ | **mexico_curp** | [**MexicoCurpInput**](MexicoCurpInput.md) | Input for the &#x60;f-mexico-curp&#x60; provider | [optional] |
9
+ | **south_africa_nid** | [**SouthAfricaNidInput**](SouthAfricaNidInput.md) | Input for the &#x60;f-south-africa-nid&#x60; provider | [optional] |
10
+ | **kenya_nid** | [**KenyaNidInput**](KenyaNidInput.md) | Input for the &#x60;f-kenya-nid&#x60; provider | [optional] |
11
+ | **nigeria_nin** | [**NigeriaNinInput**](NigeriaNinInput.md) | Input for the &#x60;f-nigeria-nin&#x60; provider | [optional] |
12
+ | **aadhaar** | [**AadhaarInput**](AadhaarInput.md) | Input for the &#x60;f-india-aadhaar-match&#x60; provider | [optional] |
13
+ | **bangladesh_national_id** | [**BangladeshNationalIdInput**](BangladeshNationalIdInput.md) | Input for the &#x60;bangladesh-nid&#x60; provider | [optional] |
14
+ | **brazil_cpf_check** | [**BrazilCpfCheckInput**](BrazilCpfCheckInput.md) | Input for the &#x60;g-brazil-cpf&#x60; provider | [optional] |
15
+ | **brazil_digital_cnh** | [**BrazilDigitalCnhInput**](BrazilDigitalCnhInput.md) | Input for the &#x60;g-brazil-digital-cnh&#x60; provider | [optional] |
16
+ | **philippine_match** | [**PhilippineMatchInput**](PhilippineMatchInput.md) | Input for the &#x60;b-philsys-biometric&#x60; provider | [optional] |
17
+ | **philippine_qr** | [**PhilippineQRInput**](PhilippineQRInput.md) | Input for the &#x60;b-philippine-qr-digital-national-id&#x60; and &#x60;b-philippine-qr-ephill-id&#x60; providers | [optional] |
18
+ | **smart_id** | [**SmartIdInput**](SmartIdInput.md) | Input for the &#x60;smart-id&#x60; provider | [optional] |
19
+ | **mobile_id** | [**MobileIdInput**](MobileIdInput.md) | Input for the &#x60;mobile-id&#x60; provider | [optional] |
20
+ | **idin** | [**IdinInput**](IdinInput.md) | Input for the &#x60;idin&#x60; provider | [optional] |
21
+ | **spid** | [**SpidInput**](SpidInput.md) | Input for the &#x60;spid&#x60; provider | [optional] |
22
+ | **trinsic_test_database_lookup** | [**TrinsicTestDatabaseLookupInput**](TrinsicTestDatabaseLookupInput.md) | *TEST MODE ONLY.* Input for the &#x60;trinsic-test-database-lookup&#x60; provider | [optional] |
23
+ | **trinsic_test_sub_providers** | [**TrinsicTestSubProvidersInput**](TrinsicTestSubProvidersInput.md) | *TEST MODE ONLY.* Input for the &#x60;trinsic-test-sub-providers&#x60; provider | [optional] |
18
24
 
19
25
  ## Example
20
26
 
@@ -32,7 +38,13 @@ instance = TrinsicApi::ProviderInput.new(
32
38
  brazil_cpf_check: null,
33
39
  brazil_digital_cnh: null,
34
40
  philippine_match: null,
35
- philippine_qr: null
41
+ philippine_qr: null,
42
+ smart_id: null,
43
+ mobile_id: null,
44
+ idin: null,
45
+ spid: null,
46
+ trinsic_test_database_lookup: null,
47
+ trinsic_test_sub_providers: null
36
48
  )
37
49
  ```
38
50
 
@@ -4,11 +4,7 @@
4
4
 
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
- | **phone_number** | **String** | The phone number of the user you wish to generate a recommendation for. Will be used to look up the user&#39;s identity in the network | [optional] |
8
- | **countries** | **Array&lt;String&gt;** | A list of countries, in alpha-2 ISO 3166 format, you wish to specify for the recommendation, this can include the user&#39;s country of residence, nationality, etc. | [optional] |
9
- | **subdivisions** | **Array&lt;String&gt;** | If one of the countries has subdivisions, for example the US states, you can specify a list of these to further refine the recommendation (e.g., CA, UT, NY) | [optional] |
10
- | **ip_addresses** | **Array&lt;String&gt;** | Provide the IP addresses of the user you wish to generate a recommendation for. Will be used to look up the user&#39;s geographic location. | [optional] |
11
- | **include_disabled_providers** | **Boolean** | If true, the recommendation will include providers that are disabled for the app | [optional] |
7
+ | **recommendation_info** | [**RecommendationInfo**](RecommendationInfo.md) | Information about the user you wish to generate a recommendation for. | [optional] |
12
8
 
13
9
  ## Example
14
10
 
@@ -16,11 +12,7 @@
16
12
  require 'trinsic_api'
17
13
 
18
14
  instance = TrinsicApi::RecommendRequest.new(
19
- phone_number: null,
20
- countries: null,
21
- subdivisions: null,
22
- ip_addresses: null,
23
- include_disabled_providers: null
15
+ recommendation_info: null
24
16
  )
25
17
  ```
26
18
 
@@ -0,0 +1,24 @@
1
+ # TrinsicApi::RecommendationInfo
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **phone_number** | **String** | The phone number of the user you wish to generate a recommendation for. Will be used to look up the user&#39;s identity in the network, as well as to determine the user&#39;s geographic location. | [optional] |
8
+ | **countries** | **Array&lt;String&gt;** | A list of countries, in alpha-2 ISO 3166 format, which the user is related to. This can include the user&#39;s country of residence, nationality, etc. | [optional] |
9
+ | **subdivisions** | **Array&lt;String&gt;** | If one of the countries has subdivisions (for example: US states), specify those related to the user here (e.g., CA, UT, NY) | [optional] |
10
+ | **ip_addresses** | **Array&lt;String&gt;** | Any IP addresses related to the user. Will be used to determine the user&#39;s geographic location. | [optional] |
11
+
12
+ ## Example
13
+
14
+ ```ruby
15
+ require 'trinsic_api'
16
+
17
+ instance = TrinsicApi::RecommendationInfo.new(
18
+ phone_number: null,
19
+ countries: null,
20
+ subdivisions: null,
21
+ ip_addresses: null
22
+ )
23
+ ```
24
+
@@ -5,7 +5,7 @@
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
7
  | **method** | [**ResultCollectionMethod**](ResultCollectionMethod.md) | The method by which the results of the Acceptance Session should be collected. | |
8
- | **results_access_key** | **String** | If the method is &#x60;PollResult&#x60;, this is the key that should be used to poll for the results. | [optional] |
8
+ | **results_access_key** | **String** | The &#x60;resultsAccessKey&#x60; for the Acceptance Session. This is an encrypted payload which contains the decryption key necessary to access the Session&#39;s Data Vault. Save this securely in your systems; it must be passed back with any API call which requires access to the Session&#39;s Data Vault. Trinsic cannot access a Session&#39;s Data Vault without this key. | |
9
9
 
10
10
  ## Example
11
11
 
@@ -14,7 +14,7 @@ require 'trinsic_api'
14
14
 
15
15
  instance = TrinsicApi::ResultCollection.new(
16
16
  method: null,
17
- results_access_key: null
17
+ results_access_key: 417zNGHMJp6Ht2jCoktTLNGDRZEt4BqTwwQ8Q9ZaQz8aS4Jd7nD1xff2WLhPS69j5q9QT4gvgV79Gv7QtaXwu5YC9Utr35...
18
18
  )
19
19
  ```
20
20
 
data/docs/Session.md CHANGED
@@ -5,9 +5,9 @@
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
7
  | **id** | **String** | | |
8
- | **done** | **Boolean** | Whether the Session is in a terminal / final state. If this is &#x60;true&#x60;, inspect the value of &#x60;Success&#x60; to determine whether the Session was successful. | |
9
- | **success** | **Boolean** | Whether the Session has completed successfully. If this is &#x60;false&#x60;, the Session is either not yet done, or has failed. Inspect &#x60;Done&#x60; and &#x60;ErrorCode&#x60; for more information. If this is &#x60;true&#x60;, the Session has completed successfully. | |
10
- | **error_code** | [**SessionErrorCode**](SessionErrorCode.md) | The reason for the Session&#39;s failure. Only present if &#x60;Success&#x60; is &#x60;false&#x60;. | [optional] |
8
+ | **done** | **Boolean** | Whether the Session is in a terminal / final state. If this is &#x60;true&#x60;, inspect the value of &#x60;Success&#x60; to determine whether the Session was successful. | |
9
+ | **success** | **Boolean** | Whether the Session has completed successfully. If this is &#x60;false&#x60;, the Session is either not yet done, or has failed. Inspect &#x60;Done&#x60; and &#x60;ErrorCode&#x60; for more information. If this is &#x60;true&#x60;, the Session has completed successfully. | |
10
+ | **error_code** | [**SessionErrorCode**](SessionErrorCode.md) | The reason for the Session&#39;s failure. Only present if &#x60;Success&#x60; is &#x60;false&#x60;. | [optional] |
11
11
  | **created** | **Integer** | The unix timestamp, in seconds, when this session was created | |
12
12
  | **updated** | **Integer** | The unix timestamp, in seconds, when this session&#39;s state last changed | |
13
13
 
data/docs/SessionsApi.md CHANGED
@@ -90,7 +90,7 @@ end
90
90
 
91
91
  Create Advanced Provider Session
92
92
 
93
- Verify a user's identity with a specific provider, handling additional user interaction in your own UI. Signal which kinds of user interactions your UI can handle using the `Capabilities` field. If `FallbackToHostedUi` is `true`, Trinsic's hosted UI will automatically be invoked to handle any capabilities you do not support.
93
+ Verify a user's identity with a specific provider, handling additional user interaction in your own UI. Signal which kinds of user interactions your UI can handle using the `Capabilities` field. If `FallbackToHostedUi` is `true`, Trinsic's hosted UI will automatically be invoked to handle any capabilities you do not support.
94
94
 
95
95
  ### Examples
96
96
 
@@ -520,7 +520,7 @@ end
520
520
 
521
521
  Redact Session
522
522
 
523
- Redact a Session, removing all identity data from Trinsic's servers. Every application has a redaction period that dictates how long we will hold on to your users' PII data. Once a session falls outside the redaction cutoff date, all PII will automatically be removed from that session. You can utilize this endpoint to redact a session immediately. Identity data that a user has chosen to save in their passkey-protected wallet will not be deleted.
523
+ Redact a Session, removing all identity data from Trinsic's servers. Every application has a redaction period that dictates how long we will hold on to your users' PII data. Once a session falls outside the redaction cutoff date, all PII will automatically be removed from that session. You can utilize this endpoint to redact a session immediately. Identity data that a user has chosen to save in their passkey-protected wallet will not be deleted.
524
524
 
525
525
  ### Examples
526
526
 
@@ -0,0 +1,18 @@
1
+ # TrinsicApi::SmartIdInput
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **smart_id_document_number** | **String** | The user&#39;s Smart ID Document Number | [optional] |
8
+
9
+ ## Example
10
+
11
+ ```ruby
12
+ require 'trinsic_api'
13
+
14
+ instance = TrinsicApi::SmartIdInput.new(
15
+ smart_id_document_number: null
16
+ )
17
+ ```
18
+