Obtener URL de Verificación KYC
curl --request GET \
--url http://api.gu1.ai/api/kyc/validations/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "http://api.gu1.ai/api/kyc/validations/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://api.gu1.ai/api/kyc/validations/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "http://api.gu1.ai/api/kyc/validations/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://api.gu1.ai/api/kyc/validations/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://api.gu1.ai/api/kyc/validations/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/api/kyc/validations/{id}")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_bodyValidación por sesión
Obtener URL de Verificación KYC
Recuperar la URL de verificación para compartir con tu cliente — en la API KYC de gu1 para flujos de verificación de identidad, con ejemplos para get kyc url.
GET
/
api
/
kyc
/
validations
/
{id}
Obtener URL de Verificación KYC
curl --request GET \
--url http://api.gu1.ai/api/kyc/validations/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "http://api.gu1.ai/api/kyc/validations/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://api.gu1.ai/api/kyc/validations/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "http://api.gu1.ai/api/kyc/validations/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://api.gu1.ai/api/kyc/validations/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://api.gu1.ai/api/kyc/validations/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/api/kyc/validations/{id}")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_bodyResumen
Después de crear una validación KYC, puedes recuperar la URL de verificación en cualquier momento. Esta URL es la que compartirás con tu cliente para que complete el proceso de verificación de identidad.Cuándo Usar Esto
- Recuperar URL después: Si no guardaste la URL de la respuesta de creación
- Reenviar al cliente: Cuando el cliente solicita un nuevo enlace
- Verificar detalles: Ver estado actual y metadata
- Integrar con otros sistemas: Pasar la URL a servicios de notificación
Solicitud
Endpoint
GET https://api.gu1.ai/api/kyc/validations/{id}
Parámetros de Ruta
string
required
El ID de validación devuelto al crear la validación KYC
Respuesta
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"entityId": "123e4567-e89b-12d3-a456-426614174000",
"providerSessionUrl": "https://verify.example.com/session_xyz789",
"status": "pending",
"isCurrent": true,
"createdAt": "2025-01-15T10:30:00Z",
"updatedAt": "2025-01-15T10:30:00Z"
}
Valores posibles de status
El campostatus puede ser: pending, in_progress, in_review, approved, rejected, expired, abandoned, cancelled. Consulta Verificar estado para la descripción de cada uno.
Ejemplo
const validationId = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(
`https://api.gu1.ai/api/kyc/validations/${validationId}`,
{
headers: {
'Authorization': 'Bearer TU_API_KEY'
}
}
);
const validation = await response.json();
const urlVerificacion = validation.providerSessionUrl;
console.log('Comparte esta URL con tu cliente:', urlVerificacion);
validation_id = '550e8400-e29b-41d4-a716-446655440000'
response = requests.get(
f'https://api.gu1.ai/api/kyc/validations/{validation_id}',
headers={'Authorization': 'Bearer TU_API_KEY'}
)
validation = response.json()
url_verificacion = validation['providerSessionUrl']
print('Comparte esta URL con tu cliente:', url_verificacion)
Alternativa: Obtener Validación Actual por Entidad
Si no tienes el ID de validación pero tienes el ID de entidad:GET https://api.gu1.ai/api/kyc/entities/{entityId}/current
Compartir la URL con Clientes
Ejemplo de Email
<p>Hola {{nombreCliente}},</p>
<p>Por favor completa tu verificación de identidad para continuar:</p>
<p><a href="{{providerSessionUrl}}">Verificar Tu Identidad</a></p>
<p>Este enlace expirará en 7 días.</p>
Ejemplo de SMS
Completa tu verificación de identidad aquí: {{providerSessionUrl}}
Integración en App
// Redirigir usuario a verificación
window.location.href = providerSessionUrl;
// O abrir en nueva ventana
window.open(providerSessionUrl, '_blank');
// O embeber en iframe
<iframe src={providerSessionUrl} width="100%" height="600px" />
Próximos Pasos
Integración Webhook
Recibir actualizaciones en tiempo real
Verificar Estado
Consultar resultados de validación
Was this page helpful?