본문으로 건너뛰기

트랜잭션

트랜잭션은 부모가 자녀가 연결된 앱에서 무엇을 구매하는지 보고 관리할 수 있게 하는 기능입니다. 제품은 구매를 k-ID에 보고하고, 청구 전에 부모가 개입하기를 원하는 경우 먼저 부모의 승인을 요청합니다. k-ID는 구매를 기록하고, 승인 상태를 보관하며, 부모에게 알리고, 결과를 제품에 알려줍니다. 돈이 실제로 어떻게 처리되는지는 여전히 제품이 결정합니다.

구매는 자녀별로 세션 단위로 보고되므로, 부모는 기기별이나 영수증별 화면이 아니라 자녀가 제품에서 구매한 내역을 하나의 연속된 기록으로 읽습니다.

부모가 얻는 것​

트랜잭션 아래에는 두 가지 기능이 있으며, 제품은 각각을 단독으로 사용할 수 있습니다.

  • 구매 가시성. 제품이 완료된 구매를 보고하면 k-ID는 이를 연결된 부모에게 Family Connect의 자녀별 구매 화면과 정기 활동 다이제스트의 항목으로 표시합니다. 이것은 보고입니다. 구매를 차단하거나 누군가에게 조치를 요구하지 않습니다.
  • 구매 승인. 특정 청구 전에 제품은 부모에게 승인을 요청합니다. k-ID는 요청을 보관하고, 부모에게 알리며, 부모의 답변을 웹훅으로 반환합니다. 이것이 부모를 구매 앞에 세우는 부분입니다.

두 기능은 서로 독립적입니다. 제품은 승인을 요청하지 않고 구매를 보고할 수도, 일부 구매에 대해서만 승인을 요청하고 모든 구매를 보고할 수도, 승인만 단독으로 사용할 수도 있습니다.

책임의 경계​

k-ID는 구매를 기록하고, 승인 요청을 보관하며, 부모에게 알리고, 결과를 보고합니다. 구매가 무엇인지, 청구할지, 언제 요청할지는 제품이 결정합니다.

k-ID는 결제를 처리하거나 돈을 옮기거나 청구를 차단하지 않습니다. k-ID는 트랜잭션을 직접 목격하지 않습니다. 부모에게 구매 승인을 요청하면 k-ID는 부모의 결정을 반환합니다. 답변이 없거나 거부된 요청이 청구를 막는지는 제품에서 시행됩니다.

구매 보고​

각 구매는 평면적인 레코드입니다. 부모에게 그대로 표시되는 제목과 선택적 설명, 통화의 최소 단위로 표현된 amount, currency, 완료된 시점의 timestamp, 부모가 구매를 관리할 수 있는 선택적 url(예: 구독 취소), 그리고 successful 또는 failed의 status입니다.

failed 청구를 보고하는 것은 중요합니다. 이를 통해 부모는 실제로 처리된 구매와 시도되었지만 이루어지지 않은 구매를 구분할 수 있습니다. 구독 갱신은 청구될 때마다 하나의 구매로 보고됩니다.

구매는 또한 신뢰할 수 있는 성인이 읽는 활동에도 반영되므로, 금액이 정기 다이제스트와 구매 화면에 표시됩니다. 엔드포인트와 이벤트별 결과 형태는 트랜잭션 통합 가이드를 참조하세요.

부모에게 구매 승인 요청하기​

청구 전에 부모의 결정을 원할 때, 제품은 세션에 대해 승인 요청을 엽니다. k-ID가 부모에게 알리면 부모는 Family Connect에서 승인하거나 거부하고, 결과는 approved, denied, expired 중 하나를 담은 Transaction.PurchaseApprovalResult 웹훅으로 도착합니다.

  • 청구하기 전에 요청하세요. 요청은 구매 뒤에 남는 영수증이 아니라 구매 앞에 두는 게이트입니다. 승인이 도착한 뒤에만 구매를 완료하세요.
  • 답변이 없는 요청은 24시간 후에 만료됩니다. 만료는 실패가 아니라 동일한 웹훅으로 보고되는 정상적인 결과입니다. 플레이어에게 구매를 다시 제안할 수 있습니다.
  • 요청에는 기한이 담겨 있습니다. 웹훅을 무한정 기다리는 대신, 요청이 반환하는 expiresAt을 그 이후로는 답변이 올 수 없는 시점으로 취급하세요.

요청과 웹훅 형태는 승인 요청하기를 참조하세요.

트랜잭션과 결제 기반 확인​

완료된 카드 결제는 관할권이 인정하는 경우 부모 동의를 대신할 수도 있습니다. 이것이 결제 기반 확인이며, 동일한 트랜잭션 구성 위에서 동작하는 별도의 기능입니다. 이것은 가시성이 아니라 동의에 관한 것이며, 별도의 페이지에서 다룹니다.

트랜잭션 활성화​

트랜잭션은 기본적으로 꺼져 있으며 Compliance Studio에서 제품별로 활성화합니다. 켜기 전까지 트랜잭션 엔드포인트는 FEATURE_DISABLED를 반환합니다. 설정 단계는 트랜잭션 통합 가이드를 참조하세요.

다음 단계​