/verify/rfc_check

1.API Specification
2.Request Params
3.Response Params
4.Error Codes
5.Sample

1.API Specification

This API is used to verify Mexico RFC Number(Tax ID).

Request Method

POST

Request URL

https://cloudapi.mexico.accuauth.com/verify/rfc_check

Debugging Tool

Debugging Tool

2.Request Params

2.1 Request Header

Parameter Type Required Description
X-DF-API-ID string Yes For API credentials，Please visit API Request
X-DF-API-SECRET string Yes For API credentials，Please visit API Request

2.2 Request Body

Required Fields Type Description
required rfc string RFC number

3.Response Params

Fields Type Description
request_id string Unique id of each request
status string Response status, OK for success request, Error Codes for failed request
result_code string Result code
result_message string Result message
result object The verification result

3.1 Result Codes

Value Description Billable
0 Success Yes
1 Invalid RFC or RFC is not ready to use. Yes

3.2 Elements in `result`

Fields Type Description
estatus string OK or ERROR
mensaje string Message details
codigoValidacion string Validation code
codigoError string "0": Valid RFC but not ready to use; "1": Invalid RFC
tipoPersona string M: company, F: person
claveMensaje string Same as result_code
Response Syntax
  • Valid RFC
{
    "status": "OK",
    "result_code": "0",
    "result_message": "success",
    "result": {
        "estatus": "OK",
        "mensaje": "RFC Valido",
        "tipoPersona": "F",
        "codigoValidacion": "vr1685673393.6108963",
        "claveMensaje": "0"
    },
    "request_id": "TID3918e4830f724f5c83e91c9fd8e2d84f"
}
  • Invalid RFC
{
    "status": "OK",
    "result_code": "1",
    "result_message": "El RFC ingresado no se encuentra en la lista de RFC no cancelados",
    "request_id": "TID47a64a721b1b45b68de4e9d80a750fdf"
}

4.Error Codes

Common error codes of this API:

Http Status Code Status Field Description
400 INVALID_ARGUMENT Request parameter is invalid
400 VERIFY_FAILED Verify failed
400 ABNORMAL_BEHAVIOURS_DETECTED Request with same parameters repeated more than amount of times
401 UNAUTHORIZED Unauthorized or access is denied
401 KEY_EXPIRED Your API ID has expired
403 NO_PERMISSION You are not authorized to use this API
403 OUT_OF_QUOTA API calls quota exceeded
403 RATE_LIMIT_EXCEEDED API request frequency exceeds the limit
404 NOT_FOUND Requested API cannot be found
500 INTERNAL_ERROR Internal server error
512 SOURCE_SERVICE_UNAVAILABLE Source service is unavailable
513 SOURCE_SERVICE_TIMEOUT Source service is timeout

Comment: Please see the reason field for details when the above 40X / 51X error occurred

Response Syntax
{
  "status": "INVALID_ARGUMENT",
  "reason": "argument 'rfc': not found",
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}

5.Sample

results matching ""

    No results matching ""