Saltar al contenido principal

Eliminar usuario

Elimina al usuario autenticado dentro del alcance de red de su token de acceso de usuario.

Dominio
Users and identity
Servicio responsable
Merchant management
Dirigido a
Aplicación del cliente · usuario a servidor
Autorización compatible
Token Bearer del usuario autenticado

Encabezados#

3
AuthorizationstringObligatorio
Aceptado o reenviado por el API Gateway para esta operación.
X-Device-IdstringOpcional
Aceptado o reenviado por el API Gateway para esta operación.
X-Merchant-IdstringOpcional
Aceptado o reenviado por el API Gateway para esta operación.

Parámetros de ruta#

1
user_idstring<uuid>Obligatorio
Valor que sustituye a `user_id` en la ruta del endpoint.

Cuerpo de la solicitud#

0
Este endpoint no acepta cuerpo de solicitud.

Respuesta#

6
204La solicitud se aceptó o completó. Revisa el payload para conocer el resultado de negocio.
400La solicitud no es válida o no supera la validación.
401Las credenciales o el contexto del llamador no son válidos.
404No se encontró el recurso o la ruta solicitada.
500El servicio no pudo completar la solicitud. Reintenta solo cuando la operación sea segura o idempotente.
503El servicio no pudo completar la solicitud. Reintenta solo cuando la operación sea segura o idempotente.

Antes de eliminar un usuario#

  • Obtén el token de acceso de usuario del cliente mediante el flujo de autenticación.
  • Establece el ID de usuario de la ruta con el UUID del cliente autenticado. Un cliente solo puede eliminar su propio usuario.
  • Confirma que el cliente desea eliminar su cuenta de la red asociada con ese token.

Comprende el alcance de la eliminación#

Con un token limitado a una red, la eliminación quita la membresía del usuario y sus direcciones de esa red, y solicita eliminar sus tarjetas de la misma red. Esto no implica eliminarlo de todas las redes de DEUNA. Un token de cuenta con alcance general de DEUNA también elimina la cuenta y sus membresías de red. Una eliminación exitosa elimina las sesiones activas del usuario.

No interpretes esta operación como confirmación de que se han borrado todos los registros históricos de pagos o todos los datos personales. Confirma el alcance requerido de eliminación de cuentas y datos con tu Technical Account Manager de DEUNA antes de crear un flujo de cierre de cuenta.

Envía la solicitud de eliminación#

Usa la URL base de sandbox que se muestra a continuación para las pruebas y https://api.deuna.io para producción. Envía el token Bearer del cliente en el encabezado Authorization. El endpoint no tiene parámetros de consulta ni cuerpo de solicitud.

curl --request DELETE \
  --url 'https://api.sandbox.deuna.io/users/USER_ID' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN'

Verifica el resultado#

Una solicitud exitosa devuelve HTTP 204 No Content con un cuerpo vacío. Borra la sesión local del cliente y muéstrale la experiencia sin sesión iniciada. No analices la respuesta como JSON ni esperes un webhook de pago para confirmar esta operación.

Gestiona errores y resultados inciertos#

HTTP 400 puede indicar que el usuario de la ruta es distinto al del token. HTTP 401 significa que el token de usuario no puede autorizar la solicitud; HTTP 404 significa que no se encontró el registro solicitado. Corrige la solicitud o la autenticación antes de reintentar.

Puede producirse un tiempo de espera agotado o un error del servidor después de que parte de la eliminación haya surtido efecto. HTTP 503 puede producirse durante la limpieza de sesiones posterior a la eliminación. No supongas que un reintento devolverá la misma respuesta ni repitas la solicitud automáticamente. Consulta el estado de la cuenta con el soporte de DEUNA cuando el resultado sea incierto. No se define un contrato de clave de idempotencia para esta operación.

Ver códigos de respuesta y resolución de problemas para obtener información general sobre la gestión de errores.