StartWebAssetTransaction/v0001 (documentação do Steamworks)

Documentação do Steamworks

StartWebAssetTransaction/v0001

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

Inicia uma transação em nome de um usuário para os itens especificados.
Implementações devem chamar o método ISteamMicroTxn/InitTxn para que o Steam configure a transação e para receber um URL de encaminhamento.

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 para o qual configurar uma transação.
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
asset[n]	string	✔	Uma string que representa um item que o usuário deseja comprar. Pode ser o índice da definição do item, o nome do item ou qualquer representação única usada pelo jogo. `n` é um índice, começado em 0, e haverá um para cada item que o usuário deseja comprar. O valor deve ser igual ao valor do parâmetro `name` do método `GetAssetPrices` e é a mesma string passada pelo usuário no URL buyitem.
quantity[n]	uint32		Um número inteiro sem sinal opcional que especifica a quantidade do n-ésimo item que o usuário deseja comprar. Se o parâmetro não existir para um ou mais dos itens sendo comprados, assuma o valor 1.
currency	string	✔	O código de moeda ISO 4217 da moeda a usar na transação.
ipaddress	string	✔	Uma string que representa o endereço IP do usuário. Deve ser igual ao endereço IP que acessa o URL de encaminhamento e é esperado que seja o mesmo durante toda a transação.
referrer	string		Uma string opcional que contém o URL que levou o usuário à transação.
sandbox	uint32		Se o valor for diferente de zero, a transação usará o ambiente de desenvolvimento ("sandbox") de microtransações, que não deduzirá o valor da Carteira Steam do usuário. Neste caso, chame o método ISteamMicroTxnSandbox/InitTxn no lugar do método ISteamMicroTxn/InitTxn. 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á armazenada no relatório de erro, disponível na aba Economia do painel de administração de aplicativo no site do Steamworks.
- displaytext — — Uma mensagem de erro localizada opcional para exibição ao usuário.
- url — O URL de encaminhamento, no qual a transação será retomada. O URL deve conter um parâmetro returnurl que especifica para onde encaminhar o usuário depois da transação ser autorizada. O URL deve ser o mesmo que chama o método FinalizeWebAssetTransaction. O valor do parâmetro returnurl também deve conter o ID da transação, pois será necessário para chamar o método FinalizeWebAssetTransaction.
  Além disso, um parâmetro cancelledurl pode ser especificado, que indica para onde encaminhar o usuário se a transação for cancelada.
- txnid — O ID da transação passado como o parâmetro orderid do método InitTxn.

Exemplo de saída

{ "result": { "success": true, "url": "https://store.steampowered.com/checkout/approvetxn/229984771771125/", "txnid": "72" } }