Eliminar Destinatario

Visión General

Este endpoint permite crear un Cliente (Customer) dentro de la API de Passport proporcionando los datos de identificación necesarios. Una solicitud exitosa retorna el ID del cliente y la información de confirmación del recurso creado.

Detalles del Endpoint

Parámetro

Descripción

Endpoint

https://api.paas.sandbox.co.passportfintech.com/v1/recipients/:recipient_id

Método

DELETE

Encabezados

Content-Type: application/json, Authorization

Autenticación

Token de Acceso (Bearer Token)

Cuerpo de la Solicitud

  • No requiere cuerpo de solicitud.

Ejemplo de Solicitud

curl --location --request DELETE 'https://api.paas.sandbox.co.passportfintech.com/v1/recipients/77d530d0-c5b4-47cc-ab5c-d073fdd6ef67' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \

Cuerpo de la Respuesta

  • Código HTTP: 204 No Content.

Errores Comunes y Manejo

Código HTTP

Significado

Descripción

400 Bad Request

Datos inválidos

Faltan campos requeridos o contienen valores incorrectos.

401 Unauthorized

Token inválido

El token de acceso ha expirado o es inválido.

403 Forbidden

Acceso denegado

La solicitud no está autorizada para eliminar el destinatario.

500 Server Error

Error del servidor

Se produjo un error inesperado al procesar la validación.

Buenas Prácticas

  • Incluye el recipient_id en la solicitud como un parámetro de ruta. Es fundamental que proporciones el identificador del destinatario en el formato correcto dentro de la URL del endpoint al realizar la solicitud. Esto asegurará que el sistema pueda identificar de manera precisa a quién va dirigida la información o el recurso solicitado.

  • 204 No Content es el estado válido que confirma que se eliminó al destinatario.