결정권은 사용자에게 있는 호스팅 신원 확인

확인 항목과 신호

호스팅 흐름은 검토자를 위한 확인 결과를 제공합니다. 결과는 검토에 참고하는 신호입니다. 결과를 자동으로 결정하지 않으며 사기를 반드시 차단하지도 않습니다.

개발자 안내

아래 내용은 모두 서버에서 사용하는 일반 HTTPS 방식입니다. 자세한 내용은 문서를 참고하세요.

인증 시작 방법 3가지

• 서버에서 호스팅 세션 생성. 서버에서 API로 링크를 생성하고 Noxtica가 페이지를 호스팅합니다.
• Backoffice에서 초대. 조직 담당자가 코드 없이 Backoffice에서 링크를 생성합니다.
• 서버에서 직접 API 사용. 호스팅 링크를 사용하지 않는 서버 간 경로입니다. 현재는 자체 화면에서 확인용 문서를 캡처할 수 없으므로 고객이 문서를 캡처해야 한다면 호스팅 세션을 사용하세요.

세션 생성

identity 권한이 있는 서버 키로 인증하세요. 키는 서버에 보관하세요. 재시도로 세션이 중복 생성되지 않도록 Idempotency-Key를 전송하세요.

curl -sS https://collect.noxtica.com/v1/kyc/sessions \
  -H "Authorization: Bearer $NOXTICA_SERVER_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"subjectRef":"cust_example","returnUrl":"https://merchant.example.com/verification/return"}'

응답

링크는 이 응답에서 한 번만 반환됩니다. 비밀 정보로 취급하고 로그에 남기지 마세요. 만료 시각은 에포크 밀리초 단위입니다.

{
  "ok": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "url": "https://verify.noxtica.com/s/EXAMPLE_TOKEN",
  "expiresAt": 1790848845000,
  "domainId": null,
  "requestId": "req_example"
}

상태 확인

생성한 세션은 만료된 경우에도 항상 200을 반환합니다. 간격을 점차 늘려 폴링하고 최종 상태에 도달하면 중단하세요.

GET https://collect.noxtica.com/v1/kyc/sessions/00000000-0000-4000-8000-000000000001
Authorization: Bearer $NOXTICA_SERVER_KEY

Webhook 이벤트

이벤트는 Backoffice에 등록한 엔드포인트로 서명된 HTTPS 요청을 전달합니다. 이벤트는 알림이며 결정이 아닙니다.

이벤트 예시

합성 값만 사용한 예시입니다. 이벤트에는 고객 참조 정보가 포함되지 않습니다. 세션 ID로 이벤트와 고객을 연결하세요.

{
  "id": "00000000-0000-4000-8000-000000000001:endpoint_example",
  "type": "kyc.session.completed",
  "created_at": 1790762445000,
  "tenant_id": "tenant_example",
  "data": {
    "schemaVersion": "1",
    "sessionId": "00000000-0000-4000-8000-000000000001",
    "status": "completed",
    "verificationId": "verification_example",
    "reasonCodes": ["provider_manual_review"],
    "occurredAt": 1790762445000,
    "deliveryId": "00000000-0000-4000-8000-000000000001:endpoint_example"
  }
}

모든 전달 검증

• 각 요청에는 X-Noxtica-Signature, X-Noxtica-Timestamp, X-Noxtica-Event 및 X-Noxtica-Delivery 헤더가 포함됩니다.
• 서명은 타임스탬프, 마침표, 원본 요청 본문을 대상으로 한 HMAC-SHA256입니다. 본문을 파싱하기 전에 서명을 검증하고, 허용할 타임스탬프 오차 범위는 직접 설정하세요.
• 전달은 최소 한 번 보장되며 순서는 고정되지 않습니다. X-Noxtica-Delivery로 중복을 걸러낸 다음 조치하기 전에 세션 상태를 확인하세요.

SDK는 필요하지 않습니다. 문서에서 curl, Node.js 및 Python 예제를 확인할 수 있습니다.

문서에서 자세히 알아보기

• 신원 인증 연동
• 이벤트 및 웹훅
• 서버 API 레퍼런스: KYC
• 초대 및 호스팅 페이지 설정
• 직접 API
• 생체 확인 및 PAD 정책
• FAQ 및 문제 해결
• Backoffice 운영

자주 묻는 질문

관련 페이지

• 호스팅형 인증 경험 살펴보기
• 가격
• 기업 및 가맹점 인증(KYB 및 KYM)
• 인증 데이터: 저장, 접근 및 삭제
• 개인정보 처리방침
• 보안