Documentación de Steamworks
StartWebAssetTransaction/v0001
Esto inicia una transacción en nombre de un usuario para los artículos especificados.
Las implementaciones deben llamar a ISteamMicroTxn/InitTxn para que Steam configure la transacción y obtener una URL de reenvío.

Llamada por: Compras en la web

Método HTTP: POST

Parámetros:

NombreTipoRequeridoDescripción
keystringEsta es la "Clave del servidor de recursos" que proporcionaste en la configuración de la economía de Steam de tu aplicación en el sitio asociado.
appiduint32Id. de 32 bits de la aplicación asociada con el recurso.
steamiduint64Id. de Steam de 64 bits del usuario para el que configurar una transacción.
idiomastringCódigo de lenguaje ISO639-1 más código de país ISO 3166-1 alfa 2 del lenguaje en que se devuelven las cadenas. Algunos ejemplos incluyen en_US, de_DE, zh_CN y ko_KR. Por defecto: en_US
asset[n]stringCadena que representa un artículo que el usuario desea adquirir. Puede ser un índice de definición de artículos, un nombre de artículo o cualquier otra representación única que el juego desee utilizar. n es un índice basado en 0 y habrá uno para cada artículo que el usuario desee comprar. El valor debe coincidir con el valor del parámetro name de GetAssetPrices y es la misma cadena que el usuario pasa a la URL buyitem.
quantity[n]uint32Un entero sin signo opcional que especifica la cantidad que el usuario desea adquirir del artículo enésimo. Si falta el parámetro para cualquiera de los artículos que se están adquiriendo, debe asumirse un valor de uno.
monedastringCódigo de moneda ISO 4217 que ha de usarse para la transacción.
ipaddressstringLa dirección IP del usuario como una cadena. Se espera que la dirección IP coincida con aquella a la que accede la URL de envío y que permanezca inmutable durante la transacción.
referrerstringCadena opcional que contiene la URL que refirió al usuario a la transacción.
sandboxuint32No es cero si esta transacción utilizará el "sandbox" de microtransacciones que no deducirá fondos de la cartera del usuario. En este caso deberías llamar a ISteamMicroTxnSandbox/InitTxn, en vez de a ISteamMicroTxn/InitTxn. Para más detalles consulta Guía de implementación de microtransacciones.

Devoluciones

La salida de este método debería estar codificada en formato JSON.

Respuesta:
  • result
    • success - True si el método fue exitoso. Si el servidor de recursos devuelve "false", debería establecer error en una cadena que explique por qué.
    • error - Una cadena que describe por qué esta llamada falló. Este mensaje se incluirá en el registro de errores, que está disponible en la pestaña Economía del sitio de Steamworks.
    • displaytext - Un mensaje de error localizado opcional para mostrar al usuario.
    • url - La URL para reenviar al usuario al lugar donde se continuará la transacción. La URL
      debe enmendarse con un parámetro returnurl que especifique dónde reenviar al usuario después de que él o ella
      autorice la transacción. Esta URL debe ser la que finalmente llama
      FinalizeWebAssetTransaction. El valor del parámetro returnurl también debe contener el
      id. de transacción, ya que se necesitará al llamar a FinalizeWebAssetTransaction.
      Además, también se puede especificar un parámetro cancelledurl que indica dónde llevar al usuario si
      él o ella hacen clic en cacelar en lugar de autorizar la transacción.
    • txnid - El id. de la transacción como se envió al parámetro de orderid
      InitTxn.

Ejemplo de salida

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