Create and onboard business customers with KYB verification for your B2B2B platform. Get a hosted KYB link to complete customer verification.
Overview
The Create Business Customer endpoint is designed for B2B2B platforms - businesses that serve other businesses. This endpoint allows you to onboard your business customers and initiate their KYB (Know Your Business) verification process.
What happens when you create a customer?
When you create a business customer, LINK generates a secure, hosted KYB verification link that your customer completes. This streamlines the onboarding process while ensuring compliance with regulatory requirements.
Key Benefits:
- Automated KYB verification process
- Secure hosted verification pages
- Regulatory compliance handling
- Streamlined B2B onboarding
Endpoint Details
HTTP Method
POST
Endpoint URL
/v2/business_customer
Request Requirements
| Header | Type | Description |
|---|---|---|
ngnc-sec-key | string | Your API key for authentication |
idempotency-key | string | Unique identifier to prevent duplicate requests |
Example Request
{
"business_name": "Acme Corp Solutions Ltd",
"business_email": "[email protected]",
"phone_number": "+1-555-0123",
"registered_address": "123 Business Street, Suite 100, New York, NY 10001",
"registered_country": "USA"
}Response Format
Success Response (200)
Upon successful customer creation, you'll receive:
- Customer ID: Unique identifier for the created business customer
- KYB Link: Hosted verification URL to send to your customer
- Status: Current verification status
- Expiration: Link validity period
{
"status": "success",
"customer_id": "cust_abc123xyz",
"kyb_link": "https://verify.linkio.world/kyb/abc123...",
"verification_status": "pending",
"link_expires_at": "2024-11-04T14:00:00Z"
}Implementation Guide
Next Steps
Check Status
Monitor your customer's verification progress
Webhook Setup
Get real-time verification updates
Complete Guide
Explore full customer management documentation
Important Notes
Best Practices
- Idempotency Keys: Always use unique idempotency keys to prevent duplicate customer creation
- Data Accuracy: Ensure business information matches official registration documents
- Link Handling: KYB links are single-use and expire after a set period
- Status Monitoring: Implement webhook handlers to track verification progress
Compliance Considerations
- Business information must match official registration documents
- Customers must complete verification within the specified timeframe
- Some jurisdictions may require additional verification steps
- Maintain audit logs of all customer creation activities