Referencia de la API

# Verificación masiva

Verifica hasta 5,000 registros de RFC + nombre + CP en una sola ida y vuelta al SAT. Webhook obligatorio.

POST

`/v1/rfc/verify-batch`

Verifica hasta 5,000 registros de RFC + nombre + CP en una sola ida y vuelta al SAT. ~10-15s para todo el lote, por lo que el costo por registro es mínimo al distribuirse. Webhook obligatorio: no hay modo síncrono.

## Cuerpo de la solicitud


| Campo | Tipo | Requerido | Descripción |
| --- | --- | --- | --- |
| `records` | array | Sí | Hasta 5,000 objetos. Cada uno debe contener rfc, name y zip. |
| `webhook_url` | string | Sí | URL a la que se envía vía POST el resultado del lote una vez que el SAT responde. |


## Solicitud de ejemplo

curl

```bash
curl -X POST https://rfccheck.com/v1/rfc/verify-batch \
  -H "x-api-key: rfc_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "records": [
      {"rfc": "ACME010101AAA", "name": "ACME CONSULTORES", "zip": "06600"},
      {"rfc": "JUPL850101AAA", "name": "JUAN PEREZ LOPEZ", "zip": "11000"}
    ],
    "webhook_url": "https://example.com/webhooks/rfc"
  }'
```

## Respuesta (202)

202 Accepted

```json
{
  "status": "processing",
  "message": "Batch verification in progress"
}
```

## Payload del webhook

POST to your webhook_url

```json
{
  "status": 200,
  "body": {
    "count": 2,
    "results": [
      {"rfc": "ACME010101AAA", "name": "ACME CONSULTORES", "zip": "06600", "valid": true, "message": "..."},
      {"rfc": "JUPL850101AAA", "name": "JUAN PEREZ LOPEZ", "zip": "11000", "valid": false, "message": "..."}
    ]
  }
}
```