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
2
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_iden 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 Contentes el estado válido que confirma que se eliminó al destinatario.