BANXICO1 tokenPOST

Estatus transferencia SPEI

Consulta el estatus de una transferencia SPEI a partir de la clave de rastreo o el número de referencia. Útil para monitorear el ciclo de vida de la operación (LIQUIDADO, DEVUELTO, etc.) en flujos contables o de soporte.

Endpoint

POSThttps://api.datosnonstop.com/v1/banxico/spei-estatus

Parámetros

json

{
  "tipo": "clave_rastreo",
  "fecha": "2023-02-28",
  "claveRastreo": "123456789987654321",
  "emisor": "40002",
  "receptor": "40058"
}

ParámetroTipoRequeridoDescripción

tipostringSíTipo de búsqueda. Determina cuál campo de identificación de la transferencia debe enviarse. Valores permitidos: clave_rastreo, referencia_numerica.

fechastringSíFecha de la transferencia en formato ISO YYYY-MM-DD.

claveRastreostringNoClave de rastreo asignada por la institución emisora. Requerido cuando tipo es clave_rastreo.

referenciaNumericastringNoReferencia numérica de la transferencia. Requerido cuando tipo es referencia_numerica.

emisorstringSíCódigo de 5 dígitos de la institución emisora del SPEI.

receptorstringSíCódigo de 5 dígitos de la institución receptora del SPEI.

Ejemplo rápido

Coloca tu API key en el header x-api-key y agrega el header Content-Type: application/json para enviar el body como JSON.

curl

curl -X POST https://api.datosnonstop.com/v1/banxico/spei-estatus \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"tipo":"clave_rastreo","fecha":"2023-02-28","claveRastreo":"123456789987654321","emisor":"40002","receptor":"40058"}'

Tip

¿Sabías que al pegar un cURL en Postman te crea automáticamente la llamada con todos los elementos?

Token

Cada consulta consume tokens. Lo que no uses, lo conservas — tu saldo se acumula sin fecha de vencimiento ni reinicios. Puedes consultarlo en cualquier momento desde el dashboard o directamente en el header de cada respuesta x-tokens-remaining.

Respuesta

JSON

200 OK

{
  "id": "66ce5f1d938e57608b1b972b",
  "status": "found",
  "tipo": "clave_rastreo",
  "claveRastreo": "BITSO5006108508115383",
  "estatus": "LIQUIDADO",
  "numeroReferencia": "515018",
  "fechaOperacion": "2017-09-22",
  "fechaRecepcion": "2017-09-22T20:14:55Z",
  "fechaProcesamiento": "2017-09-22T20:14:57Z",
  "ordenante": {
    "banco": {
      "clave": "90646",
      "nombre": "STP"
    }
  },
  "beneficiario": {
    "banco": {
      "clave": "40012",
      "nombre": "BBVA BANCOMER"
    }
  }
}

Respuestas en error

JSON

400 Bad Request

[
  {
    "type": "required",
    "message": "El campo es requerido",
    "field": "fecha"
  },
  {
    "type": "catalog",
    "message": "El valor no existe en el catálogo",
    "field": "tipo"
  },
  {
    "type": "required",
    "message": "El campo es requerido",
    "field": "claveRastreo"
  },
  {
    "type": "format",
    "message": "El formato del campo es inválido",
    "field": "emisor"
  }
]

Campos

Campos de entrada

CampoTipoDescripción

tipostringTipo de búsqueda. Determina cuál campo de identificación de la transferencia debe enviarse: cuando es clave_rastreo se requiere claveRastreo; cuando es referencia_numerica se requiere referenciaNumerica. Ver catálogo Tipo de búsqueda.

fechastringFecha en que se ejecutó la transferencia SPEI, en formato ISO YYYY-MM-DD.

claveRastreostringIdentificador único asignado por la institución emisora a la transferencia SPEI. Requerido cuando tipo es clave_rastreo.

referenciaNumericastringReferencia numérica que la institución emisora asocia a la transferencia. Requerido cuando tipo es referencia_numerica.

emisorstringCódigo de 5 dígitos asignado por Banxico a la institución que originó la transferencia. Ver catálogo Instituciones SPEI.

receptorstringCódigo de 5 dígitos asignado por Banxico a la institución que recibió la transferencia. Ver catálogo Instituciones SPEI.

Campos de respuesta

CampoTipoDescripción

idstringIdentificador interno de la consulta, útil para soporte y trazabilidad.

statusstringResultado de la consulta del estatus en SPEI. Ver catálogo Status.

tipostringTipo de búsqueda enviado en la consulta. Refleja el valor recibido en el request. Ver catálogo Tipo de búsqueda.

claveRastreostringClave de rastreo de la transferencia. En respuestas found siempre está presente (es la clave registrada en SPEI). En respuestas not_found solo está presente cuando tipo es clave_rastreo y ecoa la clave consultada.

referenciaNumericastringReferencia numérica de la transferencia. Solo está presente en respuestas not_found cuando tipo es referencia_numerica.

messagestringDetalle del motivo cuando status es not_found. Solo está presente en respuestas not_found.

estatusstringEstatus actual de la transferencia en SPEI. Ver catálogo Estatus SPEI.

numeroReferenciastringNúmero de referencia interno asignado por SPEI a la transferencia.

fechaOperacionstringFecha en que se ejecutó la transferencia SPEI, en formato ISO YYYY-MM-DD.

fechaRecepcionstringFecha y hora en que SPEI recibió la transferencia, en formato ISO 8601 con zona horaria UTC.

fechaProcesamientostringFecha y hora en que SPEI procesó la transferencia, en formato ISO 8601 con zona horaria UTC.

ordenanteobjectDatos de la institución que originó la transferencia.

