트랜잭션과 결제 기반 확인이 이제 개발자 허브에 완전히 문서화되었습니다.
Transaction.PurchaseApprovalResult 웹훅으로 도착합니다. 두 부분 모두 Compliance Studio에서 제품별로 구성합니다.세 가지 부모 관리 기능이 이제 개발자 허브에 완전히 문서화되었습니다. Verified Parent Linking, 스크린 타임, 활동 수집입니다.
Session.Unlink 웹훅이 어느 한쪽이 연결을 해제했을 때 이를 알려줍니다. VPL은 개발자 조직 단위로 활성화됩니다./session/delete가 이제 삭제되는 세션에 의존하는 다른 프로덕트를 보호(또는 함께 정리)할 수 있습니다.
POST /session/delete의 essentialDependencies. 어떤 프로덕트가 다른 프로덕트에 *필수(essential)*로 구성된 경우, 지금까지는 해당 세션을 삭제하면 의존하는 프로덕트의 세션이 의존하던 동의 기반을 잃은 채 조용히 남겨졌습니다. 새 필드를 사용하면 기본 취소와 hardDelete 두 경로 모두에서 대신 어떤 동작을 할지 선택할 수 있습니다.block은 의존 프로덕트를 고립시키는 대신 삭제를 거부합니다. 플레이어가 삭제 대상 프로덕트에 의존하는 활성 프로덕트를 아직 보유하고 있는 동안, 호출은 ESSENTIAL_DEPENDENTS_EXIST를 반환하고 의존 프로덕트 ID를 명시합니다. 별도의 활성화가 필요 없습니다.cascade는 의존하는 세션도 삭제한 다음 지정된 세션을 삭제하며, 각 세션마다 자체 웹훅이 발송되고 (하드 삭제의 경우) 자체 삭제 기록이 생성됩니다. 지정하지 않은 세션을 삭제하기 때문에 개발자별 옵트인이며(활성화 없이 전송하면 FEATURE_DISABLED가 반환됩니다), 클라이언트 액세스 토큰이 아닌 서버 측 API 키가 필요합니다.ignore를 전송하면 /session/delete는 지금까지와 정확히 동일하게 동작하며, 앞으로도 항상 그렇습니다. 이는 기본값 변경을 앞둔 단계가 아니라 안정적인 옵트인 기능입니다.이제 이메일 연령 추정만을 방식으로 사용하여 연령 확인을 수행하는 전용 엔드포인트 /age-verification/perform-email-age-estimation가 제공됩니다. 이는 기존 단일 방식 엔드포인트(ID, AgeKey, ConnectID)와 함께 사용할 수 있습니다.
POST /age-verification/perform-email-age-estimation. 자동 방식 선택을 우회하고 이메일 연령 추정만으로 사용자를 확인합니다. 다른 단일 방식 엔드포인트와 동일한 요청 형식(jurisdiction, subject, criteria 및 선택적 options.redirectUrl / options.locale)을 받으며 id, url, shortUrl을 반환합니다. subject.email 필드는 선택 사항입니다. 생략하면 사용자가 호스팅된 확인 페이지에서 이메일을 입력합니다./age-verification/get-status를 폴링하거나 Verification.Result webhook을 처리하세요./session/delete can now permanently erase a session instead of only revoking it.
hardDelete on POST /session/delete. Set to true to permanently delete a player session and its embedded consent, scoped to the calling product. Unlike the default revoke (which is internally retained), this physically removes the record and can't be undone.hardDelete: true without enablement returns FEATURE_DISABLED.hardDelete, or setting it to false, behaves exactly as /session/delete always has: a reversible revoke.FAIL, scoped to that session only (other sessions for the same player are untouched).이제 신용카드만을 방식으로 사용하여 연령 확인을 수행하는 전용 엔드포인트 /age-verification/perform-credit-card-verification가 제공됩니다. 이는 기존 단일 방식 엔드포인트(ID, AgeKey, ConnectID)와 함께 사용할 수 있습니다.
POST /age-verification/perform-credit-card-verification. 자동 방식 선택을 우회하고 신용카드만으로 사용자를 확인합니다. 다른 단일 방식 엔드포인트와 동일한 요청 형식(jurisdiction, subject, criteria 및 선택적 options.redirectUrl / options.locale)을 받으며 id, url, shortUrl을 반환합니다./age-verification/get-status를 폴링하거나 Verification.Result webhook을 처리하세요. 결과는 확인 method로 credit-card를 보고합니다.이제 /age-gate/check는 자동 연령 보증 챌린지가 완료되면 k-ID가 이동할 리디렉션 URL을 받아들입니다. 이는 iframe 기반 결과 핸들러를 사용할 수 없는 최상위 브라우저 핸드오프(예: k-ID로 이동했다가 돌아오는 모바일 webview)를 위한 것입니다.
options.playerAgeAssurance.redirectUrl. /age-gate/check에 http(s) URL 또는 커스텀 스킴 모바일 딥링크(예: myapp://age-gate/return)를 전달합니다. 플레이어가 CHALLENGE_AGE_GATE_AGE_ASSURANCE 흐름을 완료하거나 닫으면, k-ID는 해당 URL에 challengeId, productId, sessionId(PASS인 경우), status(PASS 또는 FAIL)를 쿼리 파라미터로 추가하여 리디렉션합니다. URL의 기존 쿼리 파라미터는 유지됩니다.CHALLENGE_AGE_GATE_AGE_ASSURANCE에만 적용됩니다. CHALLENGE_PARENTAL_CONSENT는 영향을 받지 않으며 계속 신뢰할 수 있는 성인 흐름을 통해 반환됩니다.Challenge.StateChange webhook 또는 /challenge/get-status를 신뢰할 수 있는 정보 원본으로 취급하세요.k-ID API 및 사용자 대상 연령 확인과 보호자 동의 흐름의 기본 속도 제한이 이제 전용 페이지에 문서화되었습니다.
429 Too Many Requests를 반환합니다.429가 표시되지 않습니다).연령 확인 생성 응답(POST /age-verification/perform-access-age-verification 및 기타 perform-* 연령 확인 엔드포인트)에 이제 id, **url**과 함께 **shortUrl**이 포함됩니다.
shortUrl은 전체 url과 동일한 확인 경험으로 리다이렉트하는 더 짧은 링크입니다. 쿼리 문자열이 길어 부적합할 때(예: QR 코드, 사용자가 다른 기기에서 확인을 마치는 경우) 사용하세요.url의 token 쿼리 매개변수에 있습니다. 해당 URL을 임의로 짧게 만들거나 다시 만들지 마세요.shortUrl은 불투명한 문자열로 취급하고, 반환된 그대로 표시·인코딩하세요. 경로나 쿼리 레이아웃은 나중에 바뀔 수 있으므로 고정 형식에 의존하지 마세요.Apple iOS, Google Play, Xbox, Meta Horizon 및 k-ID의 연령 데이터가 k-ID에 어떻게 전달되는지, 연령 게이트를 건너뛸 수 있는 경우, 그리고 검증된 시그널과 검증되지 않은 시그널이 고위험 권한 및 연령 보증과 어떻게 연관되는지 설명하는 플랫폼 연령 시그널에 대한 종단간 문서를 게시했습니다.
POST /age-gate/check에서 플랫폼 시그널 처리 방식, 지원 플랫폼 및 검증된 선언 유형, 검증됨/검증되지 않음 시그널 동작.get-requirements, check, get-default-permissions, session/get, get-platform-age-range, session/upgrade), 유효성 검사, 연령 충돌 및 k-id 시그널 규칙.PlatformAgeSignal 통합 세부 정보를 찾을 위치.verifiedAgeThreshold와 연령 게이트에서 검증된 플랫폼 시그널에 대한 상호 연결된 동작.세션 업그레이드, AgeVerification, platformAgeSignal 설명을 위 문서와 일치하도록 검증된 플랫폼 시그널 표현으로 맞추었습니다.