엔터프라이즈급 Unity용 SDK / 주문 상태 추적
  문서로 돌아가기

엔터프라이즈급 Unity용 SDK

주문 상태 추적

주의
SDK를 사용하면 애플리케이션의 클라이언트 측에서 주문 상태를 추적할 수 있습니다. 다만 애플리케이션의 백엔드에서 주문 정보를 수신하도록 결제 웹훅 핸들러를 설정하는 것이 좋습니다. 이렇게 하면 완료된 구매에 대한 추가 유효성 검사를 구현할 수 있습니다.
사용자가 구매를 진행한 후 애플리케이션에서 수행할 수 있는 작업:
  • 애플리케이션 UI에 주문 상태 표시
  • 결제를 성공적으로 진행한 후 사용자의 잔액 적립
  • 결제를 성공적으로 진행한 후 구매한 아이템 제공
주문 추적 논리는 다음 SDK 메소드에 포함되어 있습니다.
  • Cart.Purchase - 장바구니 구매에 사용
  • Cart.PurchaseFreeCart - 장바구니로 무료 아이템을 구매할 때 사용
  • Catalog.Purchase - 원클릭으로 아이템을 구매할 때 사용
  • Catalog.PurchaseForVirtualCurrency - 인게임 재화로 아이템을 구매할 때 사용
  • Catalog.PurchaseFreeItem - 원클릭으로 무료 아이템을 구매할 때 사용
SDK 참조 문서
SDK 메소드 및 해당 매개변수에 대해 알아봅니다.

성공적인 구매를 처리하려면 onSuccess 매개변수에서 주문이 done 상태로 전환될 때 호출되는 함수만 전달하면 됩니다.

구매 메소드는 주문 상태를 추적하는 여러 메소드를 캡슐화합니다. 메커니즘은 애플리케이션이 구축된 플랫폼에 따라 다릅니다.

  • WebGL 빌드의 경우 결제 인터페이스 위젯의 postMessage 이벤트를 기반으로 추적이 이루어집니다. 페이 스테이션 위젯이 주문 상태가 done 또는 cancel로 변경되었다는 메시지를 보내면 추적이 중지됩니다.

  • 다른 플랫폼용 빌드에서는 추적에서 간단한 HTTP 요청(짧은 폴링)과 WebSocket 요청을 사용합니다. 추적은 다음 알고리즘에 따라 수행됩니다.

    1. 웹 소켓이 연결됐습니다.
    2. 주문 상태가 5분 이내에 done 또는 cancel로 변경되지 않으면 웹 소켓 연결이 종료됩니다. 주문 상태가 done 또는 cancel로 변경되면 추적이 중지됩니다.
    3. 주문 상태 추적이 짧은 폴링으로 계속 이어집니다. 간단한 HTTP 주문 상태 요청은 3초에 한 번씩 전송됩니다. 다음의 경우 추적이 중지됩니다.
      • 주문 상태가 done 또는 cancel로 변경된 경우
      • 주문 상태가 10분 이내에 done 또는 cancel로 변경되지 않은 경우
알림
웹 소켓 연결에 실패하면 짧은 폴링을 사용하여 주문 상태를 추적합니다.
구매 메소드의 onSuccess 콜백 함수에 전달되는 주문 콘텐츠 데이터 처리를 구현할 수도 있습니다.
이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.

유용한 링크

마지막 업데이트: 2024년 1월 22일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

문제 보고
콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
후속 조치를 위해 이메일을 제공해 주세요
의견을 보내 주셔서 감사드립니다!