API de Verificació del Registre Fiscal del Perú (SUNAT) (CA)

Incorporar usuaris al Perú significa confirmar que són qui diuen ser. Es valida la informació d'entrada respecte a la SUNAT. 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ó del Registre Fiscal del Perú (SUNAT) tanca aquesta bretxa comprovant les dades amb la SUNAT. Aquesta guia explica què fa la comprovació, els detalls tècnics exactes i com integrar-la en minuts.

Punts clau:

• Què comprova — La Verificació del Registre Fiscal del Perú (SUNAT) valida la identificació fiscal amb la SUNAT.
• Què obtens — un match_type normalitzat més resultats a nivell de camp que pots encaminar directament a la lògica d'aprovació / revisió / rebuig.
• Per què és important — La validació de l'identificador fiscal vincula un sol·licitant a una identitat fiscal verificable, reduint el frau d'identitat sintètica i de primera part.
• Com utilitzar-lo — un POST a l'endpoint de validació de bases de dades de Didit, o un mòdul de flux de treball sense codi. 1,79 $ per consulta concloent, resultats en segons.

Què valida la Verificació del Registre Fiscal del Perú (SUNAT)

Valida les dades d'entrada amb la SUNAT. Didit ho exposa a través d'un únic endpoint perquè pugueu verificar les dades enviades amb l'autoritat fiscal nacional i rebre un resultat estructurat i normalitzat, no un abocament de registre en brut que hagis de processar tu mateix.

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 validació de l'identificador fiscal vincula un sol·licitant a una identitat fiscal verificable, reduint el frau d'identitat sintètica i de primera part.

Per a les empreses regulades al Perú —fintechs, plataformes de cripto, prestadors, mercats i operadors de jocs— la comprovació contra 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 un únic POST — no cal 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 alfa-3. Utilitzeu PER.
services	string	Sí	Identificador de servei. Utilitzeu per_tax_registration.
first_name	string	Sí	Nom.
last_name	string	Sí	Cognom.
date_of_birth	string	Sí	Data de naixement.
personal_number	string	Sí	Número personal.

Exemple de sol·licitud

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

Exemple de resposta (coincidència concloent)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "PER",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "per_tax_registration",
      "service_name": "Peru Tax Registration (SUNAT)",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "full_name": "John Doe",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "name_match_score": "1.000",
        "verifications": {
          "date_of_birth": true,
          "full_name": true,
          "identification_number": true
        }
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Rendiment i facturació

• Latència: normalment un parell de segons.
• Cost: 1,79 $ per consulta concloent. Se us facturarà només 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 amb la infraestructura de Didit amb un objectiu de temps d'activitat trimestral del 99,9%.

Casos d'ús

• Fintech i neobancs — confirma un titular de compte real i verificable abans d'obrir una cartera o estendre crèdit al Perú.
• Cripto i Web3 — compleix els requisits d'incorporació de VASP amb una prova d'identitat de font autoritzada.
• Préstecs — redueix el frau d'identitat sintètica i de primera part amb dades verificades per la font.
• Mercats i plataformes gig — verifica els usuaris amb dades autoritzades, no només un formulari autoinformat.
• iGaming — satisfà les comprovacions d'identitat i elegibilitat per als jugadors del Perú amb un rastre auditable.

Com integrar amb Didit

Podeu executar la Verificació del Registre Fiscal del Perú (SUNAT) de dues maneres:

1. Flux de treball sense codi. A la Consola d'Empreses de Didit, obriu el Creador de Fluxos de Treball, afegiu el mòdul Validació de Base de Dades, seleccioneu Perú → Verificació del Registre Fiscal del Perú (SUNAT) i activeu-lo. Els usuaris coincidents s'encaminen automàticament, sense necessitat d'enginyeria.
2. API directa. Truqueu a l'endpoint /v3/database-validation/ que es mostra a dalt amb services=per_tax_registration. 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 d'extrem a extrem abans de pagar per una sola consulta.

Preguntes freqüents

Què confirma la comprovació de la Verificació del Registre Fiscal del Perú (SUNAT)?

Valida les dades enviades amb la SUNAT i retorna un resultat de coincidència normalitzat, de manera que sàpigues si la identificació fiscal existeix 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.

Què tan ràpida és 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 un únic POST HTTPS a un endpoint. També podeu connectar-la a un flux de treball sense codi a la Consola d'Empreses.

Llestos per començar?

Valida la teva primera identificació fiscal del Perú avui mateix.

• Llegeix la referència de l'API: Verificació del Registre Fiscal del Perú (SUNAT)
• Consulta totes les validacions de bases de dades: Preus i cobertura de la validació de bases de dades
• Comença a construir: Crea un compte gratuït de Didit — 500 verificacions al mes, gratis.