GEThttps://api.veriko.mx/v1/validations/{id}/cep

Descargar el CEP oficial

Audiencia
public
Autenticación
API key
Permiso
validations_cep:download
Guía de uso →

Descarga el Comprobante Electrónico de Pago que emite Banxico para una transferencia ya verificada. Solo existe cuando la verificación terminó en banxico_status: 'valid', que es lo mismo que has_cep: true; en cualquier otro caso la respuesta es 404 cep_not_available. El formato por defecto es XML. Con ?format=pdf se obtiene el PDF firmado por Banxico, que es el que sirve como comprobante ante terceros. Para un rango de fechas completo hay una vía mejor que llamar aquí una vez por validación: GET /v1/finance/ceps devuelve todos los CEP del periodo en un solo ZIP, con sus manifiestos. Qué validaciones tienen CEP disponible se sabe filtrando GET /v1/validations por status=valid.

Parámetros
ParámetroUbicaciónTipoObligatorioDescripción
id*pathstring (uuid)obligatorio

UUID de la validación

formatquerystringopcional

Formato del certificado: xml (defecto) o pdf.

Predeterminado: xml

p. ej. xml
Petición
curl -X GET 'https://api.veriko.mx/v1/validations/{id}/cep' \
  -H 'Authorization: Bearer veriko_••••'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

Códigos de respuestaGET /v1/validations/{id}/cep
CódigoClaseDescripciónCuerpo
2002xxArchivo del certificado CEP. El Content-Type es application/xml o application/pdf según el formato solicitado.Sin cuerpo
4004xxFormato fuera del allowlist (invalid_export_format).ErrorResponse
4014xxSe requiere autenticación o las credenciales son inválidasErrorResponse
4034xxPermisos insuficientesErrorResponse
4044xxValidación no encontrada (not_found) o el CEP no está disponible para esta validación (cep_not_available). El CEP no se emite cuando banxico_status no es valid, o cuando el XML/PDF asociado no fue persistido.ErrorResponse
4224xxUUID inválido en el path (invalid_uuid).ErrorResponse
Cabeceras de respuesta200
CabeceraTipoDescripción
Content-DispositionstringForzar descarga con nombre CEP-{validation_id}.{ext}.
Errores de GET /v1/validations/{id}/cep
CódigoClaveEjemplo
401unauthorized

Credenciales de autenticación ausentes o inválidas.

Envelope
meta.request_id
c4d5e6f7a8b9
403forbidden

No tienes permiso para acceder a este recurso.

Envelope
meta.request_id
d5e6f7a8b9c0