주문 상태 추적
주의
SDK를 사용하면 애플리케이션의 클라이언트 측에서 주문 상태를 추적할 수 있습니다. 다만 애플리케이션의 백엔드에서 주문 정보를 수신하도록 결제 웹훅 핸들러를 설정하는 것이 좋습니다. 이렇게 하면 완료된 구매에 대한 추가 유효성 검사를 구현할 수 있습니다.
- 애플리케이션 UI에 주문 상태 표시
- 결제를 성공적으로 진행한 후 사용자의 잔액 적립
- 결제를 성공적으로 진행한 후 구매한 아이템 제공
주문 추적 논리는 다음 SDK 메소드에 포함되어 있습니다.
Cart.Purchase
- 장바구니 구매에 사용Cart.PurchaseFreeCart
- 장바구니로 무료 아이템을 구매할 때 사용Catalog.Purchase
- 원클릭으로 아이템을 구매할 때 사용Catalog.PurchaseForVirtualCurrency
- 인게임 재화로 아이템을 구매할 때 사용Catalog.PurchaseFreeItem
- 원클릭으로 무료 아이템을 구매할 때 사용
SDK 참조 문서
SDK 메소드 및 해당 매개변수에 대해 알아봅니다.
성공적인 구매를 처리하려면 onSuccess
매개변수에서 주문이 done
상태로 전환될 때 호출되는 함수만 전달하면 됩니다.
구매 메소드는 주문 상태를 추적하는 여러 메소드를 캡슐화합니다. 메커니즘은 애플리케이션이 구축된 플랫폼에 따라 다릅니다.
- WebGL 빌드의 경우 결제 인터페이스 위젯의
postMessage
이벤트를 기반으로 추적이 이루어집니다. 페이 스테이션 위젯이 주문 상태가done
또는cancel
로 변경되었다는 메시지를 보내면 추적이 중지됩니다.
- 다른 플랫폼용 빌드에서는 추적에서 간단한 HTTP 요청(짧은 폴링)과 WebSocket 요청을 사용합니다. 추적은 다음 알고리즘에 따라 수행됩니다.
- 웹 소켓이 연결됐습니다.
- 주문 상태가 5분 이내에
done
또는cancel
로 변경되지 않으면 웹 소켓 연결이 종료됩니다. 주문 상태가done
또는cancel
로 변경되면 추적이 중지됩니다. - 주문 상태 추적이 짧은 폴링으로 계속 이어집니다. 간단한 HTTP 주문 상태 요청은 3초에 한 번씩 전송됩니다. 다음의 경우 추적이 중지됩니다.
- 주문 상태가
done
또는cancel
로 변경된 경우 - 주문 상태가 10분 이내에
done
또는cancel
로 변경되지 않은 경우
- 주문 상태가
알림
웹 소켓 연결에 실패하면 짧은 폴링을 사용하여 주문 상태를 추적합니다.
onSuccess
콜백 함수에 전달되는 주문 콘텐츠 데이터 처리를 구현할 수도 있습니다.이 기사가 도움이 되었나요?
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.유용한 링크
마지막 업데이트: 2024년 1월 22일오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.