Steam + Acquiring
Scenario 1 - by account top-up amount
Use this scenario if you need to top up the account by a specific amount in rubles
Getting the top-up cost
For a given account top-up amount, calculate the top-up cost and the minimum sale price
Request parameters
| Parameter | Required | Type | Comment |
|---|---|---|---|
| netAmount | Yes | Number | The account top-up amount in Steam, in rubles. Up to 2 digits after the decimal point for kopecks. Example: 1188.00 |
| account | Yes | String | The Steam account name (Steam ID cannot be used) |
Response parameters
| Parameter | Type | Comment |
|---|---|---|
| price | Number | The top-up cost, in RUB |
| minPrice | Number | The minimum sale price, in RUB (top-up cost plus the minimum WATA commission) |
| steamRate | Number | The calculated USD → RUB rate in Steam (may differ from the actual rate). Used internally by Steam to convert top-ups in different currencies |
Creating an order
Create an order and get a payment link for a given account top-up amount.
The merchant income is the sale price minus the WATA commission (% of the price) and the account top-up cost.
Request parameters
| Parameter | Required | Type | Comment |
|---|---|---|---|
| account | Yes | String | The Steam account name |
| amount | Yes | Number | The payment (transaction) amount in rubles for which the payment link will be created. Up to 2 digits after the decimal point for kopecks. Example: 1188.00. Value constraints: minPrice <= amount <= minPrice*1.5 |
| netAmount | Yes | Number | The account top-up amount in Steam, in rubles. Up to 2 digits after the decimal point for kopecks. Example: 1188.00 |
| description | Yes | String | Order description or other details |
| orderId | Yes | String | Order number. It is later used to check the order status |
| successRedirectUrl | No | String | The store page URL the payer is redirected to if the order payment succeeds |
| failRedirectUrl | No | String | The store page URL the payer is redirected to if the order payment fails |
Response parameters
| Parameter | Type | Comment |
|---|---|---|
| orderId | String | Order number. It is later used to check the order status |
| amount | Number | The payment (transaction) amount in rubles for which the payment link was created. Up to 2 digits after the decimal point for kopecks. Example: 1188.00 |
| price | Number | The top-up cost, in RUB |
| minPrice | Number | The minimum sale price, in RUB (top-up cost plus the minimum WATA commission) |
| commission | Number | The WATA commission, in RUB |
| steamRate | Number | The calculated USD → RUB rate in Steam (may differ from the actual rate). Used internally by Steam to convert top-ups in different currencies |
| paymentLink | String | The payment link URL |
| successRedirectUrl | String | The store page URL the payer is redirected to if the order payment succeeds |
| failRedirectUrl | String | The store page URL the payer is redirected to if the order payment fails |
Scenario 2 - by payment amount
Use this scenario if the customer's payment amount is known. The account top-up amount will be calculated automatically
Getting the top-up amount
For a given payment amount, calculate the cost and the account top-up amount
Request parameters
| Parameter | Required | Type | Comment |
|---|---|---|---|
| amount | Yes | Number | The customer's payment amount in rubles. Up to 2 digits after the decimal point for kopecks. Example: 1188.00 |
| margin | Yes | Number | The merchant income in rubles (must be <= 50% *amount). Included within amount |
| account | Yes | String | The Steam account name (Steam ID cannot be used) |
Response parameters
| Parameter | Type | Comment |
|---|---|---|
| netAmount | Number | The Steam top-up amount, in RUB |
| price | Number | The top-up cost, in RUB |
| steamRate | Number | The calculated USD → RUB rate in Steam (may differ from the actual rate). Used internally by Steam to convert top-ups in different currencies |
Creating an order
Create an order and get a payment link for a given payment amount and merchant income. The account top-up amount is calculated automatically.
→ POST /api/v3/steam/by-amount
Request parameters
| Parameter | Required | Type | Comment |
|---|---|---|---|
| account | Yes | String | The Steam account name |
| amount | Yes | Number | The payment (transaction) amount in rubles for which the payment link will be created. Up to 2 digits after the decimal point for kopecks. Example: 1188.00 |
| margin | Yes | Number | The merchant income in rubles (must be <= 50% *amount). Included within amount |
| description | Yes | String | Order description or other details |
| orderId | Yes | String | Order number. It is later used to check the order status |
| successRedirectUrl | No | String | The store page URL the payer is redirected to if the order payment succeeds |
| failRedirectUrl | No | String | The store page URL the payer is redirected to if the order payment fails |
Response parameters
| Parameter | Type | Comment |
|---|---|---|
| orderId | String | Order number |
| amount | Number | The customer's payment amount, in RUB |
| netAmount | Number | The Steam top-up amount, in RUB |
| price | Number | The top-up cost, in RUB |
| commission | Number | The WATA commission, in RUB |
| margin | Number | The merchant income, in RUB |
| steamRate | Number | The calculated USD → RUB rate in Steam (may differ from the actual rate). Used internally by Steam to convert top-ups in different currencies |
| paymentLink | String | The payment link URL |
| successRedirectUrl | String | The store page URL the payer is redirected to if the order payment succeeds |
| failRedirectUrl | String | The store page URL the payer is redirected to if the order payment fails |
Checking order status
→ GET /api/v3/steam/order/{id}
Request parameters
| Parameter | Required | Type | Comment |
|---|---|---|---|
| id | Yes | String | Order number |
Response parameters
| Parameter | Type | Comment |
|---|---|---|
| orderId | String | Order number |
| amount | Number | The payment (transaction) amount in rubles. Up to 2 digits after the decimal point for kopecks. Example: 1188.00 |
| status | String | Order status. Possible values: Pending (awaiting payment) → Paid (order paid, being fulfilled) → Success (order fulfilled) / Fail (error) |
| successRedirectUrl | String | The store page URL the payer is redirected to if the order payment succeeds |
| failRedirectUrl | String | The store page URL the payer is redirected to if the order payment fails |