Customer Registration
This guide will walk you through the process of registering a customer for transfers.
Customer
A Customer is a user or business that is associated with your application. Customers are user or business parties that use your application to send and receive transfers.
Customer Registration
Customer registration is a process that allows you to create a customer in Sphere. This process involves verifying the customer's identity and creating a customer record in Sphere.
1. Create a Customer
To create a customer, you can use the Create Customer endpoint.
https://api.spherepay.co/v2/customer
https://api.sandbox.spherepay.co/v2/customer
Request Example
{
"type": "individual | business",
"address": {
"line1": "string",
"line2": "string",
"city": "string",
"postalCode": "string",
"state": "string",
"country": "string"
}
}
2. Accepting Terms of Service
After a 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
https://api.spherepay.co/v2/customer/:customer_id/tos-link
https://api.sandbox.spherepay.co/v2/customer/: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.
3. Know your Customer/Business (KYC/KYB)
In parallel to the onboarding process, you can also collect KYC/KYB information from the customer. To generate a KYC/KYB link, you can use the Generate KYC/KYB Link endpoint.
https://api.spherepay.co/v2/customer/:customer_id/kyc-link
https://api.sandbox.spherepay.co/v2/customer/:customer_id/kyc-link
Once the link is generated, you can redirect the customer to the link to complete the KYC/KYB process. The customer is expected to provide the required information to complete the KYC/KYB process. Please refer to the Customer Onboarding guide for more information. During the KYC/KYB process, the customer is able to register their wallet and bank account. The bank account will remain in pending status until the customer's identity is verified.
4. Check Customer Status
After the customer has completed the KYC/KYB process, you can check the customer status to ensure the customer is onboarded. To check the customer status, you can use the Check Customer Status endpoint.
https://api.spherepay.co/v2/customer/:customer_id
https://api.sandbox.spherepay.co/v2/customer/:customer_id
5. Register Bank Account
Once the customer has been created and the KYC/KYB process is complete, you can register a bank account for the customer. Please refer to the Register Bank Account guide for more information.
6. Create a Transfer
Once the customer has been created and the KYC/KYB process is complete, you can create a transfer for the customer. Please refer to the Transfer guide for more information.
Customer
A Customer is a user or business that is associated with your application. Customers are parties that use your application to send and receive transfers securely.
Customer Onboarding – KYC & KYB
A simplified guide to SpherePay's onboarding process, including KYC for individual customers and KYB for businesses.