CER service

CER validation allows to validate a digital signature certificate and get the structured data of the owner.

Web service description

Validate CER

This method performs the validation of a digital signature certificate.

Endpoint

~/api/certificate/validate

Parameters

Tag	Type	Required	Description
rfc	string	yes	Name of the RFC (Registro Federal de Contribuyentes) to validate.
certificate	file	yes	Digital signature certificate file .cer.

Headers

Tag	Type	Description
apikey	string	yes

FormData

{
  "rfc": "string",
  "certificate": "file"
}

Response:

Name	Type	Description
Correct:
valid	boolean	"Success"
expired	boolean	Effective date
coincidence	boolean	Result of the check in SAT
serialNumber	string	Certificate serial number
rfc	string	Name of Registro Federal de Contribuyentes
notBefore	string	Initial validity date
notAfter	string	Dateline
Error
code:	integer	Error code
message	string	"Error message"

Example

{
  "valid": boolean,
  "expired": boolean,
  "coincidence": boolean,
  "serialNumber": "string",
  "rfc": "string",
  "notBefore": "string",
  "notAfter": "string"
}

Error

{
  "error": "Error code",
  "message": "Error message"
}

Service messages

Code	Message	Description
CER003	The apiKey is not valid	Message that is displayed when the apikey is not correct.
CER005	The file format is wrong, it must be a .cer file	Message displayed when wrong file extension.
CER007	The .cer file is required	Message displayed when the .cer file is not found in the request.
CER011	The RFC is required	Message displayed when the RFC is not found in the request.