Hosted Onboarding Page

// 1. Create a person entity (Entities API)
const entityRes = await fetch('https://api.gu1.ai/api/entities', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    type: 'person',
    name: 'John Doe',
    taxId: '12345678900',
    countryCode: 'US',
    entityData: { person: { email: 'john@example.com' } }
  })
});
const entityData = await entityRes.json();
const entityId = entityData.entity?.id ?? entityData.id;

// 2. Create a KYC validation session
const validationRes = await fetch('https://api.gu1.ai/api/kyc/validations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    entityId,
    integrationCode: 'global_gueno_validation_kyc'
  })
});
const validationData = await validationRes.json();

// 3. Get the hosted page URL (providerSessionUrl)
const hostedPageUrl = validationData.providerSessionUrl;
console.log('Share this URL with your client:', hostedPageUrl);

// 4. Share with client (via email, SMS, etc.)
await sendEmail({
  to: 'john@example.com',
  subject: 'Complete Your Identity Verification',
  body: `Please complete your verification here: ${hostedPageUrl}`
});

import requests

# 1. Create a person entity (Entities API)
entity_response = requests.post(
    'https://api.gu1.ai/api/entities',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'type': 'person',
        'name': 'John Doe',
        'taxId': '12345678900',
        'countryCode': 'US',
        'entityData': { 'person': { 'email': 'john@example.com' } }
    }
)
entity_data = entity_response.json()
entity_id = entity_data.get('entity', {}).get('id') or entity_data.get('id')

# 2. Create a KYC validation session
validation_response = requests.post(
    'https://api.gu1.ai/api/kyc/validations',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'entityId': entity_id,
        'integrationCode': 'global_gueno_validation_kyc'
    }
)
validation_data = validation_response.json()

# 3. Get the hosted page URL (providerSessionUrl)
hosted_page_url = validation_data['providerSessionUrl']
print('Share this URL with your client:', hosted_page_url)

# 4. Share with client (via email, SMS, etc.)
send_email(
    to='john@example.com',
    subject='Complete Your Identity Verification',
    body=f'Please complete your verification here: {hosted_page_url}'
)

# 1. Create a person entity (Entities API)
curl -X POST https://api.gu1.ai/api/entities \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "person",
    "name": "John Doe",
    "taxId": "12345678900",
    "countryCode": "US"
  }'

# Response: {"entity": {"id": "entity-uuid", ...}, ...} or {"id": "entity-uuid", ...}

# 2. Create a KYC validation session
curl -X POST https://api.gu1.ai/api/kyc/validations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entityId": "entity-uuid",
    "integrationCode": "global_gueno_validation_kyc"
  }'

# Response: {"id": "...", "providerSessionUrl": "https://...", "status": "pending", ...}

# 3. Share the providerSessionUrl with your client