ordenante.bancoobjectInstitución bancaria emisora de la transferencia.

ordenante.banco.clavestringCódigo de 5 dígitos asignado por Banxico a la institución emisora. Ver catálogo Instituciones SPEI.

ordenante.banco.nombrestringNombre comercial de la institución emisora.

beneficiarioobjectDatos de la institución que recibió la transferencia.

beneficiario.bancoobjectInstitución bancaria receptora de la transferencia.

beneficiario.banco.clavestringCódigo de 5 dígitos asignado por Banxico a la institución receptora. Ver catálogo Instituciones SPEI.

beneficiario.banco.nombrestringNombre comercial de la institución receptora.

Catálogos

Tablas de referencia para los valores de los campos enumerados en la sección anterior.

Status

Valores posibles del campo status.

ValorDescripción

foundSe localizó la transferencia en SPEI. La respuesta incluye el estatus actual y los datos de la operación.

not_foundNo se localizó la transferencia con el dato consultado (claveRastreo o referenciaNumerica). La respuesta incluye el campo message con el detalle.

Tipo de búsqueda

Valores posibles del campo tipo en la consulta. Define cuál campo de identificación de la transferencia se debe enviar en el request.

ValorDescripción

clave_rastreoBúsqueda por clave de rastreo. Requiere enviar el campo claveRastreo en el body.

referencia_numericaBúsqueda por referencia numérica. Requiere enviar el campo referenciaNumerica en el body.

Estatus SPEI

Valores posibles del campo estatus que reporta Banxico sobre el ciclo de vida de la transferencia.

ValorDescripción

LIQUIDADOLa transferencia fue acreditada al beneficiario y la operación se completó.

DEVUELTOLa transferencia fue regresada al ordenante por la institución receptora.

CANCELADOLa transferencia fue cancelada antes de ser procesada.

PENDIENTELa transferencia aún no ha sido procesada por SPEI.

RECHAZADOLa transferencia fue rechazada por la institución receptora o por SPEI.

Instituciones SPEI

Códigos de 5 dígitos asignados por Banxico a las instituciones participantes en SPEI. Aplica a los campos emisor y receptor de la consulta y a banco.clave del ordenante y del beneficiario.

Consulta el catálogo oficial de instituciones SPEI de Banxico.

Histórico

Endpoint

GEThttps://api.datosnonstop.com/v1/banxico/spei-estatus/historico/{id}

El {id} corresponde al campo id devuelto en la respuesta de la consulta principal.

Si necesitas la lista completa de elementos almacenados, accede a tu dashboard.

La respuesta está sujeta al tiempo de almacenamiento de tu plan. Si requieres más tiempo, cambia de plan en tu dashboard.

Respuesta

JSON

200 OK

{
  "id": "66ce5f1d938e57608b1b972b",
  "status": "found",
  "tipo": "clave_rastreo",
  "claveRastreo": "BITSO5006108508115383",
  "estatus": "LIQUIDADO",
  "numeroReferencia": "515018",
  "fechaOperacion": "2017-09-22",
  "fechaRecepcion": "2017-09-22T20:14:55Z",
  "fechaProcesamiento": "2017-09-22T20:14:57Z",
  "ordenante": {
    "banco": {
      "clave": "90646",
      "nombre": "STP"
    }
  },
  "beneficiario": {
    "banco": {
      "clave": "40012",
      "nombre": "BBVA BANCOMER"
    }
  }
}

Respuestas en error

JSON

404 Not Found

[
  {
    "type": "not_found",
    "message": "el id no fue encontrado en el historico"
  }
]

Sandbox

Endpoint

POSThttps://sandbox.api.datosnonstop.com/v1/banxico/spei-estatus

Para llamar al sandbox necesitas una API key de sandbox que puedes generar en el dashboard.

curl

curl -X POST https://sandbox.api.datosnonstop.com/v1/banxico/spei-estatus \
  -H "x-api-key: tu_api_key_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"tipo":"clave_rastreo","fecha":"2023-02-28","claveRastreo":"123456789987654321","emisor":"40002","receptor":"40058"}'

Casos de prueba

Si envías un valor que no esté en la lista, el sandbox devuelve automáticamente una respuesta exitosa con la misma estructura que la de 123456789987654321.

CasoCampoValor

Caso exitoso — Encontrado por claveRastreoclaveRastreo123456789987654321

Caso exitoso — No encontrado por claveRastreoclaveRastreo999999999000000001

Caso exitoso — Encontrado por referenciaNumericareferenciaNumerica1702230

Caso exitoso — No encontrado por referenciaNumericareferenciaNumerica9999999

Sin tokensclaveRastreo333333333000000003

Error internoclaveRastreo444444444000000004

Unavailable serviceclaveRastreo555555555000000005

Endpoint histórico

GEThttps://sandbox.api.datosnonstop.com/v1/banxico/spei-estatus/historico/{id}

Para llamar al sandbox necesitas una API key de sandbox que puedes generar en el dashboard.

curl

curl https://sandbox.api.datosnonstop.com/v1/banxico/spei-estatus/historico/66ce5f1d938e57608b1b972b \
  -H "x-api-key: tu_api_key_sandbox"

Casos de prueba histórico

Si envías un valor de id que no esté en la lista, el sandbox devuelve automáticamente una respuesta exitosa con la misma estructura que la de 66ce5f1d938e57608b1b972b.

Casoid

Caso exitoso66ce5f1d938e57608b1b972b

No encontrado0000000000000000ffffffff

Fuera de rango1111111111111111aaaaaaaa

Error interno2222222222222222bbbbbbbb

Empezar gratis →