Depozit Oluşturma

Ana Sayfa

Temel Bilgiler İmza Oluşturma

Depozitler

Başlarken Depozito Oluşturma Depozito Oluşturma (iframe ile yönlendirme olmadan) Depozito Bildirimi (webhook) Depozito Durumu Kontrolü Depozito Listesi Alma 8 gün beklemesiz yatırımlar (Steam Trade Protection) 8 günlük bekletme ile yatırım onayı Başarısız web kancası bildirimleri alın

SkinsBack kullanıcı arayüzü olmadan para yatırma

Create a deposit without SkinsBack UI (API) Kullanıcının envanterini al

Skin çekme

Fiyat listesi (skin mevcudu) Skin arama Skin satın alma Toplu satın alma skinleri Skin satın alma durumu Skin satın alma geçmişi

Diğer

Proje Bakiyesi Bakiye ve Depozito Çekme Geçmişi Para birimleri ve döviz kurları Sunucu durumu Gerçek zamanlı olaylar: websockets Gerçek zamanlı olaylar: web kancaları

Depozit Oluşturma

Klasik ödeme sistemlerinin aksine, SkinsBack, yükleme için belirli bir miktar kabul etmez. Yükleme miktarı, bize oyun eşyalarını ilettikten sonra Sonuç URL'sine (webhook) gönderilir.

Bu yöntemin yanıtında, kullanıcıyı yönlendirmeniz gereken URL bulunacaktır (bu ödeme sayfasıdır).

'min_amount' ve/veya 'max_amount' parametreleri, yalnızca Sınırlı depozitolar oluşturmak için kullanılmalıdır. Bu durumda 'currency' parametresini de belirtmek zorunludur. 'min_amount', oyun için minimum işlem tutarından daha düşükse, oyun için minimum işlem tutarı kullanılacaktır.

Mavi zorunlu parametreleri vurgulanmıştır.

Aşağıdaki parametreleri içeren POST isteği gönderin: API Endpoint

method

string

create

order_id

string

Sistemdeki benzersiz depozit ID'si

steam_id

string

Varsayılan Steam ID kullanıcısı. Kullanıcı, yeniden doldurma sırasında hesabını değiştirebilir.

trade_token

string

Kullanıcının Trade URL'sinden alınan 'token' (8 karakter)

currency

string

Para birimi (isteğe bağlı)

result_url

string

İsteğe bağlı Result URL 'si, projenin ayarlarında belirtilenin
yerine kullanılacaktır.

fail_url

string

İsteğe bağlı Fail URL

success_url

string

İsteğe bağlı Success URL

min_amount

double

En düşük yükleme miktarı.
'currency' ile birlikte kesinlikle kullanılır

max_amount

double

En yüksek yükleme miktarı. 'min_amount' değerinden daha büyük olmalıdır.
'currency' ile birlikte kesinlikle kullanılır

widget

bool

Eğer değer 1 ise, sunucudan alınan yanıtta, sitenizin içinde ödeme arayüzünü görüntülemek için kullanılacak olan URL (iframe) iletilir. Daha fazla bilgi için doğrudan site üzerinde ödeme yapma konusuna bakabilirsiniz

game

string

Ödeme formunda envanter yüklenirken varsayılan olarak açılacak oyun ('cs2', 'dota2', 'rust')

custom_multiplier

double

Özel fiyat çarpanı (proje ayarlarından gelen değeri geçersiz kılar). Min. değer: 0.5, maks.: 2

custom_currency

string

Özel para birimi (custom_currency_rate ile gereklidir). Özel bir para biriminin adını geçebilir ve oranını belirtebilirsiniz. Skin fiyatları bu para biriminde gösterilecektir. Maksimum 4 karakter.

custom_currency_rate

double

İsteğe bağlı bir para biriminin oranı (custom_currency ile gereklidir). Min. değer: 0.1

Sunucudan gelen yanıt:

Başarılı olursa, sunucudan gelen yanıtta aşağıdaki JSON nesnesi olacaktır:

url

string

Kullanıcıyı yönlendirmeniz gereken URL

transaction_id

int

Bizim sistemimizdeki işlem ID'si

Başarılı yanıt örneği:

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

Mümkün olan hataların listesi:

invalid_order_id

order_id değeri yanlış aktarıldı

invalid_steam_id

Geçersiz steam_id. Steam ID örneği: 76561198827262007

order_id_already_exists

Belirtilen order_id zaten bir depozito oluşturmak için kullanıldı

invalid_max_value

Maksimum yeniden doldurma miktarı 'min_value' ve minimum oyun anlaşması toplamından büyük olmalıdır

invalid_currency

Geçersiz para birimi belirtildi

invalid_result_url

Geçersiz URL belirtildi

invalid_success_url

Geçersiz Başarı URL'si

invalid_fail_url

Geçersiz Hata URL'si

invalid_custom_currency

Geçersiz özel para birimi belirtildi

invalid_custom_currency_rate

Geçersiz özel para birimi kuru belirtildi

invalid_custom_multiplier

Geçersiz özel çarpan belirtildi. Min değer: 0.5, maks: 2

invalid_game

Geçersiz oyun belirtildi

standart hatalar:

-1

please_use_post_method

POST yöntemi kullanılmalıdır

-2

invalid_shopid

Proje kimliği sistemde bulunamadı

-3

invalid_signature

Geçersiz imza

-4

shop_not_active

Proje etkin değil

-5

invalid_method

Geçersiz API yöntemi

-7

request_limit_reached

İstek sınırı aşıldı (500/dakika)

-8

invalid_ip_address

Proje ayarlarında IP adresini belirtin

-9

under_maintenance

Site bakımda

-10

invalid_client_secret

Geçersiz X-CLIENT-SECRET başlığı

Hata yanıtı örneği:

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

PHP'de yetkilendirme başlıklı istek örneği:

<?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'de imzalı istek örneği:

<?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/tr/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);