Crear Entidad SPEI®

Esta operación permite registrar una nueva entidad en el sistema SPEI®.

Solicitud HTTP

POST /clabe/entity

Parámetros del encabezado

Encabezado	Descripción
Authorization  requerida	El bearer token creado en Obtener token de autorización
Content-Type requerido	application/json

Parametros del cuerpo

Parámetro	Tipo	Patrón	Descripción
name requerido	cadena	1-100 caracteres	Nombre de la entidad.
rfc_curp requerido	cadena	10-13 o 18 caracteres	RFC o CURP de la entidad.
account_reference requerido	cadena		Referencia de cuenta de la entidad.
creation_date requerido	fecha	Formato YYYY-MM-DD	Fecha de creación de la entidad.
creation_country requerido	cadena		País de creación de la entidad.
email requerido	cadena	correo electrónico	Correo electrónico de la entidad.
observations requerido	cadena	0-255 caracteres	Observaciones adicionales sobre la entidad.

Ejemplo de solicitud JSON:

{
    "name": "Entidad Ejemplo",
    "rfc_curp": "XAXX010101000",
    "account_reference": "REF123456789",
    "creation_date": "2024-01-01",
    "creation_country": "MX",
    "email": "[email protected]",
    "observations": "Observaciones sobre la entidad."
}

Ejemplo de respuesta JSON:

{
    "success": true,
    "code": 0,
    "message": "Entidad registrada exitosamente.",
    "data": {
        "spei_account": {
            "id": "22222222-daa7-1234-aaaa-123123123ecd",
            "name": "Entidad Ejemplo",
            "rfc_curp": "XAXX010101000",
            "email": "[email protected]",
            "account_reference": "REF123456789",
            "clabe": "012345678901234567",
            "observations": "Observaciones sobre la entidad.",
            "type": {
                "key": "ENT",
                "value": "Entidad"
            },
            "status": {
                "key": "ACTIVE",
                "value": "Activo"
            }
        }
    }
}