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.

Información

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

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" }'

Cuerpo de la Respuesta

Código HTTP: 200 OK

Ejemplo de Respuesta

{ "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" }

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