Acompanhamento do status do pedido

Depois que um usuário faz uma compra, seu aplicativo pode executar as seguintes ações:

• mostrar o status do pedido na interface do aplicativo
• creditar o saldo de um usuário após um pagamento bem-sucedido
• conceder os itens comprados após um pagamento bem-sucedido

Ao usar o SDK para implementar a lógica dessas ações, você pode rastrear o status do pedido das seguintes maneiras:

• inscrevendo-se nas alterações de status do pedido (recomendado)
• solicitando o status do pedido

Inscrevendo-se nas alterações de status do pedido

Use o método de biblioteca Store

Para se inscrever nas alterações de status de pedido, use o método SDK getOrderStatus da biblioteca Store e passe os seguintes parâmetros ao método:

• listener — objeto do ouvinte do tipo OrderStatusListener.
• orderId — ID do pedido recebido da compra através do carrinho de compras, compras com um clique ou compras com moedas virtuais como parâmetro.

Documentação de referência do SDK

Saiba mais sobre os métodos SDK e seus parâmetros.

Exemplo de chamada do método 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)

Recomendamos chamar o método XStore.getOrderStatus ao abrir a interface de pagamento.

Esses métodos de compra encapsulam vários métodos para controlar o status do pedido. O rastreamento é realizado de acordo com o seguinte algoritmo:

1. Uma conexão de websocket é estabelecida.
2. Se a conexão for estabelecida com sucesso e o status do pedido for alterado para done ou cancel, o rastreamento é interrompido. Se uma conexão de websocket falhar ou a resposta contiver dados incorretos, o status do pedido é rastreado usando short-polling.
3. O rastreamento do status do pedido continua com short-polling. Uma solicitação de status de pedido HTTP simples é enviada a cada 3 segundos. O rastreamento é interrompido se o status do pedido for alterado para done ou cancel.

Use o método da biblioteca Payments

1. Ao calcular o objeto XPayments.IntentBuilder, passe o retorno de chamada StatusReceivedCallback usando o método setStatusReceivedCallback.
2. Implemente o método onSuccess no retorno de chamada StatusReceivedCallback, que é chamado a cada alteração de status diferente.

Exemplo:

val intent = XPayments.createIntentBuilder(this)
               .accessToken(<accessToken>)
               .isSandbox(<isSandbox>)
           	.setStatusReceivedCallback(object : StatusReceivedCallback {
               	override fun onSuccess(data: InvoicesDataResponse) {
                   		Log.d(TAG, "StatusReceivedCallback is fired. Result data = $data")
               	}
           	})
           	.build()

Solicitando o status do pedido

Para solicitar o status atual do pagamento, chame o método getOrder da biblioteca Store, passando os seguintes parâmetros a ele:

• orderId — o ID do pedido, que foi recebido da compra pelo carrinho de compras, compra de um clique ou compra com moeda virtual.
• callback — o retorno de chamada por receber as informações do pedido com sucesso. Ao implementar um retorno de chamada, use a interface GetStatusCallback e implemente os métodos onSuccess e onError.

Exemplo:

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")
            }

})

Links úteis