Crear un Cliente Individual o Empresarial
Create a new customer.
customer) en SpherePay. Este endpoint registra un cliente individual o empresarial y devuelve un objeto de cliente con un ID único y un array verificationProfiles que rastrea el estado de completitud de KYC/KYB. Debes especificar type desde el inicio — no puede cambiarse después de la creación.Autorizaciones
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Cuerpo
- Individual Customer Create
- Business Customer Create
individual The customer email address
254"jane.smith@example.com"
The customer phone number in E.164 format
^\+(?:[0-9]){6,14}[0-9]$"+14155550123"
The customer's address.
Personal information including tax identification details for individual customers. When any tax identification field is provided, all tax identification fields (number, type, country) and address are required. Please refer to the Individual Verification Criteria for the full list of reference.
Additional metadata associated with the customer
Respuesta
- Individual
- Business
Response containing information about an individual customer.
Customer ID
"customer_f31121c389624d3697cbf3ea8830b7a4"
Array of verification profiles. For individual customers, this will include kyc_profile_a. For business customers, this will include kyb_profile_a. See KYC Flow for individuals or KYB Flow for businesses. See Verification Profile for individual status definitions and criteria breakdown or Verification Profile for business status definitions and criteria breakdown.
[
{
"name": "kyc_profile_a",
"status": "incomplete",
"criteria": {
"complete": [
"email_address",
"phone_number",
"residential_address",
"tax_identification_number"
],
"pending": [],
"required": [
"identity_document",
"liveness_report_document"
],
"errors": []
}
}
]ISO 8601 formatted customer creation timestamp
"2026-03-09T20:46:31.305Z"
ISO 8601 formatted customer update timestamp
"2026-03-09T20:46:31.305Z"
Customer type
individual "individual"
Customer email address
"jane.smith@example.com"
Customer phone number
"+14155550123"
Customer first name (individual customers only)
"Jane"
Customer last name (individual customers only)
"Smith"