FinalizeWebAssetTransaction/v0001 (documentação do Steamworks)

Documentação do Steamworks

FinalizeWebAssetTransaction/v0001

Documentação do Steamworks > Recursos > Serviço de inventário Steam > Economia Steam > FinalizeWebAssetTransaction/v0001

Chamado depois do usuário pagar por itens na transação.
Implementações devem chamar o método ISteamMicroTxn/FinalizeTxn antes de tentar conceder os itens ao usuário.

Chamado por: Compras na web

Método HTTP: POST

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
key	string	✔	Esta é a "Chave do servidor de ativos" fornecida nas "Configurações da economia Steam" do aplicativo do site do parceiro.
appid	uint32	✔	O AppID de 32 bits do aplicativo associado ao ativo.
steamid	uint64	✔	O ID Steam de 64 bits do usuário que está realizando a compra.
language	string	✔	Código de idioma ISO639-1 seguido de código de país ISO 3166-1 alfa 2 do idioma no qual retornar as strings. Exemplos: en_US, de_DE, pt_BR, zh_CN e ko_KR. Padrão: en_US
txnid	uint64	✔	O ID da transação retornada pelo método StartWebAssetTransaction/v0001
sandbox	uint32		Se o valor for diferente de zero, a transação usará o ambiente de testes ("sandbox") de microtransações, que não deduzirá o valor da Carteira Steam do usuário. Neste caso, chame o método ISteamMicroTxnSandbox/FinalizeTxn no lugar do método ISteamMicroTxn/FinalizeTxn. Consulte o Guia de implementação de microtransações para mais detalhes.

Retorna

A saída deste método deve ser codificada no formato JSON.

Resposta:

result
- success — True se bem-sucedida. Se o servidor de ativos está retornando false, o parâmetro error deve conter uma string com o motivo.
- error — Uma string que descreve o motivo da falha da chamada. A mensagem será adicionada ao histórico de erros, disponível por meio das "Configurações do Steamworks" na página inicial do aplicativo no Steamworks, seção Comunidade —> Economia.
- displaytext — — Uma mensagem de erro localizada opcional para exibição ao usuário.
- assets — Um vetor dos ativos gerados pela compra.
  - assetid — O ID de 64 bits do ativo.
  - contextid — O ID de 64 bits do contexto ao qual o ativo pertence.

Exemplo de saída

{ "result": { "success": true, "displaytext": "Compra concluída! Os itens adquiridos estão disponíveis no seu inventário.", "assets": [ { "assetid": 103, "contextid": 2 } ] } }