서버가 없거나 클라이언트 측에서 구매 처리 로직을 구현하는 경우 사용할 수 있는 방법:

1. WebSocket API.
2. 쇼트 폴링.

WebSocket API를 사용하여 클라이언트 측에서 주문 상태 가져오기

이 솔루션은 websockets를 사용하여 주문 상태를 가져옵니다. 이때 주문에 대한 자세한 정보는 가져오지 않습니다. 이 메소드는 클라이언트(예: 웹사이트 또는 모바일 애플리케이션)와 엑솔라 서버 사이에 단 하나의 연결만 생성하므로 클라이언트나 서버에 추가 부하가 발생하지 않아 권장됩니다.

다음 단계를 완료해 주세요.

1. 엑솔라 웹 소켓 서버와 클라이언트가 주문 상태 메시지를 식별할 수 있도록 연결을 생성합니다.

const client = new Centrifuge(
connectionURL,
{
data: {
  user_external_id: user_external_id,
  auth: auth,
  project_id: project_id
}
}
)
connectionURL - wss://ws-store.xsolla.com/connection/websocket
auth - user JWT token

2. 주문 상태에 대한 새 메시지를 받으려면 client.on 함수를 사용하여 이벤트를 구독해 주세요.

client.on('publication', (ctx) => {
   //handle the status
});

3. 실제 연결 설정 트리거:

client.connect()

4. 주문 상태의 변경 사항 기록을 받으려면 API 기록 메소드를 연결합니다.

client.on('subscribed', function (ctx) {
   client.history(ctx.channel, { limit: -1, since: { offset: 0 }, reverse: false }).then(function (resp) {
resp.publications.forEach((ctx) => {
   /handle the status
});

   }, function (err) {
       //handle the status
   });
});

메시지 본문 예시:

{
order_id: 59614241,
status: 'new'
}

다음 주문 상태가 가능합니다.

• New - 주문이 생성되었지만 지불되지 않음
• Paid - 주문 지불 완료
• Done - 주문 전달이 완료됨(모든 영수증 전송 완료, 엑솔라 및 외부 플랫폼 등에서 전달됨)
• Canceled - 주문이 취소되었으며 사용자에게 환불이 완료됨

웹소켓 사용 권장 사항:

• 웹소켓을 통한 응답 대기 시간은 최대 5분입니다.
• 결제 인터페이스를 열 때 연결이 설정되어야 합니다.
• 최종 주문 상태가 Canceled 또는 Done 중 하나로 수신되면 연결이 중단되어야 합니다.
• 웹소켓의 수명이 만료되거나 연결에 문제가 있는 경우 숏폴링을 사용하세요.

  쇼트 폴링

  상태로 전환한 후 주문 아이템에 대한 자세한 정보를 가져오려면 주문 가져오기 API를 호출하세요.

  알림

  정기 주문 상태 폴(주문 상태 및 주문 정보를 수신하는 간단한 HTTP 요청)을 사용합니다. 요청 사이에 권장되는 지연 시간은 3초입니다.

XsollaCatalog.Purchase 메서드에는 주문 상태를 추적하는 여러 가지 방법이 캡슐화되어 있습니다. 추적 메커니즘은 엔터프라이즈급 Unity용 SDK 문서에 자세히 설명되어 있습니다.

또한 주문 상태 및 콘텐츠를 처리할 수 있으며, 이는 구매 방식의 onSuccess 콜백 함수에 전달됩니다.

SDK 사용 시 다음과 같은 방법으로 주문 상태를 추적할 수 있습니다.

• 주문 상태 변경 구독
• 주문 상태 요청

주문 상태 변경 사항 구독

주문 상태 변경 사항을 구독하려면 스토어 라이브러리에서 getOrderStatus SDK 메소드를 사용하여 메소드에 다음 매개 변수를 전달합니다.

