API

Khác với các hệ thống thanh toán truyền thống, SkinsBack không chấp nhận một số cụ thể để nạp tiền. Số tiền nạp sẽ được gửi đến Result URL (webhook) sau khi chúng tôi nhận được các vật phẩm trong trò chơi.

Phản hồi từ phương thức này sẽ chứa URL mà người dùng cần được chuyển hướng đến (đó chính là trang thanh toán).

Tham số 'min_amount' và/hoặc 'max_amount' chỉ được sử dụng để tạo khoản nạp Limited. Khi đó, cũng cần chỉ định tham số 'currency'. Nếu 'min_amount' nhỏ hơn số giao dịch tối thiểu của trò chơi, số giao dịch tối thiểu của trò chơi sẽ được sử dụng.

Các tham số bắt buộc được đánh dấu bằng màu xanh.

Gửi yêu cầu POST tới Điểm cuối API với các tham số sau:

Phản hồi từ máy chủ:

Nếu thành công, phản hồi từ máy chủ sẽ là một đối tượng JSON với nội dung sau:

Ví dụ phản hồi thành công:

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

Danh sách các lỗi có thể xảy ra:

Ví dụ phản hồi lỗi:

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

Ví dụ về yêu cầu có tiêu đề ủy quyền trong 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);

Ví dụ về yêu cầu có chữ ký trên 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/vi/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);