Saltar al contenido principal
Create a Business Representative
curl --request POST \
  --url https://api.spherepay.co/v2/business-representative \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerId": "customer_2f283221a9d44ada800ac7f11f640402",
  "type": "individual",
  "email": "james.wilson@acmecorp.example.com",
  "phone": "+13125559876",
  "address": {
    "line1": "233 South Wacker Drive",
    "city": "Chicago",
    "country": "USA"
  },
  "personalInformation": {
    "taxIdentificationNumber": "123456789",
    "taxIdentificationNumberType": "ssn",
    "taxIdentificationNumberCountry": "USA"
  },
  "representationDetails": {
    "roles": [
      "ubo"
    ],
    "ownershipPercentage": "50",
    "isControlPerson": true,
    "isSigner": true,
    "relationshipEstablishedAt": "2020-03-15",
    "title": "CEO"
  }
}
'
{
  "id": "associatedPerson_d972d2f70b9f4d3c8d7cfb32593f395b",
  "customerId": "customer_2f283221a9d44ada800ac7f11f640402",
  "type": "individual",
  "email": "james.wilson@acmecorp.example.com",
  "phone": "+13125559876",
  "representationDetails": {
    "roles": [
      "ubo"
    ],
    "ownershipPercentage": "50",
    "isControlPerson": true,
    "isSigner": true,
    "relationshipEstablishedAt": "2020-03-15",
    "title": "CEO"
  },
  "verificationProfiles": [
    {
      "name": "ubo_kyc_profile_a",
      "status": "incomplete",
      "criteria": {
        "complete": [
          "email_address",
          "phone_number",
          "residential_address",
          "tax_identification_number",
          "ownership_percentage",
          "is_control_person",
          "is_signer",
          "relationship_established_at",
          "title"
        ],
        "pending": [],
        "required": [
          "identity_document",
          "liveness_report_document",
          "proof_of_address_document"
        ],
        "errors": []
      }
    }
  ],
  "createdAt": "2026-03-10T00:00:08.986Z",
  "updatedAt": "2026-03-10T00:00:08.986Z"
}
Registra un representante empresarial o Beneficiario Final Efectivo (UBO) para un cliente empresarial. Cada individuo que directa o indirectamente posea el 25% o más de la empresa debe ser registrado como UBO antes de que la empresa pueda ser aprobada para transferencias. También puedes registrar personas de control y firmantes autorizados que no cumplan el umbral de propiedad. Después del registro, completa el KYB del representante subiendo sus documentos de identidad y, si usas el modelo Sphere-Managed, generando un link de verificación facial.
Todo individuo con una participación de propiedad del 25% o mayor debe ser registrado. Si ninguna persona cumple este umbral, registra al individuo con la mayor participación de propiedad o a la persona con control de gestión significativo.

Autorizaciones

​
Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Cuerpo

application/json
​
customerId
string
requerido

The ID of the business customer this representative belongs to.

Minimum string length: 1
Ejemplo:

"customer_2f283221a9d44ada800ac7f11f640402"

​
type
enum<string>
requerido

The type of the business representative. Must be "individual".

Opciones disponibles:
individual
Ejemplo:

"individual"

​
email
string<email>
requerido

The email address of the business representative.

Maximum string length: 254
Ejemplo:

"james.wilson@acmecorp.example.com"

​
phone
string
requerido

The phone number of the business representative.

Pattern: ^\+(?:[0-9]){6,14}[0-9]$
Ejemplo:

"+13125559876"

​
address
object
requerido

The address of the business representative.

​
personalInformation
object
requerido

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.

​
representationDetails
object
requerido

The representation details of the business representative.

Ejemplo:
{
  "roles": ["ubo"],
  "ownershipPercentage": "50",
  "isControlPerson": true,
  "isSigner": true,
  "relationshipEstablishedAt": "2020-03-15",
  "title": "CEO"
}

Respuesta

​
id
string
requerido

Business Representative ID

Ejemplo:

"associatedPerson_d972d2f70b9f4d3c8d7cfb32593f395b"

​
customerId
string
requerido

Customer ID

Ejemplo:

"customer_2f283221a9d44ada800ac7f11f640402"

​
type
enum<string>
requerido

Customer type

Opciones disponibles:
individual
Ejemplo:

"individual"

​
verificationProfiles
object[]
requerido

Array of verification profiles for the business representative.

Ejemplo:
[
  {
    "name": "ubo_kyc_profile_a",
    "status": "incomplete",
    "criteria": {
      "complete": [
        "email_address",
        "phone_number",
        "residential_address",
        "tax_identification_number",
        "ownership_percentage",
        "is_control_person",
        "is_signer",
        "relationship_established_at",
        "title"
      ],
      "pending": [],
      "required": [
        "identity_document",
        "liveness_report_document",
        "proof_of_address_document"
      ],
      "errors": []
    }
  }
]
​
createdAt
string
requerido

The date and time the business representative was created.

Ejemplo:

"2026-03-10T00:00:08.986Z"

​
updatedAt
string
requerido

The date and time the business representative was last updated.

Ejemplo:

"2026-03-10T00:00:08.986Z"

​
email
string

Email address

Ejemplo:

"james.wilson@acmecorp.example.com"

​
phone
string

Phone number

Ejemplo:

"+13125559876"

​
representationDetails
object

Representation details

Última modificación el 18 de junio de 2026