Cancelar compra de skin

Merchant API v2

Overview

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 Cancelar compra de skin

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

Cancelar compra de skin

Este método envia uma solicitação de cancelamento para skins P2P que estão aguardando a criação da troca. Solicitações de cancelamento estão disponíveis somente 30 minutos após a criação da compra.

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_cancel

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

Resposta do servidor:

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

items

array

Matriz de elementos descritos abaixo

unavailable

object

Em uma solicitação mista, este objeto contém o custom_id e o erro das compras que ainda não podem ser canceladas. error_details.available_at contém o horário de cancelamento como timestamp UNIX.

Objeto 'items'

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.delivery_type

int

Tipo de entrega: 1 = Instant, 2 = Slow

— 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)
7. 'p2p_purchase_canceled_by_user' - a compra P2P foi cancelada pelo usuário
8. 'p2p_purchase_canceled_by_system' - a compra P2P foi cancelada automaticamente pelo sistema

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

refund_percent @deprecated

int

Percentual de retorno para reversões causadas por erro do usuário. Obsoleto: use refund_amount

refund_amount

string|null

Valor real do reembolso no rollback

Exemplo de resposta bem-sucedida:

{
    "status": "success",
    "items": [
        {
            "id": "2715",
            "name": "SSG 08 | Fever Dream (Field-Tested)",
            "price": "77.02",
            "classid": "3770669160",
            "buy_id": "50123",
            "offer_status": "creating_trade",
            "in_hold": false,
            "in_hold_until": null,
            "error_reason": null,
            "steamid": "76561190000000000",
            "date": "1719825675",
            "balance_debited_sum": "77.02",
            "tradeofferid": null,
            "custom_id": "project-order-1"
        }
    ]
}

Lista de possíveis erros:

missing_one_of_required_params

custom_ids válidos ausentes ou compras indisponíveis para cancelamento

cancel_request_too_early

A solicitação de cancelamento está disponível somente 30 minutos após a criação da compra

-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