Actualizar Cliente

Visión General

Este endpoint permite realizar actualizaciones en el registro de un cliente.

Detalles del Endpoint

Parámetro	Descripción
Endpoint	https://api.paas.sandbox.co.passportfintech.com/v1/customers/:customer_id
Método	PATCH
Encabezados	Content-Type: application/json, Authorization
Autenticación	Token de Acceso (Bearer Token)

Cuerpo de la Solicitud

Parámetro	Tipo	Descripción
id	String	Identificador único del objeto cliente.
business_name	String	Nombre legal registrado del cliente.
email	String	Correo electrónico de contacto del cliente.
mobile_phone_number	String	Número de teléfono móvil del cliente.
identification_number	String	El número de identificación único del cliente, sin dígito de verificación.
merchant_category_code	String	El número de identificación único del cliente, sin dígito de verificación.

El parámetro de identificación (id) es un campo que no se puede modificar.

Ejemplo de Solicitud

JSON
    
    
 
curl --location --request PATCH 'https://api.paas.demo.co.passportfintech.com/v1/customers/db7e89e7-59d8-4ab1-b675-a2ae52c3339e' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
  "id": "db7e89e7-59d8-4ab1-b675-a2ae52c3339e",
  "business_name": "changing",
  "email": "eAqpUh6u@example.com",
  "mobile_phone_number": "573956158117"
}'
Copy

Cuerpo de la Respuesta

Código HTTP: 200 OK

Ejemplo de Respuesta

JSON
    
 
{
    "business_name": "changing",
    "type": "BUSINESS",
    "created_at": "2025-10-09T10:40:27.446Z",
    "updated_at": "2025-10-09T17:19:27.951Z",
    "email": "eAqpUh6u@example.com",
    "identification_type": "NIT",
    "identification_number": "903978023",
    "status": "ACTIVE",
    "merchant_category_code": "0412",
    "mobile_phone_number": "573956158117",
    "address": {
        "state": "Bolivar",
        "line_1": "Diagonal 46 1104",
        "line_3": "Calle 20 675",
        "city": "Cartagena",
        "post_code": "101010",
        "line_2": "Carrera 18 2111",
        "country": "CO"
    },
    "id": "db7e89e7-59d8-4ab1-b675-a2ae52c3339e"
}
Copy

Errores Comunes y Manejo

Código HTTP	Significado	Descripción
400	Bad Request	Validación fallida (por ejemplo, campo faltante o inválido).
401	Unauthorized	Token Bearer ausente o inválido.
403	Forbidden	Alcance insuficiente o permisos de acceso insuficientes.
404	Not Found	El cliente con el `ID` proporcionado no existe.

Buenas Prácticas

Refresca los tokens OAuth antes de que expiren para evitar fallas de autenticación.
Asegúrate de que el customer_id sea correcto antes de enviar la actualización.
Valida los datos de entrada (correo electrónico, número de teléfono) antes de enviar la petición.
Registra cambios en clientes críticos para trazabilidad y auditoría.

Última actualización el