Fiscal

Validate CFDI (Electronic Invoice)

Credits: 1 per call.

Validates a CFDI (Comprobante Fiscal Digital por Internet) — Mexico’s mandatory electronic invoice — by checking its current status with SAT. Returns whether the CFDI is currently valid (VALID) or cancelled (CANCELED), the cancellation status (e.g. requires receiver acceptance), and the fiscal effect (INCOME, EXPENSE, TRANSPORT, PAYROLL, PAYMENT).

Use this endpoint when reconciling supplier invoices, processing expense reports, or ensuring that the invoices you receive are real and not later cancelled by the issuer without your knowledge.

cURL

curl -X POST https://api.origoid.com/mex/fiscal/v1/cfdi-validations \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"uuid": "7C8BD4EA-AE86-4CB5-88B8-C6E61E988A8B", "rfcEmisor": "PEZJ811011KI1", "rfcReceptor": "EMP170623KI3", "total": "999999.99"}'

{
  "status": "OK",
  "type": "SUCCESS",
  "message": "CFDI is valid and active",
  "data": {
    "uuid": "7C8BD4EA-AE86-4CB5-88B8-C6E61E988A8B",
    "issuer": {
      "rfc": "PEZJ811011KI1",
      "name": "JUAN ALONSO PEREZ ZAPATA"
    },
    "receiver": {
      "rfc": "EMP170623KI3",
      "name": "EMPRESA, S.A. DE C.V."
    },
    "issueDate": "2020-05-18T16:04:42-06:00",
    "certificationDate": "2020-05-18T16:18:54-06:00",
    "pacRfc": "SAT970701NN3",
    "total": {
      "amount": "999999.99",
      "currency": "MXN"
    },
    "effect": "INCOME",
    "status": "VALID",
    "cancellationStatus": "CANCELABLE_WITH_ACCEPTANCE",
    "officialMessage": "Vigente"
  },
  "transactionId": "088a6952-eb77-434d-aeac-0970acdb4b25",
  "processedAt": "2026-04-26T10:00:00-06:00",
  "billable": true
}

Autorizaciones

x-api-key

string

header

requerido

Cuerpo

application/json

Option 1
Option 2

uuid

string

requerido

CFDI Folio Fiscal (UUID format 8-4-4-4-12). Required when sending direct identifiers.

Ejemplo:

"7C8BD4EA-AE86-4CB5-88B8-C6E61E988A8B"

rfcEmisor

string

requerido

RFC of the issuer (12 or 13 chars). Required when sending direct identifiers.

Ejemplo:

"PEZJ811011KI1"

rfcReceptor

string

requerido

RFC of the receiver (12 or 13 chars). Required when sending direct identifiers.

Ejemplo:

"EMP170623KI3"

total

string

requerido

Total CFDI amount as decimal string (no currency symbol). Required when sending direct identifiers.

Ejemplo:

"999999.99"

document

string

Base64-encoded CFDI document. Accepts the XML invoice or a printable representation (PDF, PNG, JPG) containing the SAT QR code. The format is auto-detected from the payload; the backend derives the identifiers from the XML body or from the embedded QR.

Respuesta

CFDI Validation Result (Strict Envelope Pattern).

status

enum<string>

requerido

High-level outcome. OK means the request was successfully processed (regardless of business result). ERROR means the request was rejected or could not be processed.

Opciones disponibles:

OK,

ERROR

type

string

requerido

Stable result type code. Includes generic codes (SUCCESS, INVALID_REQUEST, UNAUTHORIZED, SERVICE_UNAVAILABLE, INTERNAL_ERROR, RATE_LIMIT_EXCEEDED) plus endpoint-specific result codes — see this endpoint's response examples.

message

string

requerido

Human-readable summary of the result. Always in English (per Language Conventions in the API overview).

transactionId

string<uuid>

requerido

Unique identifier of this request, generated by the API Gateway. Propagated end-to-end for traceability.

processedAt

string<date-time>

requerido

ISO 8601 datetime with Mexico City offset (-06:00). Always set by the API Gateway when the response leaves the system.

billable

boolean

requerido

Whether this request will be charged against the client's plan. Typically true for successful business results and false for validation errors or system errors that prevented processing.

data

object

Response payload. null on error responses. Shape depends on the endpoint — see each operation's response schema.

errors

object[]

Per-field error details. Present only on INVALID_REQUEST responses.

Show child attributes

CEP / SPEI Payment Validation**Credits:** 1 per call. Validates a Mexican SPEI transfer against Banco de México's official **CEP** service ("Comprobante Electrónico de Pago") and returns the verified transfer details together with Banxico's cryptographic proof. Use it to confirm that a SPEI payment actually settled, for reconciliation, payout confirmation, or fraud checks on a claimed transfer.

cURL

curl -X POST https://api.origoid.com/mex/fiscal/v1/cfdi-validations \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"uuid": "7C8BD4EA-AE86-4CB5-88B8-C6E61E988A8B", "rfcEmisor": "PEZJ811011KI1", "rfcReceptor": "EMP170623KI3", "total": "999999.99"}'

{
  "status": "OK",
  "type": "SUCCESS",
  "message": "CFDI is valid and active",
  "data": {
    "uuid": "7C8BD4EA-AE86-4CB5-88B8-C6E61E988A8B",
    "issuer": {
      "rfc": "PEZJ811011KI1",
      "name": "JUAN ALONSO PEREZ ZAPATA"
    },
    "receiver": {
      "rfc": "EMP170623KI3",
      "name": "EMPRESA, S.A. DE C.V."
    },
    "issueDate": "2020-05-18T16:04:42-06:00",
    "certificationDate": "2020-05-18T16:18:54-06:00",
    "pacRfc": "SAT970701NN3",
    "total": {
      "amount": "999999.99",
      "currency": "MXN"
    },
    "effect": "INCOME",
    "status": "VALID",
    "cancellationStatus": "CANCELABLE_WITH_ACCEPTANCE",
    "officialMessage": "Vigente"
  },
  "transactionId": "088a6952-eb77-434d-aeac-0970acdb4b25",
  "processedAt": "2026-04-26T10:00:00-06:00",
  "billable": true
}