본문으로 건너뛰기

6개의 게시물개의 게시물이 "webhooks" 태그를 포함

모든 태그 보기

연령 확인 결과에 공급업체가 표시됩니다

이제 Verification.Result 웹훅과 GET /age-verification/get-status가 확인 메서드를 실행한 공급업체를 나타내는 provider를 반환합니다.

새로운 기능

  • 웹훅과 엔드포인트 모두에 provider. method가 있으면 항상 함께 제공되므로, 완료된 확인이 어느 공급업체에서 나온 결과인지 알 수 있습니다.
  • 메서드만으로 공급업체가 정해지지는 않습니다. age-estimation-scan은 여러 벤더가 제공하며, 결제가 확인을 대신한 경우 credit-card에는 기록상 판매자(merchant of record)가 담깁니다. provider는 로깅과 분석에 사용하고, 액세스 제어 결정에는 사용하지 마세요.
  • 그 외에는 달라지지 않습니다. 다른 필드의 형식과 존재 규칙은 그대로입니다.

문서

보호자 이메일 주소 변경을 알리는 새 웹훅

보호자는 k-ID 계정의 이메일 주소를 변경할 수 있으며, 새로운 Session.ApproverEmailUpdate 웹훅이 그 시점을 프로덕트에 알려 줍니다.

새로운 기능

  • Session.ApproverEmailUpdate. 보호자가 이메일 변경을 확정할 때 자녀 세션마다 한 번씩 발생하므로, 해당 플레이어에 대해 저장해 둔 보호자 이메일 주소를 서버에서 갱신할 수 있습니다. 페이로드에는 id(세션), productId, oldEmail, newEmail이 담깁니다.
  • 세션은 그 외에는 달라지지 않습니다. ACTIVE 상태를 유지하고 동일한 sessionId와 권한을 그대로 가지며, 자녀는 중단 없이 계속 이용할 수 있습니다. 플레이어를 연령 확인이나 동의 절차로 되돌려 보내지 마세요.
  • 활성 세션이 있는 자녀만 해당됩니다. 귀사 프로덕트에 활성 세션이 없는 자녀는 옮길 대상이 없으므로 이벤트가 발생하지 않습니다. 그 자녀가 이후에 세션을 갖게 되면, 그 세션은 새 주소를 기준으로 생성됩니다.
  • 엔드포인트별로 구독해야 합니다. Compliance Studio에서 해당 프로덕트의 Developer Settings 페이지에 들어가 웹훅 엔드포인트에 Session.ApproverEmailUpdate를 선택하세요. 선택하지 않으면 k-ID는 전송을 시도하지도, 오류를 반환하지도 않고 이벤트를 폐기합니다. 이 항목은 조직에서 보호자 이메일 변경이 활성화된 경우에만 목록에 표시됩니다.

문서

트랜잭션 및 결제 기반 확인 가이드

트랜잭션과 결제 기반 확인이 이제 개발자 허브에 완전히 문서화되었습니다.

새로운 기능

  • 트랜잭션. 제품은 자녀의 구매를 k-ID에 보고하며, k-ID는 이를 연결된 부모에게 Family Connect의 자녀별 구매 화면과 정기 활동 다이제스트에 표시합니다. 청구 전에 부모가 개입하기를 원하는 경우, 구매 승인 요청이 부모에게 먼저 승인을 요청하고 결과는 Transaction.PurchaseApprovalResult 웹훅으로 도착합니다. 두 부분 모두 Compliance Studio에서 제품별로 구성합니다.
  • 결제 기반 확인. 완료된 카드 결제가 부모 동의 단계를 대신할 수 있으며, 신용카드 확인 방법을 일대일로 그대로 따릅니다. 즉, 세션에 대해 해당 방법이 활성화된 곳에서 정확히 인정되고, 신용카드 자금만 인정되며, 그 외의 모든 곳에서는 부모가 변경 없이 표준 검증된 부모 동의 흐름을 완료합니다.

문서

Verified Parent Linking, 스크린 타임, 활동 수집 가이드

세 가지 부모 관리 기능이 이제 개발자 허브에 완전히 문서화되었습니다. Verified Parent Linking, 스크린 타임, 활동 수집입니다.

새로운 기능

  • Verified Parent Linking (VPL). 플레이어는 자신의 부모를 제품에 초대할 수 있습니다. 부모가 본인 인증을 완료하면 해당 플레이어의 컨트롤(예: 스크린 타임)을 보고 설정할 수 있습니다. VPL은 게이트가 아니라 링크입니다. 아무것도 차단되지 않으며, 부모가 수락하든 안 하든 제품은 계속 작동합니다. Session.Unlink 웹훅이 어느 한쪽이 연결을 해제했을 때 이를 알려줍니다. VPL은 개발자 조직 단위로 활성화됩니다.
  • 스크린 타임. 부모는 Family Connect에서 자녀의 일일 한도, 조용한 시간, 휴식 알림을 설정합니다. 제품은 사용 현황을 보고하고 k-ID가 반환하는 판정을 따릅니다. k-ID는 규칙을 보유하고, 자녀별·하루별로 사용 시간을 세며, 일정을 평가합니다. 각 한도에 앞서 경고 이벤트가 도착하므로 플레이어가 저장 지점에 도달할 수 있으며, 자녀는 스크린 타임 예외를 요청하여 더 많은 시간을 요청할 수 있습니다.
  • 활동 수집. 제품은 Compliance Studio에서 제품별로 선언한 활동 유형에 대해 레코드를 푸시하여 자녀가 무엇을 했는지 보고합니다. k-ID는 이러한 레코드를 저장하고 집계하여 Family Connect에서 신뢰할 수 있는 성인이 읽는 화면(정기 다이제스트 이메일 포함)에 반영합니다. 활동은 수신 전용입니다.