• listener - OrderStatusListener 유형의 리스너 개체.
• orderId - 장바구니, 원클릭 구매 또는 인게임 재화 구매 시 받은 매개 변수로서의 주문 ID.

SDK 참조 문서

SDK 메소드 및 해당 매개변수에 대해 알아봅니다.

XStore.getOrderStatus 메소드 호출 예시:

XStore.getOrderStatus(object : OrderStatusListener() {

               override fun  onStatusUpdate(status: OrderResponse.Status) {

                   if(status == OrderResponse.Status.DONE) {

                       Log.d("MainActivity", "Success")

                   }

               }

               override fun  onFailure() {

                   Log.d("MainActivity", "Failure")

               }

           }, orderId)

결제 UI를 열 때 XStore.getOrderStatus 메소드를 호출하는 것이 좋습니다.

구매 메소드는 주문 상태를 추적하는 여러 메소드를 캡슐화합니다. 추적은 다음 알고리즘에 따라 수행됩니다.

1. 웹 소켓 연결이 설정되었습니다.
2. 웹 소켓 연결이 성공적으로 설정되고 주문 상태가 done 또는 cancel로 변경되면 추적이 중지됩니다. 웹 소켓 연결이 실패하거나 응답에 잘못된 데이터가 포함되면 쇼트 폴링을 사용하여 주문 상태를 추적합니다.
3. 주문 상태 추적은 쇼트 폴링을 계속합니다. 간단한 HTTP 주문 상태 요청은 3초마다 한 번씩 전송됩니다. 주문 상태가 done 또는 cancel로 변경되면 추적이 중지됩니다.

주문 상태 요청

결제 트랜잭션의 현재 상태를 요청하려면 스토어 라이브러리에서 getOrder 메서드를 호출하여 다음 매개 변수를 전달합니다.

• orderId — 아이템 구매 시 수신한 주문 ID.

• callback - 주문 정보를 성공적으로 조회하기 위한 콜백입니다. 콜백을 구현할 경우 GetStatusCallback 인터페이스를 사용하고 onSuccess 및 onError 메소드를 구현합니다.

• callback - 주문 정보를 성공적으로 조회하기 위한 콜백입니다. 콜백을 구현할 경우 GetStatusCallback 인터페이스를 사용하고 onSuccess 및 onError 메소드를 구현합니다.

예시:

XPayments.getStatus(<token>, <isSandbox>, object : GetStatusCallback {
            override fun onSuccess(data: InvoicesDataResponse?) {
                Log.d(TAG, "onSuccess is fired. Result data = $data")
            }

           override fun onError(throwable: Throwable?, errorMessage: String?) {
                Log.d(TAG, "onError is fired. ErrorMessage = $errorMessage")
            }

})

CheckPendingOrder SDK 메서드를 사용하여 주문 상태를 추적할 수 있습니다. 메서드에 다음 매개 변수를 전달합니다.

• AccessToken — 아이템 구매 시 수신한 결제 토큰.
• OrderId — 아이템 구매 시 수신한 주문 ID.
• SuccessCallback — 성공적인 결제 콜백.
• ErrorCallback — 요청 오류 콜백.
• bIsUserInvolvedToPayment — 사용자가 결제 과정에 참여했는지 여부를 확인합니다. 실제 화폐로 구매하려면 true를 전달하고, 무료 아이템 구매 및 인게임 재화로 구매하려면 false를 전달합니다.

추적 메커니즘은 Unreal Engine용 엔터프라이즈급 SDK 문서에 자세히 설명되어 있습니다.

주문의 상태와 내용을 요청하려면 CheckOrder SDK 메서드를 호출하여 다음 매개 변수를 전달합니다.

• AccessToken — 아이템 구매 시 수신한 결제 토큰.
• OrderId — 아이템 구매 시 수신한 주문 ID.
• SuccessCallback — 성공적인 주문 확인을 위한 콜백. 응답에는 주문 상태가 포함됩니다.
• ErrorCallback — 요청 오류 콜백.