Saltar al contenido principal

Crear Entidad SPEI®

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

Solicitud HTTP

POST /clabe/entity

Parámetros del encabezado

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

Parametros del cuerpo

ParámetroTipoPatrónDescripción
name
requerido
cadena1-100 caracteresNombre de la entidad.
rfc_curp
requerido
cadena10-13 o 18 caracteresRFC o CURP de la entidad.
account_reference
requerido
cadenaReferencia de cuenta de la entidad.
creation_date
requerido
fechaFormato YYYY-MM-DDFecha de creación de la entidad.
creation_country
requerido
cadenaPaís de creación de la entidad.
email
requerido
cadenacorreo electrónicoCorreo electrónico de la entidad.
observations
requerido
cadena0-255 caracteresObservaciones 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"
}
}
}
}