Активировать промокод

Позволяет применить промокод. Если код валиден, соответствующая сумма (бонус) будет моментально зачислена на баланс вашего аккаунта.

POST https://api.yougpu.ru/billing/promo/activate

Заголовки (Headers)

Заголовок	Значение	Описание
X-API-KEY	<YOUR_API_KEY>	Ваш API ключ
Content-Type	application/json	Формат данных

Регистр

Промокоды не чувствительны к регистру. Система автоматически приведёт код к верхнему регистру (например, gpu2026 превратится в GPU2026).

Параметры тела (Body)

Параметр

Тип

Описание

code*

string

Текстовый код купона.

Примеры кода

cURL

curl -X POST "https://api.yougpu.ru/billing/promo/activate" \
  -H "X-API-KEY: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "GPU_START_2026"
  }'

Python

import requests

url = "https://api.yougpu.ru/billing/promo/activate"
headers = {
    "X-API-KEY": "<YOUR_API_KEY>",
    "Content-Type": "application/json"
}
data = {
    "code": "GPU_START_2026"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

Node.js

const response = await fetch('https://api.yougpu.ru/billing/promo/activate', {
  "method": "POST",
  "headers": {
      "X-API-KEY": "<YOUR_API_KEY>",
      "Content-Type": "application/json"
  },
  "body": JSON.stringify({
      "code": "GPU_START_2026"
  })
});
const data = await response.json();
console.log(data);

Ответ

200 OK

{
  "status": "success",
  "code": 200,
  "data": {
    "added_amount": "10.00",
    "new_balance": "160.75"
  }
}

400 Bad Request

Возвращается в случаях: код истек, лимит использований исчерпан или вы уже активировали этот код ранее.

{
  "statusCode": 400,
  "message": "You have already activated this promo code",
  "error": "Bad Request"
}

404 Not Found

{
  "statusCode": 404,
  "message": "Promo code not found",
  "error": "Not Found"
}

---

Структура ответа

Параметр

Тип

Описание

status

string

Статус выполнения запроса (например, success).

code

number

HTTP код ответа.

data

object

Данные ответа:

added_amount

string

Сумма, которая была начислена на баланс (в валюте аккаунта).

new_balance

string

Общий доступный баланс после применения кода.

Есть вопросы?

Поддержка Чат

Нашли ошибку? Сообщить