KYB via Link
This guide walks you through onboarding business customers using the Business Customer KYB Link.
Introduction
To initiate the KYB process via link, generate a KYB link and redirect the customer to the hosted KYB page to complete the verification process. This method is ideal for rapid integration and is best suited for integrators who prefer using SpherePay's native KYB experience.
Before you begin
Ensure you have:
- A SpherePay API key — see Authentication
- The business's email address and phone number to create their profile
KYB Link Flow
KYB via Link
The KYB link redirects the business customer to a hosted page where they complete the full verification process — business document upload, UBO registration, and liveness check — without any additional API calls on your side. To create a KYB link, use the Create KYB Link endpoint.
Onboarding a Business Customer step by step using KYB Link
The following steps will guide you through the process of onboarding a business customer step by step using KYB Link.
1. Create a Customer
To create a customer, you can use the Create Customer endpoint.
POSThttps://api.spherepay.co/v2/customer
Request Example
{
"type": "business",
"email": "business@example.com",
"phone": "+1234567890",
"addresses": [
{
"addressType": "physical",
"line1": "string",
"line2": "string",
"city": "string",
"postalCode": "string",
"state": "string",
"country": "string"
},
{
"addressType": "mailing",
"line1": "string",
"line2": "string",
"city": "string",
"postalCode": "string",
"state": "string",
"country": "string"
}
]
}2. Accepting Terms of Service & Signing Merchant Service Agreement
After a business customer has been created, you can generate a TOS link to redirect the customer to the Terms of Service and Privacy Policy. To generate a TOS link, you can use the Generate TOS Link endpoint.
POSThttps://api.spherepay.co/v2/customer/{id}/tos-link
Once the link is generated, you can redirect the customer to the link to complete the onboarding process. The customer is expected to accept the Terms and Conditions and Privacy Policy before proceeding. After accepting, SpherePay will automatically redirect the user to a form to fill out required information for the Merchant Service Agreement (MSA). Once the form is completed, the customer will be redirected to the Merchant Service Agreement page to sign the agreement.
3. Generate a KYB Link
In parallel with the TOS step, generate a KYB link to collect the business customer's identity information. To generate a KYB link, use the Generate KYB Link endpoint.
POSThttps://api.spherepay.co/v2/customer/{id}/kyc-link
Once the link is generated, redirect the business customer to the page to complete the KYB process. The hosted experience handles business document upload, UBO registration, face liveness verification, and all required questions in one flow.
Bank account registration
During the KYB flow, the customer may register a bank account. It will remain in pending status until their identity is fully verified and the profile reaches approved.
4. Check Customer Status
After the customer has completed the KYB process, poll Get Customer until status in verificationProfiles reaches approved.
https://api.spherepay.co/v2/customer/{id}
Approved Response Example
{
"id": "customer_66c4168d418a410eae282b83883bdc39",
"type": "business",
"verificationProfiles": [
{
"status": "approved",
"criteria": {
"complete": [
"email_address",
"phone_number",
"business_address",
"business_identification_number",
"terms_of_service",
"merchant_service_agreement",
"incorporation_certificate",
"shareholder_registry",
"directors_registry",
"proof_of_address",
"business_representatives",
"identity_verification",
"kyb_a_approval"
],
"pending": [],
"required": [],
"errors": []
}
}
]
}When required is empty and status is approved, the business customer is fully onboarded and ready to transfer.
What's Next
With the business customer onboarded, register their payment methods before initiating a transfer.
Register Payment Methods
Create a Transfer
Make Routine Transfers Easier with Onramper Accounts & Offloader Wallets
Last updated on