Pular para o conteúdo 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"
}
Registre um representante empresarial ou Beneficiário Final Efetivo (UBO) para um cliente empresarial. Cada indivíduo que direta ou indiretamente possui 25% ou mais da empresa deve ser registrado como UBO antes que a empresa possa ser aprovada para transferências. Você também pode registrar pessoas de controle e signatários autorizados que não atendem ao limite de propriedade. Após o registro, complete o KYB do representante enviando seus documentos de identidade e, se estiver usando o modelo Sphere-Managed, gerando um link de verificação facial.
Qualquer indivíduo com participação acionária de 25% ou mais deve ser registrado. Se nenhuma pessoa atingir esse limite, registre o indivíduo com a maior participação acionária ou a pessoa com controle de gestão significativo.

Autorizações

​
Authorization
string
header
obrigatório

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

Corpo

application/json
​
customerId
string
obrigatório

The ID of the business customer this representative belongs to.

Minimum string length: 1
Exemplo:

"customer_2f283221a9d44ada800ac7f11f640402"

​
type
enum<string>
obrigatório

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

Opções disponíveis:
individual
Exemplo:

"individual"

​
email
string<email>
obrigatório

The email address of the business representative.

Maximum string length: 254
Exemplo:

"james.wilson@acmecorp.example.com"

​
phone
string
obrigatório

The phone number of the business representative.

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

"+13125559876"

​
address
object
obrigatório

The address of the business representative.

​
personalInformation
object
obrigatório

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
obrigatório

The representation details of the business representative.

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

Resposta

​
id
string
obrigatório

Business Representative ID

Exemplo:

"associatedPerson_d972d2f70b9f4d3c8d7cfb32593f395b"

​
customerId
string
obrigatório

Customer ID

Exemplo:

"customer_2f283221a9d44ada800ac7f11f640402"

​
type
enum<string>
obrigatório

Customer type

Opções disponíveis:
individual
Exemplo:

"individual"

​
verificationProfiles
object[]
obrigatório

Array of verification profiles for the business representative.

Exemplo:
[
  {
    "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
obrigatório

The date and time the business representative was created.

Exemplo:

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

​
updatedAt
string
obrigatório

The date and time the business representative was last updated.

Exemplo:

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

​
email
string

Email address

Exemplo:

"james.wilson@acmecorp.example.com"

​
phone
string

Phone number

Exemplo:

"+13125559876"

​
representationDetails
object

Representation details

Última modificação em 18 de junho de 2026