Skip to main content
POST
/
gifts
cURL
curl --request POST \
  --url https://api.steamgold.dev/v1/gifts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "platform": "<string>",
  "item": "<string>",
  "target": {
    "inviteUrl": "<string>",
    "region": "<string>",
    "packageId": 123
  },
  "email": "jsmith@example.com",
  "fee": "excluded",
  "code": "<string>",
  "attribution": {
    "utm_source": "<string>",
    "utm_medium": "<string>"
  },
  "successUrl": "<string>",
  "failureUrl": "<string>",
  "callbackUrl": "<string>"
}
'
{
  "code": 123,
  "intentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "verified": true,
  "intentAmount": 123,
  "intentCurrency": "<string>",
  "paymentAmount": 123,
  "paymentCurrency": "<string>",
  "message": "<string>"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Описание намерения

platform
string
required

Платформа для которой создается намерение (например, steam-gift)

item
string
required

Идентификатор игры (appId в Steam)

target
object
required

Данные получателя подарка

email
string<email>
required

Электронная почта геймера для получения чека

fee
enum<string>
default:excluded

Если included то комиссия включена в сумму, если excluded то комиссия не включена в сумму, naive считает комиссию от суммы оплаты.

Available options:
included,
excluded,
naive
code
string

Промокод применяемый к покупке

attribution
object

Атрибуция трафика (если есть). Подробнее в документации

successUrl
string

URL для перенаправления после успешной оплаты

failureUrl
string

URL для перенаправления после неуспешной оплаты

callbackUrl
string

URL для оповещения об успешной оплате

Response

intent response

code
integer<int32>
required

HTTP-код ответа

intentId
string<uuid>
required

Идентификатор намерения

verified
boolean
required

Флаг успешной верификации намерения

intentAmount
number

Сумма намерения

intentCurrency
string

Валюта намерения

paymentAmount
number

Сумма оплаты для геймера

paymentCurrency
string

Валюта платежа

message
string

Сообщение об успешном выполнении операции