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:
Nombre | Tipo | Requerido | Descripción |
key | string | ✔ | Esta 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. |
appid | uint32 | ✔ | Id. de 32 bits de la aplicación asociada con el recurso. |
steamid | uint64 | ✔ | Id. de Steam de 64 bits del usuario para el que configurar una transacción. |
idioma | string | ✔ | Có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] | string | ✔ | Cadena 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] | uint32 | | Un 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. |
moneda | string | ✔ | Código de moneda ISO 4217 que ha de usarse para la transacción. |
ipaddress | string | ✔ | La 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. |
referrer | string | | Cadena opcional que contiene la URL que refirió al usuario a la transacción. |
sandbox | uint32 | | No 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"
}
}