Cancelar compra de skin

Merchant API v2

Overview

Principal

Información principal Generación de firma

Depósitos

Empezando Creación de depósito Creación de depósito sin redireccionamiento (iframe) Notificación de depósito (webhook) Verificación del estado del depósito Obtener lista de depósitos Depósitos sin período de espera de 8 días (Steam Trade Protection) Aprobación de depósito con retención de 8 días Recibir notificaciones de webhooks fallidos

Depósitos sin SkinsBack UI

Create a deposit without SkinsBack UI (API) Crear un depósito sin SkinsBack UI (API)

Retiro de skins

Lista de precios (disponibilidad de skins) Buscar skins Comprar skin Compra de skins al por mayor Estado de compra de skin Historial de compras de skins Cancelar compra de skin

Otro

Saldo del proyecto Historial de retiros del saldo y depósitos Monedas y tasas Estado del servidor Eventos en tiempo real: websockets Eventos en tiempo real: webhooks

Cancelar compra de skin

Este método envía una solicitud de cancelación para skins P2P que están esperando la creación del trade. Las solicitudes de cancelación solo están disponibles 30 minutos después de la creación de la compra.

Los parámetros obligatorios están resaltados en azul .

Envía una solicitud POST a API Endpoint con los siguientes parámetros:

method

string

market_cancel

custom_ids

array

array de 'custom_id' de su sistema. Si se especifica este parámetro, la respuesta contendrá una matriz de elementos que contienen información sobre cada compra

Respuesta del servidor:

En caso de éxito, la respuesta del servidor será un objeto JSON con el siguiente contenido:

items

array

Matriz de elementos descritos a continuación

unavailable

object

En una solicitud mixta, este objeto contiene el custom_id y el error de las compras que aún no se pueden cancelar. error_details.available_at contiene la hora de cancelación como timestamp UNIX.

Objeto 'items'

item

object

Objeto que contiene información sobre la piel comprada

— item.id

int

ID de la piel

— item.name

string

Nombre de la piel

— item.price

float

Precio de la piel en USD

— item.delivery_type

int

Tipo de entrega: 1 = Instant, 2 = Slow

— item.classid

string

ID de clase de la piel

buy_id

int

ID de compra de la piel

offer_status

string

Estado de compra:
1. 'creating_trade' — el intercambio se está creando
2. 'waiting_accept' — el intercambio está esperando a ser aceptado
3. 'accepted' — el intercambio ha sido aceptado
4. 'canceled' — el intercambio ha sido cancelado por el usuario
5. 'timeout' — el intercambio no fue aceptado en 10 minutos
6. 'invalid_trade_token' — token de intercambio inválido
7. 'user_not_tradable' — el usuario tiene restricciones en el sistema de intercambio
8. 'trade_create_error' — error al crear el intercambio (intente nuevamente)
9. 'rollback_user' — el skin ha sido devuelto por el usuario (Protección de Intercambio de Steam)
10. 'rollback_supplier' — el skin ha sido devuelto por el proveedor (Protección de Intercambio de Steam)

in_hold

bool

Si la compra está en espera (solo para compras con retención de 8 días)

in_hold_until

string (datetime)

Tiempo UNIX hasta el cual la compra está en espera (solo para compras con retención de 8 días)

error_reason

string

Razón (si está presente):
1. 'user_cant_trade' - el usuario tiene una restricción para comerciar en Steam
2. 'private_inventory' - el usuario debe abrir el inventario
3. 'user_trade_ban' - el usuario tiene prohibición comercial
4. 'user_inventory_is_full' - el inventario del usuario está lleno
5. 'too_many_failed_attempts' - Demasiados intentos fallidos de retirada para el usuario
6. 'skin_unavailable' - skin no disponible para compra (o venta)
7. 'p2p_purchase_canceled_by_user' - la compra P2P fue cancelada por el usuario
8. 'p2p_purchase_canceled_by_system' - la compra P2P fue cancelada automáticamente por el sistema

steamid

string

Steam ID de usuario

date

int

Fecha de compra (tiempo UNIX)

balance_debited_sum

float

Monto debitado del saldo del proyecto (USD)

tradeofferid

string

Trade Offer ID en Steam (solo si se creó una oferta de intercambio)

custom_id

string

'custom_id' en su sistema

refund_percent @deprecated

int

Porcentaje de retorno para reversiones causadas por errores del usuario. Obsoleto: use refund_amount

refund_amount

string|null

Monto real del reembolso en la reversión

Ejemplo de respuesta exitosa:

{
    "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 posibles errores:

missing_one_of_required_params

Faltan custom_ids válidos o las compras no se pueden cancelar

cancel_request_too_early

La solicitud de cancelación solo está disponible 30 minutos después de la creación de la compra

-6

market_disabled

Mercado desactivado

errores estándar:

-1

please_use_post_method

Es necesario utilizar el método POST

-2

invalid_shopid

ID del proyecto no encontrado en el sistema

-3

invalid_signature

Firma incorrecta

-4

shop_not_active

El proyecto no está activo

-5

invalid_method

Método API inválido

-7

request_limit_reached

Se ha alcanzado el límite de solicitudes (500 por minuto)

-8

invalid_ip_address

Por favor, especifique la dirección IP en la configuración del proyecto

-9

under_maintenance

El sitio web está en mantenimiento

-10

invalid_client_secret

Encabezado X-CLIENT-SECRET no válido