Skip to content

Your system finds out when something happens to your CFDI.

When a CFDI is stamped or cancelled, or when a payment is recorded, Factura Digital sends a signed notification to your system's URL. If your server doesn't respond, the notification is retried. It's included with API v5: you pay for folios, not the API.

How notifications reach your system

Illustrative example: each notification is a request to the URL you register, with the event type and the CFDI it refers to.

Notifications received
Illustrative example
receivedretryexample
Notification content
example
Event
CFDI stamped
CFDI UUID
71E5C0A8-4D2F-4B19-…
Signature
In the request header

The full format of each notification is in the documentation. docs.facturadigital.com.mx

Events you receive

The moments in the CFDI lifecycle that matter to your system.

CFDI stamped

A CFDI was stamped in your account. Useful for saving the UUID in your ERP or triggering the next step of your process.

CFDI cancelled

A CFDI was cancelled. Your system can update its status without anyone typing it in by hand.

Payment recorded

A payment was recorded for an invoice. Useful for marking it as collected in your system.

From the event to your system

You register your system's URL once. After that, each notification arrives when the event happens.

  1. step 01

    You register your system's URL

    one time

  2. step 02

    The event happens

    stamping, cancellation or payment

  3. step 03

    We send a signed notification

    to your URL

  4. step 04

    No response? We retry

Verify the signature of each notification before processing it: that's how you know it comes from Factura Digital. Since a notification can be retried, make sure your system can receive the same notification more than once.

What webhooks include

What your system needs to trust every notification and not miss any.

Signed requests

Every notification is signed. Your system verifies the signature and discards anything that doesn't come from Factura Digital.

Retries

If your server is down or responds with an error, the notification is sent again.

No polling

Your system doesn't have to ask the API for changes every few minutes: the notification arrives when the event happens.

Any language

You receive a request at the URL you choose and process it with the language and server you already use.

Frequently asked questions

Any other question about the integration?

Which events can I receive?

Notifications when a CFDI is stamped, when a CFDI is cancelled and when a payment is recorded.

How do I know the notification comes from Factura Digital?

Every notification is signed. Your system verifies the signature before processing it and discards anything that doesn't match. The documentation explains how to verify it.

What happens if my server doesn't respond?

The notification is retried. It's a good idea for your system to respond quickly, process the notification afterwards and be ready to receive the same notification more than once.

Do I need webhooks to use the API?

No. When you stamp through the API, the response already includes the UUID, the XML and the PDF link. Webhooks tell you about what happens later or outside your system, like a cancellation or a recorded payment.

Do they cost extra?

No. Webhooks are part of API v5, which is included: you pay for folios, not the API.

Can you help me set them up?

Yes. Message us on WhatsApp at +52 81 2044 5452 and a person from our team will help you.

Connect your system with API v5.

Create your account with 10 free folios, no card required. The API, the sandbox and webhooks are included: you pay for folios.