API de Verificació de Consumidors a Espanya (CA)

Incorporar usuaris a Espanya significa confirmar que són qui diuen ser. Es verifiquen les dades d'entrada a una base de dades de generació de leads. Un document o un detall introduït només demostra que les dades existeixen, no que siguin genuïnes o que pertanyin a la persona que teniu al davant. La Verificació de Consumidors a Espanya tanca aquesta bretxa comprovant les dades amb fonts autoritzades de dades residencials i de consum. Aquesta guia explica què fa la comprovació, els detalls tècnics exactes i com integrar-la en minuts.

Punts clau:

• Què comprova — La Verificació de Consumidors a Espanya valida les dades d'adreces i residencials amb fonts autoritzades de dades residencials i de consum.
• Què s'obté — un match_type normalitzat més resultats a nivell de camp que podeu encaminar directament a la lògica d'aprovació / revisió / rebuig.
• Per què és important — La verificació d'adreces amb dades autoritzades confirma que un sol·licitant viu realment on diu, un senyal fonamental contra el frau i per al compliment.
• Com utilitzar-lo — una POST a l'endpoint de validació de bases de dades de Didit, o un mòdul de flux de treball sense codi. 0,08 $ per consulta concloent, resultats en segons.

Què valida la Verificació de Consumidors a Espanya

Verifica les dades d'entrada a una base de dades de generació de leads. Didit ho exposa a través d'un únic endpoint perquè pugueu verificar les dades enviades amb fonts autoritzades de dades residencials i de consum i rebre un resultat estructurat i normalitzat, no un bolcat de registre brut que hàgiu de processar vosaltres mateixos.

Una resposta concloent retorna les source_data coincidents i un bloc de validation per camp, de manera que el vostre motor de risc obté un veredicte clar i llegible per màquina.

Per què és important

La verificació d'adreces amb dades autoritzades confirma que un sol·licitant viu realment on diu, un senyal fonamental contra el frau i per al compliment.

Per a empreses regulades a Espanya —fintechs, plataformes de criptoactius, prestadors, marketplaces i operadors de jocs—, la comprovació amb una font autoritzada produeix un registre defensable i auditable que la identitat es va confirmar a la font, no només es va capturar d'un formulari o una foto.

Detalls tècnics

Didit exposa aquest servei a través de l'endpoint unificat de validació de bases de dades. És una única POST — no es requereix SDK.

Endpoint

POST /v3/database-validation/

Paràmetres de la sol·licitud

Paràmetre	Tipus	Requerit	Descripció
issuing_state	string	Sí	Codi de país ISO 3166-1 alpha-3. Utilitzeu ESP.
services	string	Sí	Identificador del servei. Utilitzeu esp_consumer.
first_name	string	Sí	Nom.
last_name	string	Sí	Cognom.
date_of_birth	string	Sí	Data de naixement.
address	string	No	Adreça (comprovació creuada opcional).
phone	string	No	Telèfon (comprovació creuada opcional).
email	string	No	Correu electrònic (comprovació creuada opcional).

Exemple de sol·licitud

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ESP" \
  -F "services=esp_consumer" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01"

Exemple de resposta (coincidència concloent)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "ESP",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "esp_consumer",
      "service_name": "Spain Consumer",
      "source_data": {
        "address": "123 Sample Street",
        "address_match_score": "1.000",
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "full_name": "John Doe",
        "last_name": "Doe",
        "name_match_score": "1.000",
        "street": "sample_value",
        "verifications": {
          "address": true,
          "date_of_birth": true,
          "full_name": true
        }
      },
      "validation": {
        "address": "full_match",
        "date_of_birth": "full_match",
        "full_name": "full_match"
      }
    }
  ]
}

Rendiment i facturació

• Latència: normalment un parell de segons.
• Cost: 0,08 $ per consulta concloent. Només se us factura pels resultats concloents — no hi ha càrrec per temps d'inactivitat de la font, camps que falten o rebuigs previs a la font.
• Fiabilitat: funciona a la infraestructura de Didit amb un objectiu de temps d'activitat trimestral del 99,9%.

Casos d'ús

• Fintech i neobancs — confirmeu un titular de compte real i verificable abans d'obrir una cartera o concedir crèdit a Espanya.
• Crypto i Web3 — compliu els requisits d'incorporació de VASP amb una prova d'identitat de font autoritzada.
• Préstecs — reduïu el frau d'identitat sintètica i de primera part amb dades verificades per la font.
• Marketplaces i plataformes de serveis — verifiqueu els usuaris amb dades autoritzades, no només un formulari autoinformat.
• Jocs en línia — compliu les comprovacions d'identitat i elegibilitat per als jugadors espanyols amb un registre auditable.

Com integrar-se amb Didit

Podeu executar la Verificació de Consumidors a Espanya de dues maneres:

1. Flux de treball sense codi. A la Consola Empresarial de Didit, obriu el Creador de Fluxos de Treball, afegiu el mòdul Validació de Base de Dades, seleccioneu Espanya → Verificació de Consumidors a Espanya i activeu-lo. Els usuaris coincidents s'encaminen automàticament — no es requereix enginyeria.
2. API directa. Truqueu a l'endpoint /v3/database-validation/ mostrat anteriorment amb services=esp_consumer. Llegiu match_type i el bloc de validation per camp per impulsar la vostra lògica d'aprovació / revisió / rebuig.

Cada compte de Didit inclou 500 verificacions gratuïtes al mes, de manera que podeu provar el flux complet de principi a fi abans de pagar per una sola consulta.

Preguntes freqüents

Què confirma la comprovació de Verificació de Consumidors a Espanya?

Valida les dades enviades amb fonts autoritzades de dades residencials i de consum i retorna un resultat de coincidència normalitzat, de manera que sabeu si les dades d'adreça i residencials existeixen a la font autoritzada i quins camps van coincidir.

Què passa si la font no està disponible temporalment?

No se us cobrarà. La facturació només s'aplica als resultats concloents — el temps d'inactivitat de la font, els camps que falten i els rebuigs previs a la font són gratuïts.

Quant de temps triga la comprovació?

La validació de la base de dades normalment retorna en un parell de segons, de manera que s'adapta a un flux d'incorporació en temps real.

Necessito un SDK?

No. La comprovació és una única POST HTTPS a un endpoint. També podeu connectar-lo a un flux de treball sense codi a la Consola Empresarial.

Llest per començar?

Valideu la vostra primera adreça i dades residencials a Espanya avui mateix.

• Llegiu la referència de l'API: Verificació de Consumidors a Espanya
• Vegeu totes les validacions de bases de dades: Preus i cobertura de la validació de bases de dades
• Comenceu a construir: Creeu un compte gratuït de Didit — 500 verificacions al mes, gratuïtes.