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. |
| 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
9
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
22
22
{ "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_idsea 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.