문서

FAIL 상태 Webhook 이벤트에 ageCategory가 포함되도록 업데이트되었습니다

연령 데이터가 사용 가능한 경우 Verification.Result Webhook 이벤트의 FAIL 상태 이벤트에 ageCategory 필드가 포함되도록 업데이트했습니다.

새로운 기능

FAIL 상태 이벤트의 ageCategory

ageCategory 필드는 다음 조건을 만족할 때 Verification.Result Webhook 이벤트의 FAIL 상태에 포함되도록 업데이트되었습니다:

  • failureReasonage-criteria-not-met
  • 연령 데이터가 사용 가능함 (age.lowage.high 모두 존재)

이를 통해 연령 기준을 충족하지 않아 검증이 실패한 경우에도 사용자의 연령 카테고리에 대한 더 완전한 정보를 제공하여 명확한 액세스 제어 경계를 유지하면서 더 나은 분석 및 로깅을 가능하게 합니다.

문서 업데이트

Verification.Result 문서가 이 변경 사항을 반영하도록 업데이트되었습니다:

  • 필드 테이블: FAIL 상태에서 ageCategory가 존재하는 시기를 명확히 하기 위해 설명 업데이트
  • 주요 차이점 테이블: Webhook 이벤트와 API 엔드포인트에서 ageCategory가 존재하는 시기 명확화
  • FAIL 상태 필드 존재 규칙: 특정 조건에서 ageCategory를 "때때로 포함됨"으로 표시하도록 업데이트
  • 전체 필드 매트릭스: Webhook의 FAIL 상태에서 ageCategory를 "sometimes²"로 표시하도록 업데이트
  • 페이로드 예시: 새로운 동작을 보여주기 위해 FAIL 상태 예시에 ageCategory 추가
  • 구현 체크리스트: FAIL 상태에서 ageCategory 처리에 대한 가이드 업데이트
  • 구현 참고 사항: PASS 및 FAIL 상태 모두에서 ageCategory의 동작 명확화

중요한 참고 사항

  • 액세스 제어: FAIL 상태 이벤트에 ageCategory가 존재하는 경우에도 액세스 제어 결정에 절대 사용하지 마세요. 액세스를 결정하려면 항상 status 필드를 사용하세요.
  • 일관성: 이 업데이트는 Webhook 이벤트와 API 엔드포인트 응답 모두에 적용됩니다
  • 언어 지원: 모든 언어 버전(영어, 일본어, 간체 중국어, 한국어)이 업데이트되었습니다

다음 단계

  • 업데이트된 Verification.Result 문서를 검토하세요
  • 필요한 경우 FAIL 상태 이벤트에서 ageCategory를 처리하도록 통합을 업데이트하세요
  • 기억하세요: 상태가 FAIL인 경우 필드가 존재하더라도 액세스 제어에 ageCategory를 사용하지 마세요. 분석, 로깅 또는 정보 제공 목적으로만 사용하세요.

엣지 케이스 처리 예제

연령 확인 가이드에 포괄적인 엣지 케이스 처리 예제를 추가하고 필드 존재 규칙을 명확히 하기 위해 확인 이벤트 계약을 업데이트했습니다.

새로운 기능

엣지 케이스 처리 예제

워터폴 플로우 가이드에 확인 엣지 케이스를 처리하기 위한 상세한 코드 예제가 포함되었습니다. 각 예제는 잘못된 처리 패턴과 올바른 처리 패턴을 모두 보여줍니다.

새로운 예제에는 다음이 포함됩니다:

  • 부분적 시도 (최대 시도 횟수 초과): 사용자가 확정적인 연령 결정 없이 모든 확인 시도를 소진한 경우 max-attempts-exceeded 실패 이유의 적절한 처리
  • 의심스러운 활동 감지: 적절한 속도 제한 및 보안 조치를 포함한 fraudulent-activity-detected 실패 이유의 보안 중심 처리
  • 완전한 엣지 케이스 핸들러: 모든 패턴을 함께 보여주는 포괄적인 TypeScript 예제

모든 예제는 완전한 필드 존재 규칙에 대해 확인 이벤트 계약에 직접 연결됩니다.

확인 이벤트 계약 업데이트

확인 이벤트 계약이 필드 존재 규칙을 명확히 하기 위해 업데이트되었습니다:

  • ageageCategory는 PASS 상태일 때 항상 존재: PASS를 초래하는 모든 확인 방법은 연령 정보와 연령 카테고리를 모두 제공합니다. PASS 상태 결과를 처리할 때 조건부 검사 없이 이러한 필드에 안전하게 액세스할 수 있습니다.
  • 연령 범위 명확화: 확인 방법에서 정확한 연령이 제공되지 않을 때 age.low는 확인에 필요한 임계값 최소 연령이 되고 age.high는 100이 됩니다.

업데이트된 문서