Status da compra da skin

Principal

Informações Principais Gerando uma Assinatura

Depósitos

Começando Criando um Depósito Criando um Depósito sem Redirecionamento (iframe) Notificação de Depósito (webhook) Verificando o Status do Depósito Obtendo a Lista de Depósitos Depósitos sem período de espera de 8 dias (Steam Trade Protection) Aprovação de depósito com retenção de 8 dias Receba notificações de webhook com falha

Depósitos sem a interface do usuário do SkinsBack

Create a deposit without SkinsBack UI (API) Obter o inventário do usuário

Retirada de skins

Lista de preços (disponibilidade de skins) Pesquisar skins Comprar skin Comprar skins em grandes quantidades Status da compra de skin Histórico de compras de skins

Outro

Saldo do Projeto Histórico de Saques e Depósitos Moedas e taxas Status do servidor Eventos em tempo real: websockets Eventos em tempo real: webhooks

Status da compra da skin

Informações sobre a skin adquirida. Este método permite obter o Steam Trade Offer ID e verificar se o item foi aceito pelo usuário (ou se foi recusado).

Parâmetros obrigatórios destacados em azul

Envie uma solicitação POST para o Endpoint da API com os seguintes parâmetros:

method

string

market_getinfo

buy_id

int

'buy_id' da compra (do método market_buy)

— OU —

custom_ids

array

array de 'custom_id' da sua sistema. Se esse parâmetro for fornecido, a resposta será um array de itens contendo informações sobre cada compra

— OU —

buy_ids

array

array de 'buy_id' das compras. Se esse parâmetro for fornecido, a resposta será um array de itens contendo informações sobre cada compra

Resposta do servidor:

Em caso de sucesso, a resposta do servidor será um objeto JSON com o seguinte conteúdo:

item

object

Objeto contendo informações sobre a skin comprada

— item.id

int

ID da Skin

— item.name

string

Nome da skin

— item.price

float

Preço da skin em USD

— item.classid

string

ID da Classe da skin

buy_id

int

ID da compra da skin

offer_status

string

Status da compra:
1. 'creating_trade' — troca sendo criada
2. 'waiting_accept' — troca aguardando aceitação
3. 'accepted' — troca aceita
4. 'canceled' — troca cancelada pelo usuário
5. 'timeout' — troca não aceita em 10 minutos
6. 'invalid_trade_token' — token de troca inválido
7. 'user_not_tradable' — usuário tem restrições no sistema de trocas
8. 'trade_create_error' — erro ao criar troca (tente novamente)
9. 'rollback_user' — skin foi devolvido pelo usuário (Proteção de Troca da Steam)
10. 'rollback_supplier' — skin foi devolvido pelo fornecedor (Proteção de Troca da Steam)

in_hold

bool

Se a skin está em espera ou não

in_hold_until

string (datetime)

Data até a qual a skin estará em espera (se a skin estiver em espera)

error_reason

string

Motivo (se presente):
1. 'user_cant_trade' - o usuário tem uma restrição para negociar no Steam
2. 'private_inventory' - o usuário precisa abrir o inventário
3. 'user_trade_ban' - o usuário tem proibição de troca
4. 'user_inventory_is_full' - o inventário do usuário está cheio
5. 'too_many_failed_attempts' - muitas tentativas de retirada malsucedidas para o usuário
6. 'skin_unavailable' - skin indisponível para compra (ou venda)

steamid

string

ID do usuário Steam

date

int

Data da compra (tempo UNIX)

balance_debited_sum

float

Valor debitado do saldo do projeto (USD)

tradeofferid

string

ID da oferta de troca no Steam (somente se a troca foi criada)

custom_id

string

'custom_id' no seu sistema

Exemplo de resposta bem-sucedida:

{
    "status": "success",
    "item": {
        "id": "1280",
        "name": "Taunt: RazorFlip!",
        "price": "0.16",
        "classid": "1723112726"
    },
    "buy_id": "9",
    "offer_status": "trade_create_error",
    "error_reason": null,
    "steamid": "76561198050648523",
    "date": "1596999226",
    "balance_debited_sum": "11.73"
}

Lista de possíveis erros:

missing_one_of_required_params

Parâmetro obrigatório ausente (buy_id, buy_ids ou custom_ids)

offer_not_found

Compra da skin não encontrada

-6

market_disabled

Mercado desativado

erros padrão:

-1

please_use_post_method

É necessário usar o método POST

-2

invalid_shopid

ID do projeto não encontrado no sistema

-3

invalid_signature

Assinatura inválida

-4

shop_not_active

Projeto inativo

-5

invalid_method

Método de API inválido

-7

request_limit_reached

Limite de solicitações excedido (500 por minuto)

-8

invalid_ip_address

Especifique o endereço IP nas configurações do projeto

-9

under_maintenance

Site em manutenção

-10

invalid_client_secret

Cabeçalho X-CLIENT-SECRET inválido