메인 콘텐츠로 건너뛰기
POST
공식 RENAPER 민사 등록부에서 아르헨티나 DNI를 검증하고, 등록된 사진과 생체 얼굴 대조를 수행합니다. 전체 인구의 100%를 커버합니다. Didit은 이 서비스를 POST /v3/database-validation/을 통해 제공하므로, 제출된 데이터를 공식 출처와 대조하고 정규화된 일치 결과를 받을 수 있습니다. 입력 형식: document_number에는 아르헨티나 DNI(7~8자리, 선택적 M/F 접두사)를 입력합니다.

적용 범위

  • 적용 범위: 100%
  • 국가: 아르헨티나
  • 서비스 ID: arg_renaper
  • 데이터 도메인: 신원
  • 카테고리: 국가 신분증 등록부
RENAPER는 모든 아르헨티나 DNI를 발급하는 등록부이므로, 외국인 거주자에게 발급된 DNI를 포함해 모든 DNI 번호가 등록되어 있습니다. 얼굴 대조는 셀피를 해당 DNI에 대해 RENAPER가 보유한 사진과 비교합니다.

입력값

  • 필수 입력값: document_number, selfie, gender
  • 선택 입력값: first_name, last_name, date_of_birth, vendor_data
  • 동의: 필요하지 않습니다
  • 워크플로 사용 가능 여부: 워크플로에서 사용할 수 있습니다
  • 적용 범위: 100%
  • 요금: 성공한 쿼리당 $0.20

본문 파라미터

string
기본값:"ARG"
필수
이 데이터베이스 서비스의 ISO 3166-1 alpha-3 국가 코드입니다.예시: ARG
string
기본값:"arg_renaper"
필수
이 서비스 ID를 포함하는 배열입니다. 서비스를 고정하면 요청이 정확히 이 데이터베이스로 범위가 제한됩니다.예시: arg_renaper
string
기본값:"11111111"
필수
사용자가 제공했거나 사용자의 문서에서 추출한 문서 번호입니다.예시: 11111111
file
필수
생체 데이터베이스 검증을 위해 업로드할 셀피 이미지 파일입니다. 허용 형식: JPEG, PNG 또는 WebP.예시: @./selfie.jpg
string
기본값:"M"
필수
데이터베이스에서 요구하는 경우 사용하는 성별 값입니다.허용 값: M(남성), F(여성), X(기타 또는 알 수 없음).예시: M
string
검증할 이름입니다.예시: John
string
검증할 성입니다.예시: Doe
string
YYYY-MM-DD 형식의 생년월일입니다.예시: 1990-01-01
string
기본값:"user-1234"
내부 사용자 ID 등 이 사용자를 나타내는 고정된 사용자 참조값입니다. Didit은 이 값을 사용해 단독으로 수행된 검사를 같은 최종 사용자에게 연결하고, 중복 감지 노이즈를 줄입니다.예시: user-1234

입력 규칙 및 검증 참고 사항

  • 아르헨티나 DNI(7~8자리, 선택적 M/F 접두사)
  • document_number는 7~9자여야 합니다.
  • document_number는 [MFmf]?\d{7,8}과 일치해야 합니다.

호출 방법

반환 데이터

source_data에 노출되는 정확한 필드는 등록부가 반환하는 내용에 따라 달라집니다. arg_renaper에 대해 생성된 예시는 현재 다음의 정규화된 형식을 문서화합니다.
  • date_of_birth
  • face_match_score
  • first_name
  • full_name
  • identification_number
  • last_name
  • tax_id
  • tax_id_type

요금 및 SLA

아르헨티나 - DNI 검증(RENAPER) 쿼리는 Didit이 검증 출처로부터 확정적인 결과를 받은 경우에만 과금됩니다.
  • 호출당 가격: $0.20 USD.
  • 과금: 성공한 쿼리당 과금됩니다. 등록부에 연결할 수 없는 경우, 필수 필드가 누락된 경우, 또는 요청이 출처에 도달하기 전에 거부된 경우에는 요금이 부과되지 않습니다.
  • 지연 시간: 일반적인 p95 기준 2초 미만입니다.
  • 가용성: Didit 측 분기당 99.9%입니다. 하위 출처의 가용성은 국가와 데이터셋에 따라 다릅니다.

Puntuación de coincidencia facial

face_match_score es la similitud que calcula RENAPER entre la selfie y la foto registrada para el DNI. Se envía como un número entero de 0 a 100 dentro de una cadena, por ejemplo "92". No es una probabilidad entre 0 y 1. La comprobación devuelve BIOMETRIC_NO_MATCH cuando RENAPER informa de que el rostro no coincide, o cuando la puntuación es inferior a 50. Con 50 o más, el rostro se acepta y, a continuación, el nombre y la fecha de nacimiento registrados se comparan con los datos que enviaste. La foto registrada puede tener varios años de antigüedad, así que una persona real puede obtener una puntuación baja tras un cambio importante en su apariencia. Considera enviar BIOMETRIC_NO_MATCH a revisión manual en lugar de rechazarlo directamente, con las acciones para Partial Match / No Match.

Cuando RENAPER no responde

Si no se puede contactar con RENAPER o responde con un error, el resultado es REGISTRY_UNAVAILABLE: no se comprobó nada sobre la persona y la llamada no se factura. La misma solicitud puede completarse con éxito si la reintentas más tarde. Consulta Códigos de resultado para saber cómo gestionarlo.

Documentos que lee un flujo de verificación (workflow)

Dentro de un flujo, el número de DNI y el género provienen del paso de Verificación de identidad, que lee la tarjeta DNI argentina y el DNI digital. Los residentes extranjeros tienen la misma tarjeta DNI y se verifican de la misma forma. El antiguo DNI en formato libreta no es un documento compatible con la Verificación de identidad, por lo que un usuario que solo tenga ese documento no puede completar ese paso. Aun así, puedes comprobar su número de DNI directamente con POST /v3/database-validation/.

Uso en un flujo

Añade el servicio a un paso de Validación de base de datos después de la Verificación de identidad. Por ejemplo, con POST /v3/workflows/:
Si hay un paso de Prueba de vida antes, RENAPER compara la selfie en directo. Si no lo hay, Didit envía en su lugar el retrato impreso en el documento de identidad, lo que confirma la foto del documento pero no que la persona frente a la cámara sea su titular. Un ID de servicio que el flujo no puede ejecutar se rechaza con un 400 que lo nombra, de modo que el paso nunca se guarda sin la comprobación que solicitaste. Consulta Configuración de funciones del flujo de verificación para ver todos los ajustes de Validación de base de datos.

Seguir leyendo

마지막 수정일 2026년 11월 7일