Eliminar usuario
Elimina al usuario autenticado dentro del alcance de red de su token de acceso de usuario.
Encabezados#
3Parámetros de ruta#
1Cuerpo de la solicitud#
0Respuesta#
6Antes 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'const response = await fetch("https://api.sandbox.deuna.io/users/USER_ID", {
method: "DELETE",
headers: {
"Authorization": "Bearer USER_ACCESS_TOKEN"
}
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();import requests
response = requests.request(
"DELETE",
"https://api.sandbox.deuna.io/users/USER_ID",
headers={
"Authorization": "Bearer USER_ACCESS_TOKEN"
},
)
response.raise_for_status()
data = response.json()<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sandbox.deuna.io/users/USER_ID",
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer USER_ACCESS_TOKEN"
]
]);
$response = curl_exec($curl);
curl_close($curl);import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Example {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.sandbox.deuna.io/users/USER_ID"))
.header("Authorization", "Bearer USER_ACCESS_TOKEN")
.method("DELETE", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient().send(
request, HttpResponse.BodyHandlers.ofString()
);
System.out.println(response.body());
}
}package main
import (
"fmt"
"io"
"net/http"
)
func main() {
request, err := http.NewRequest("DELETE", "https://api.sandbox.deuna.io/users/USER_ID", nil)
if err != nil { panic(err) }
request.Header.Set("Authorization", "Bearer USER_ACCESS_TOKEN")
response, err := http.DefaultClient.Do(request)
if err != nil { panic(err) }
defer response.Body.Close()
body, _ := io.ReadAll(response.Body)
fmt.Println(string(body))
}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.
¿Te resultó útil esta página?