Skip to main content
POST
Create in-game currency listing

Авторизации

Authorization
string
header
обязательно

Your API key, from the cabinet under Seller → API keys.

Тело

application/json

Currency is priced per unit out of a stock you keep, and handed over by hand — there is no listing price, no unit pool and no gallery. The three quantities are counted in the product's own scale: for a product sold by the million, stock_quantity: 500 is 500 million.

game
string
обязательно

The game's slug.

title
string
обязательно
Required string length: 8 - 128
product_slug
string
обязательно

One of the game category's products — GET .../products.

price_per_unit
integer<int64>
обязательно

US cents per one of the product's scale.

stock_quantity
integer<int64>
обязательно

How much you have, counted in the product's scale.

min_order_quantity
integer<int64>
обязательно

The smallest order you will take.

delivery_method
string
обязательно

A key from GET /v1/offers/delivery-methods.

delivery_instructions
string
обязательно

What the buyer is told to do at handover, in your words.

Maximum string length: 2048
manual_delivery_value
integer<int32>
обязательно

The handover time you promise.

manual_delivery_unit
enum<string>
обязательно

What the value counts.

Доступные опции:
minutes,
hours,
days
description
string
Maximum string length: 4096
tags
string[]

Up to 500 characters in all, counted as the tags joined with ", ". No commas inside a tag. Stored trimmed, lower-cased and deduplicated.

attributes
object

The category's own fields — read them from its schema.

Ответ

Created

How a listing sold by hand promises to hand over.

id
string<uuid>
title
string
description
string
attributes
object

The category's own fields, keyed by the schema's key.

tags
string[]
status
enum<string>

draft on create, then active once you publish it. paused and archived are yours too, through pause and DELETE. reserved and sold follow an order. removed is a takedown after publishing, which no call in this API performs.

Доступные опции:
draft,
active,
paused,
reserved,
sold,
removed,
archived
created_at
string<date-time> | null
updated_at
string<date-time> | null
published_at
string<date-time> | null

When publish put it on the marketplace. null while it is a draft, and written once — pausing and unpausing leave it alone.

manual_delivery_value
integer<int32> | null

The handover time promised, read together with the unit — 2 and hours.

manual_delivery_unit
enum<string> | null

What the value counts. Both are null on a listing delivered instantly.

Доступные опции:
minutes,
hours,
days,
null
currency
string

Always USD.

Пример:

"USD"

product_id
string<uuid> | null

The product this listing sells, from GET .../products.

price_per_unit
integer<int64> | null

US cents per one of the product's scale.

stock_quantity
integer<int64> | null

What is left, in that same scale.

min_order_quantity
integer<int64> | null

The smallest order this listing takes.

delivery_method
string | null

The key this listing hands over by.

delivery_instructions
string

What the buyer is told to do at handover.