创建存款

主要

基本信息生成签名

存款

入门创建存款创建存款（不带重定向）(iframe) 存款通知（webhook）检查存款状态获取存款列表无需8天等待的存款（Steam交易保护）批准8天冻结期的存款获取失败的 webhook 通知

无SkinsBack用户界面的存款

Create a deposit without SkinsBack UI (API) 获取用户库存

提取皮肤

价格列表（皮肤可用性）搜索皮肤购买皮肤批量购买皮肤购买皮肤的状态皮肤购买历史

其他

项目余额余额和存款提现历史记录货币和汇率服务器状态事件实时性：websockets 实时事件：回调

SkinsBack与传统的支付系统不同，不接受特定的充值金额。收到游戏物品后，充值金额将发送到结果 URL（webhook）。

该方法的响应中将包含一个URL，用户需要重定向到该URL（即支付页面）。

'min_amount'和/或'max_amount'参数仅在创建有限存款时使用。在这种情况下，还必须指定'currency'参数。如果'min_amount'小于游戏的最小交易金额，则将使用游戏的最小交易金额。

个蓝色 个必填参数。

向 API终点发送POST请求，使用以下参数：

method

string

create

order_id

string

您系统中的唯一订单ID

steam_id

string

用户的Steam ID，默认为 用户可以在充值时更改账户。

trade_token

string

来自用户交易URL的'token'（8个字符）

currency

string

货币（可选）

result_url

string

可选的Result URL，将会在项目设置中使用
代替

fail_url

string

可选的失败URL

success_url

string

可选的成功URL

min_amount

double

最低充值金额。
与'currency'一起使用

max_amount

double

最高充值金额。必须大于'min_amount'。
与'currency'一起使用

widget

bool

如果值为1，则服务器的响应将包含一个用于在您的网站内显示充值界面的URL（iframe）。了解更多关于在网站上直接充值的信息

game

string

在支付表单中加载库存时默认打开的游戏 ('cs2', 'dota2', 'rust')

custom_multiplier

double

自定义价格乘数（覆盖项目设置中的值）。最小值：0.5，最大值：2

custom_currency

string

自定义货币（custom_currency_rate 必需）。您可以传递自定义货币的名称并指定其汇率。皮肤价格将以此货币显示。最多 4 个字符。

custom_currency_rate

double

任意货币的汇率（custom_currency 必需）。最小值：0.1

服务器响应：

如果成功，服务器的响应将是一个JSON对象，内容如下：

url

string

需要将用户重定向到的URL

transaction_id

int

在我们的系统中的交易ID

成功响应示例：

{
    "status": "success",
    "url": "https://skinsback.com/_/pay/9421749033d9d3f725c67572575975de/",
    "transaction_id": 13
}

可能的错误列表：

invalid_order_id

传入的 order_id 值不正确

invalid_steam_id

无效的 steam_id。Steam ID 示例：76561198827262007

order_id_already_exists

指定的 order_id 已用于创建存款

invalid_max_value

最大补充金额应大于 min_value 和最小游戏交易总和

invalid_currency

指定的货币无效

invalid_result_url

指定的 URL 无效

invalid_success_url

成功 URL 无效

invalid_fail_url

无效的失败 URL

invalid_custom_currency

指定的自定义货币无效

invalid_custom_currency_rate

指定的自定义货币汇率无效

invalid_custom_multiplier

指定的自定义乘数无效. 最小值：0.5，最大值：2

invalid_game

指定的游戏无效

标准错误：

-1

please_use_post_method

需要使用POST方法

-2

invalid_shopid

项目ID在系统中未找到

-3

invalid_signature

签名格式不正确

-4

shop_not_active

项目不处于活动状态

-5

invalid_method

无效的API方法

-7

request_limit_reached

请求限制已达到（每分钟500次）

-8

invalid_ip_address

请在项目设置中指定IP地址

-9

under_maintenance

网站维护中

-10

invalid_client_secret

无效的 X-CLIENT-SECRET 标头

错误响应示例：

{
    "status": "error",
    "error_code": 1,
    "error_message": "invalid_order_id"
}

PHP 授权标头请求示例：

<?php
$params = array(
	'method' => 'create',
	'order_id' => 1,
	'steam_id' => '76561198827262007',
	'trade_token' => 'i1ArBZey',
	'currency' => 'usd'
);
$clientId = '12312312323123';
$clientSecret = '123123123123213';

$headers = [
    'X-CLIENT-ID: ' . $clientId,
    'X-CLIENT-SECRET: ' . $clientSecret,
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,"https://skinsback.com/api.php");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$server_output = curl_exec($ch);
curl_close ($ch);
var_dump($server_output);

带有签名的PHP请求示例：

<?php
$params = array(
	'shopid' => '1', // Client ID
    'method' => 'create',
	'order_id' => 1,
	'steam_id' => '76561198827262007',
	'trade_token' => 'i1ArBZey',
	'currency' => 'usd'
);
$clientSecret = '123123123123213';
// @see https://skinsback.com/zh-cn/docs/api/v1/signature/
$params['sign'] = buildSignature($params, $clientSecret);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,"https://skinsback.com/api.php");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$server_output = curl_exec($ch);
curl_close ($ch);
var_dump($server_output);

API

创建存款

向 API终点 发送POST请求，使用以下参数：

服务器响应：

成功响应示例：

可能的错误列表：

错误响应示例：

PHP 授权标头请求示例：

带有签名的PHP请求示例：

向 API终点发送POST请求，使用以下参数：