Actualizar Dirección, Teléfono o Correo del Cliente

curl --request PATCH \ --url https://api.spherepay.co/v2/customer/{id} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "address": { "line1": "456 Market Street", "city": "San Francisco", "state": "CA", "postalCode": "94105", "country": "USA" }, "meta": { "internalUserId": "usr_9912" } } '

{ "id": "customer_f31121c389624d3697cbf3ea8830b7a4", "type": "individual", "email": "jane.smith@example.com", "phone": "+14155550123", "firstName": "Jane", "lastName": "Smith", "verificationProfiles": [ { "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": [] } } ], "meta": { "internalUserId": "usr_9912" }, "createdAt": "2026-03-09T20:46:31.305Z", "updatedAt": "2026-04-01T14:22:10.000Z" }

Autorizaciones

Authorization

string

header

requerido

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

Parámetros de ruta

string

requerido

Customer ID

Ejemplo:

"customer_f31121c389624d3697cbf3ea8830b7a4"

Cuerpo

application/json

address

object

The address of the customer. Required if personalInformation is provided.

Show child attributes

Ejemplo:

{
  "line1": "233 South Wacker Drive",
  "line2": "Suite 4700",
  "city": "Chicago",
  "postalCode": "60606",
  "state": "IL",
  "country": "USA"
}

personalInformation

object

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.

Show child attributes

Respuesta

Individual
Business

Response containing information about an individual customer.

string

requerido

Customer ID

Ejemplo:

"customer_f31121c389624d3697cbf3ea8830b7a4"

verificationProfiles

object[]

requerido

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.

Show child attributes

Ejemplo:

[
  {
    "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": []
    }
  }
]

createdAt

string

requerido

ISO 8601 formatted customer creation timestamp

Ejemplo:

"2026-03-09T20:46:31.305Z"

updatedAt

string

requerido

ISO 8601 formatted customer update timestamp

Ejemplo:

"2026-03-09T20:46:31.305Z"

type

enum<string>

requerido

Customer type

Opciones disponibles:

individual

Ejemplo:

"individual"

string

Customer email address

Ejemplo:

"jane.smith@example.com"

phone

string

Customer phone number

Ejemplo:

"+14155550123"