Код спишется именно на этот аккаунт, и вернуть его нельзя. Убедитесь, что данные верны.
04
Активация
04
00:00
Проверка
Подписка не пришла? Восстановить
Проверка аккаунта
Проверка аккаунта
API терминала
Программная активация подписок Claude, ChatGPT, Grok и Fortnite Crew на аккаунт покупателя. Здесь всё, что нужно для интеграции: какие бывают коды, порядок вызовов, статусы, защита от двойного списания и справочник методов с примерами.
Минимальная интеграция — два метода: создать активацию и дождаться её завершения.
# 1. активировать код на аккаунт покупателя
curl -X POST https://pay2cdkey.com/pub/v1/activate \
-H "Content-Type: application/json" -H "X-API-Key: ВАШ_КЛЮЧ" \
-d '{"card_key":"CLAUDE-PRO-7KQ2M9XW4TRBZ8HNE5DJ6FGPAC","account":"a63cfbd2-1c4e-4b8a-9d2f-5e7a8b9c0d1e"}'
# → {"ok":true,"task_id":"0f8a6d64-…","status":"running","product":"Pro"}
# 2. опрашивать статус раз в 3–5 секунд, пока не придёт done или failed
curl -X POST https://pay2cdkey.com/pub/v1/task \
-H "Content-Type: application/json" -H "X-API-Key: ВАШ_КЛЮЧ" \
-d '{"task_id":"0f8a6d64-…"}'
# → {"ok":true,"status":"done","product":"Pro"}
Обычно активация завершается за несколько секунд. Статус done может прийти уже в ответе на activate — тогда опрашивать не нужно.
2. Базовый URL и авторизация
https://pay2cdkey.com
Все методы — POST, тело запроса и ответ — JSON в UTF-8.
Заголовки: Content-Type: application/json и X-API-Key: ВАШ_КЛЮЧ.
Ключ выдаётся персонально и действует на все методы /pub/v1. По ключу ведётся ваша история активаций, поэтому не передавайте его третьим лицам и не вставляйте в код, который исполняется в браузере покупателя. Если ключ мог утечь — сообщите, выпустим новый.
Таймаут клиента ставьте не меньше 90 секунд: большинство ответов приходит за 1–3 секунды, но создание активации изредка занимает до минуты.
3. Формат ответов и коды ошибок
// успех
{"ok": true, ...данные метода...}
// отказ
{"ok": false, "error": "текст для человека", "code": "машинный_код"}
Проверяйте поле ok, а не только HTTP-код. Бизнес-отказ (например «код уже использован») приходит с HTTP 200 и ok:false. HTTP-код отражает только транспорт: 401 — неверный ключ, 429 — слишком частые запросы, 502 — сервис временно недоступен (в теле при этом тот же JSON с code:"transient"). Логику стройте на поле code: текст error предназначен для показа человеку и может меняться.
code
Значение
Что делать
not_found
Кода не существует или он недействителен
Окончательно
already_claimed
Код уже использован
Окончательно; подробности — через /pub/v1/card
revoked
Код отозван продавцом
Окончательно
in_progress
По коду уже идёт активация
Вторую не создавать — см. раздел 6
queued_exists
Код уже стоит в очереди
Дождаться или снять очередь
reload_needed
Этот код активируется по сессии аккаунта, а не по ID
Использовать методы раздела 8
out_of_stock
Временно нет в наличии
Повторить позже
transient
Временная ошибка сервиса
Повторить через 30–60 с (для activate — по правилам раздела 6)
not_queued
Кода нет в очереди — снимать нечего
Окончательно
cancel_failed
Не удалось снять код с очереди
Повторить через минуту
bad_request
Некорректное тело запроса или формат поля
Исправить запрос
unauthorized
Неверный или отсутствующий ключ (HTTP 401)
Проверить X-API-Key
rate_limited
Слишком частые запросы (HTTP 429)
Пауза не меньше минуты, снизить частоту
error
Прочая ошибка
Повторить позже; если повторяется — напишите нам
4. Виды кодов и способы активации
Способ активации определяется видом кода. Смотрите на начало кода:
Вид кода
Как выглядит
Что нужно от покупателя
Методы
По ID аккаунта
36 символов: CLAUDE-PRO-…, CLAUDE-MAX-5-…, CLAUDE-MAX-20-…, GPT-PLUS-…, GPT-PRO-5-…, GROK-… либо XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
ID аккаунта (UUID)
/pub/v1/* разделы 5–7
По ID аккаунта, с очередью
16 символов или PLUS- + 16 символов: PLUS-T7G2KNTRYCDDWX4L
ID аккаунта — всегда UUID из 36 символов в нижнем регистре:
· Claude — Organization ID (claude.ai → Settings → Account);
· ChatGPT — Account ID (поле id в блоке account на странице chatgpt.com/api/auth/session);
· Grok — User ID.
vendor — claude, chatgpt или grok. Для кодов с названием продукта в начале (CLAUDE-…, GPT-…, GROK-…) продукт определяется по самому коду, и vendor можно не передавать. Для остальных кодов по умолчанию считается claude — для ChatGPT и Grok передавайте vendor явно.
5. Активация по ID аккаунта: порядок работы
1.(необязательно)/pub/v1/health — если по нужному продукту статус down, активацию лучше отложить. 2./pub/v1/activate — код и ID аккаунта. В ответе task_id и status. 3.Сразу сохраните task_id рядом с заказом — по нему вы узнаёте результат. 4. Если status уже done — подписка выдана, опрашивать не нужно. 5. Иначе опрашивайте /pub/v1/task раз в 3–5 с до done или failed. 6.queued (только коды с очередью) — активация ждёт поступления и выполнится сама; если ждать не нужно, снимите её через /pub/v1/cancel-queue, иначе код спишется позже. 7. Если по Claude пришёл failed, а код при этом израсходован, подписку можно довести через /pub/v1/refresh по Session Key покупателя.
Статусы активации: running — выполняется, либо результат пока неизвестен; queued — ждёт в очереди (с полем queue_position); done — подписка выдана; failed — подписка не выдана.
Конечные только done и failed. running — это не отказ: продолжайте опрос. Разумный предел ожидания — 5 минут; дальше проверьте код через /pub/v1/card.
6. Повторы и обрывы связи
Не повторяйте activate вслепую. Если ответ не дошёл (таймаут, обрыв связи, HTTP 502), активация могла уже создаться. Сначала выясните состояние кода.
Что делать, если ответа на activate нет: 1. Вызовите /pub/v1/card с этим кодом. 2. Пришло activating:true и task_id → активация уже создана: опрашивайте этот task_id, новую не создавайте. 3. Пришло activating:false и status:"valid" → код цел, активации не было — можно повторить.
Ответ in_progress означает, что по коду уже идёт активация. Если это ваш же повтор на тот же аккаунт — вернётся та же активация как успех (ok:true с прежним task_id). Если активация создана на другой аккаунт, придёт отказ.
Что значит failed для кода. У кодов с очередью код при неудаче возвращается и остаётся рабочим — его можно активировать снова. У остальных кодов возможны оба исхода, поэтому проверьте /pub/v1/card: valid — код цел, повторите активацию; used, а подписки нет — для Claude используйте /pub/v1/refresh, в остальных случаях напишите нам с task_id.
7. Справочник методов /pub/v1
POST/pub/v1/activate
Создать активацию кода на аккаунт покупателя.
Поле
Тип
Описание
card_key
строка, обязательно
Код активации. Регистр не важен
account
строка, обязательно
ID аккаунта покупателя, UUID в нижнем регистре (раздел 4)
vendor
строка
claude (по умолчанию), chatgpt, grok
// запрос
{"card_key":"CLAUDE-PRO-7KQ2M9XW4TRBZ8HNE5DJ6FGPAC","account":"a63cfbd2-1c4e-4b8a-9d2f-5e7a8b9c0d1e"}
// ответ
{"ok":true,"task_id":"0f8a6d64-…","status":"running","product":"Pro"}
status — running, queued или сразу done. product — тариф, может быть пустым.
Отказы: bad_request, not_found, already_claimed, revoked, in_progress, queued_exists, reload_needed, out_of_stock, transient.
queue_position приходит, только пока активация стоит в очереди. Пустой task_id — это bad_request, а не «провал активации». Как только метод вернул конечный статус, он сразу же попадает и в вашу историю (/pub/v1/activations).
POST/pub/v1/card
Один код подробно: его статус и идёт ли по нему активация. Главный инструмент восстановления после обрыва связи.
status — как в /pub/v1/check (таблица ниже). activating:true означает, что активация по коду сейчас выполняется — опрашивайте task_id. Если активация уже завершилась, activating будет false, а в task_id и task_status останется последняя активация и её итог (done или failed).
POST/pub/v1/check
Статусы кодов пакетом (до 100 за запрос), без активации.
Ответа по коду не было — это не приговор коду, перепроверьте позже
Различайте invalid и unknown: первое — окончательно, второе — лишь отсутствие ответа. Ориентируйтесь на статус каждого элемента. Дубликаты и коды неверного формата отбрасываются, поэтому сопоставляйте элементы по полю card_key, а не по порядку.
POST/pub/v1/cancel-queue
Снять активацию с очереди и освободить код. Только для кодов с очередью.
Активация из очереди выполнится сама, как только подойдёт её очередь, и код будет израсходован. Если заказ отменён или покупатель не готов ждать — очередь нужно снять. Отказы: not_queued, cancel_failed, already_claimed, not_found, revoked.
POST/pub/v1/refresh
Довести подписку Claude по Session Key покупателя, если код израсходован, а подписка не появилась.
session_key — значение куки sessionKey с домена claude.ai. task_id передавать не нужно: активация находится по коду. Если активации по коду не было → not_found.
POST/pub/v1/stock
Наличие.
{"vendor":"claude"}
→ {"ok":true,"products":[{"name":"Pro","level":"high","count":1169}]}
{"vendor":"chatgpt","queue":true} // коды с очередью
→ {"ok":true,"availability":"plenty","queued":0}
level: high / normal / low / none. availability: plenty / normal / low / none. queued — длина очереди.
POST/pub/v1/health
Проходят ли активации прямо сейчас — отдельно по каждому продукту.
chatgpt_queue — коды ChatGPT с очередью (раздел 4). ok — активации проходят · degraded — часть не проходит · down — не проходят, лучше отложить · unknown — мало данных. rate — доля успешных за последний час, samples — на скольких активациях она посчитана. Это статистика недавних реальных активаций, а не самопроверка: сбой нельзя предсказать заранее, но он виден в первые минуты.
POST/pub/v1/account
Проверить подписку ChatGPT на аккаунте, без активации.
Пустой items означает именно отсутствие активаций: при недоступности сервиса придёт ошибка transient, а не пустой список.
POST/pub/v1/activations
История ваших активаций (по вашему ключу), новые сверху.
{} // последние 200
{"limit":500} // до 1000
→ {"ok":true,"mode":"partner","items":[
{"ts":"2026-10-21T05:00:00","updated":"2026-10-21T05:00:04","vendor":"claude",
"card":"CLAUDE-PRO-7KQ2M9XW…","account":"a63cfbd2-…","task_id":"0f8a6d64-…",
"status":"done","product":"Pro"}]}
status
Значение
created
Активация создана, результат ещё не получен
queued
Ждёт в очереди
done
Подписка выдана
failed
Подписка не выдана
timeout
Результат не подтвердился за отведённое время; статус ещё может смениться на done или failed
В поле card — код в том виде, в каком вы его прислали. Статусы в истории обновляются сами, опрашивать каждую активацию отдельно для этого не нужно. Но для результата конкретного заказа используйте /pub/v1/task — он отвечает точнее и быстрее. ts — когда активация создана, updated — когда статус менялся последний раз; время московское (UTC+3).
С параметром cdk метод возвращает историю одного кода, активируемого по сессии (раздел 8):
Коды PLUS-PH-…, GO-EG-…, 5X-…, 20X-…, 50X-… (ChatGPT Plus, Go и Pro) и MAX5-…, MAX20-…, CPRO-… (Claude Max и Pro) — активируются по сессии аккаунта покупателя, в два шага с подтверждением. Через /pub/v1/activate они не проходят: вернётся reload_needed.
Чем этот способ отличается:
· вместо ID аккаунта нужна сессия покупателя: для ChatGPT — полный JSON со страницы chatgpt.com/api/auth/session, открытой в том же браузере, где выполнен вход; для Claude — значение куки sessionKey с домена claude.ai (начинается с sk-ant-sid);
· активация идёт минуты, а не секунды: обычно 2–3, в часы нагрузки дольше;
· заказ защищён парой order_id + secret из ответа activate — сохраните обе строки, без secret статус не узнать;
· сессия — это доступ к аккаунту покупателя: передавайте её только по HTTPS и не храните дольше, чем нужно для активации.
1.(необязательно)/pub/v1/session/check — проверить код, не расходуя его. 2./pub/v1/session/activate — код и сессия → order_id и secret. 3. Опрашивайте /pub/v1/session/order раз в 2–5 с. 4. Если пришёл state:"wait_confirm" — покажите покупателю почту аккаунта и тариф из ответа и после его согласия вызовите /pub/v1/session/confirm. На подтверждение даётся ограниченное время (поле confirm_expires_at, обычно около 150 с). Для части кодов этот шаг не требуется — заказ сам перейдёт к выполнению. 5. Продолжайте опрос до done:true и смотрите state.
Повтор с теми же кодом и сессией безопасен: вернётся тот же заказ (duplicate:true).
Аккаунт уже с подпиской → {"ok":true,"state":"already_active",…}.
Только для кодов ChatGPT: если действующая подписка ниже тарифа кода (например, Go при коде Plus), вместо этого придёт отказ upgrade_confirm с текущим и новым тарифом и сроком действующей подписки. Покажите их покупателю и после его согласия повторите запрос с "upgrade_ok":true — подписка будет улучшена до тарифа кода, дальше заказ идёт как обычно. Улучшение возможно не для каждого аккаунта: если выполнить его нельзя, заказ завершится состоянием already_active, код останется цел.
Сервис подписки просит покупателя подтвердить личность
—
Передать покупателю kyc_url
already_paid_external
У аккаунта подписка, оформленная через магазин приложений
да
Другой аккаунт
email_unverified
Почта аккаунта не подтверждена
да
Подтвердить почту и повторить
account_rejected
Сервис подписки не принимает оплату на этом аккаунте
да
Скорее всего, нужен другой аккаунт; с этим можно повторить через 20 минут. Если отказ повторился — только другой аккаунт
needs_review, manual
Результат проверяет оператор
—
Не повторять; дождаться или написать нам с order_id
blocked, canceled
Заказ остановлен до оплаты
да
Начать заново
not_found
Заказ не найден или неверный secret
—
Проверить пару order_id + secret
Новые значения state могут добавляться. Правило для неизвестного значения: done:false — продолжать опрос, done:true — показать покупателю нейтральное «не удалось, попробуйте ещё раз» и проверить код через /pub/v1/session/check.
9. Fortnite Crew
Коды FN-CREW-… активируют подписку Fortnite Crew на аккаунт Epic Games покупателя. Покупатель входит в свой аккаунт сам — пароль никому не передаётся. Ключ тот же, что и для остальных методов.
1. Получите подтверждение входа одним из двух способов:
· по ссылке — /pub/v1/fortnite/login/start выдаёт ссылку и короткий код; покупатель открывает ссылку, входит в Epic Games и подтверждает код, а вы опрашиваете /pub/v1/fortnite/login/poll;
· кодом авторизации — покупатель сам получает authorizationCode на странице Epic Games и передаёт вам; вы вызываете /pub/v1/fortnite/inspect. 2. В обоих случаях приходят inspection_key и данные аккаунта — покажите их покупателю, чтобы он убедился, что аккаунт тот. 3./pub/v1/fortnite/activate — код и inspection_key → task_id. 4. Опрашивайте /pub/v1/task раз в 3–5 с до done или failed (раздел 5).
Отказы: bad_request, not_found, already_claimed, revoked, in_progress, transient. Правила повторов — как в разделе 6. Обычно подписка появляется в течение нескольких минут.
code
Значение
Что делать
epic_auth
Ссылка входа или код авторизации устарели
Получить вход заново (шаг 1) и повторить
epic_account
Epic Games не подтвердил данные аккаунта
Получить вход заново и повторить
epic_banned
Аккаунт Epic Games заблокирован
Нужен другой аккаунт
epic_noplay
У аккаунта нет доступа к Fortnite
Нужен другой аккаунт
unavailable
Активация Fortnite временно недоступна
Повторить позже
10. Ограничения и рекомендации
Одновременные активации
Параллельно выполняются две активации /pub/v1/activate; остальные запросы ждут своей очереди внутри того же вызова — ничего не теряется, просто ответ приходит позже
Опрос /pub/v1/task
Раз в 3–5 с; чаще не нужно и результат не ускорит
Пакет проверки
До 100 кодов за один /pub/v1/check; проверки выполняются по одной, большие пакеты отвечают дольше
История
До 1000 записей за один /pub/v1/activations
Превышение частоты
HTTP 429 и code:"rate_limited" — пауза не меньше минуты
Время
Отметки времени без указания часового пояса — московские (UTC+3)
Неизвестные поля
В ответах могут появляться новые поля — игнорируйте незнакомые, не считайте их ошибкой
Храните у себя по каждому заказу: код, аккаунт, task_id (или order_id + secret) и последний статус. При обращении к нам присылайте task_id или order_id — по ним мы находим активацию сразу.
11. Пример интеграции
Полный цикл одного заказа с защитой от повторного списания (псевдокод):
BASE = "https://pay2cdkey.com"
H = {"Content-Type": "application/json", "X-API-Key": KEY}
# 1. активация; при обрыве связи НЕ повторяем вслепую
try:
r = post(BASE + "/pub/v1/activate",
{"card_key": code, "account": buyer_account}, headers=H, timeout=90).json()
except (Timeout, ConnectionError):
c = post(BASE + "/pub/v1/card", {"card_key": code}, headers=H).json()
if c.get("activating"):
r = {"ok": True, "task_id": c["task_id"], "status": "running"} # продолжаем ту же
elif c.get("status") == "valid":
return retry_later() # код цел
else:
return manual_check(order, c) # used без активации — разобрать
if not r["ok"]:
if r["code"] in ("not_found", "already_claimed", "revoked", "bad_request"):
return fail_order(r["error"]) # окончательно
return retry_later() # transient / out_of_stock / in_progress
save_task_id(order, r["task_id"]) # сохранить СРАЗУ
status = r["status"]
# 2. опрос до конечного статуса, не дольше 5 минут
deadline = now() + 300
while status not in ("done", "failed") and now() < deadline:
sleep(4)
t = post(BASE + "/pub/v1/task", {"task_id": r["task_id"]}, headers=H).json()
if t["ok"]:
status = t["status"] # queued / running — продолжаем
if status == "done":
return deliver(order)
if status == "failed":
return handle_failure(order) # раздел 6: проверить код через /pub/v1/card
return check_later(order) # результат пока неизвестен — перепроверить позже
Terminal API
Programmatic activation of Claude, ChatGPT, Grok, and Fortnite Crew subscriptions on the buyer's account. Everything you need for integration is here: the types of codes, the call sequence, statuses, protection against double charging, and a method reference with examples.
A minimal integration needs two methods: create an activation and wait for it to complete.
# 1. activate a code on the buyer's account
curl -X POST https://pay2cdkey.com/pub/v1/activate \
-H "Content-Type: application/json" -H "X-API-Key: YOUR_KEY" \
-d '{"card_key":"CLAUDE-PRO-7KQ2M9XW4TRBZ8HNE5DJ6FGPAC","account":"a63cfbd2-1c4e-4b8a-9d2f-5e7a8b9c0d1e"}'
# → {"ok":true,"task_id":"0f8a6d64-…","status":"running","product":"Pro"}
# 2. poll the status every 3–5 seconds until done or failed arrives
curl -X POST https://pay2cdkey.com/pub/v1/task \
-H "Content-Type: application/json" -H "X-API-Key: YOUR_KEY" \
-d '{"task_id":"0f8a6d64-…"}'
# → {"ok":true,"status":"done","product":"Pro"}
An activation usually completes within a few seconds. The done status may already arrive in the response to activate — in that case there is no need to poll.
2. Base URL and authentication
https://pay2cdkey.com
All methods are POST; the request body and the response are JSON in UTF-8.
Headers: Content-Type: application/json and X-API-Key: YOUR_KEY.
The key is issued individually and is valid for all /pub/v1 methods. Your activation history is kept per key, so do not share the key with third parties and do not embed it in code that runs in the buyer's browser. If the key may have leaked, let us know and we will issue a new one.
Client timeout: set it to at least 90 seconds. Most responses arrive within 1–3 seconds, but creating an activation occasionally takes up to a minute.
Check the ok field, not just the HTTP code. A business-level error (for example, “code already used”) comes with HTTP 200 and ok:false. The HTTP code reflects the transport only: 401 — invalid key, 429 — requests too frequent, 502 — service temporarily unavailable (the body still contains the same JSON, with code:"transient"). Build your logic on the code field: the error text is meant to be shown to a person and may change.
code
Meaning
What to do
not_found
The code does not exist or is invalid
Final
already_claimed
The code has already been used
Final; details via /pub/v1/card
revoked
The code has been revoked by the seller
Final
in_progress
An activation for this code is already in progress
Do not create a second one — see section 6
queued_exists
The code is already in the queue
Wait, or remove it from the queue
reload_needed
This code is activated by account session, not by ID
Use the methods from section 8
out_of_stock
Temporarily out of stock
Retry later
transient
Temporary service error
Retry in 30–60 s (for activate — follow the rules in section 6)
not_queued
The code is not in the queue — there is nothing to remove
Final
cancel_failed
Failed to remove the code from the queue
Retry in a minute
bad_request
Malformed request body or field format
Fix the request
unauthorized
Invalid or missing key (HTTP 401)
Check X-API-Key
rate_limited
Requests too frequent (HTTP 429)
Pause for at least a minute and lower the request rate
error
Other error
Retry later; if it keeps happening, contact us
4. Code types and activation flows
The activation flow is determined by the code type. Look at how the code starts:
Code type
What it looks like
What is needed from the buyer
Methods
By account ID
36 characters: CLAUDE-PRO-…, CLAUDE-MAX-5-…, CLAUDE-MAX-20-…, GPT-PLUS-…, GPT-PRO-5-…, GROK-… or XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
Account ID (UUID)
/pub/v1/* sections 5–7
By account ID, with a queue
16 characters, or PLUS- + 16 characters: PLUS-T7G2KNTRYCDDWX4L
Account ID (UUID)
/pub/v1/*, the queued status is possible
By account session
of the form: PLUS-PH-…, GO-EG-…, 5X-…, 20X-…, 50X-…, MAX5-…, MAX20-…, CPRO-…
Account session and the buyer's confirmation
/pub/v1/session/* section 8
Fortnite Crew
FN-CREW-…
The buyer signs in to their own Epic Games account
/pub/v1/fortnite/* section 9
Account ID — always a 36-character lowercase UUID:
· Claude — Organization ID (claude.ai → Settings → Account);
· ChatGPT — Account ID (the id field in the account block on the chatgpt.com/api/auth/session page);
· Grok — User ID.
vendor — claude, chatgpt, or grok. For codes that start with the product name (CLAUDE-…, GPT-…, GROK-…), the product is determined from the code itself, and vendor may be omitted. For all other codes the default is claude — for ChatGPT and Grok, pass vendor explicitly.
5. Activation by account ID: step by step
1.(optional)/pub/v1/health — if the status for the product you need is down, it is better to postpone the activation. 2./pub/v1/activate — the code and the account ID. The response contains task_id and status. 3.Immediately save the task_id alongside the order — you use it to find out the result. 4. If status is already done, the subscription has been granted and there is no need to poll. 5. Otherwise, poll /pub/v1/task every 3–5 s until done or failed. 6.queued (codes with a queue only) — the activation is waiting for stock to arrive and will run on its own; if there is no need to wait, remove it via /pub/v1/cancel-queue, otherwise the code will be consumed later. 7. If a Claude activation returns failed while the code has been consumed, the subscription can be finalized via /pub/v1/refresh using the buyer's Session Key.
Activation statuses: running — in progress, or the result is not yet known; queued — waiting in the queue (with the queue_position field); done — subscription granted; failed — subscription not granted.
Only done and failed are final. running is not a failure: keep polling. A reasonable waiting limit is 5 minutes; after that, check the code via /pub/v1/card.
6. Retries and connection drops
Do not retry activate blindly. If the response did not arrive (timeout, connection drop, HTTP 502), the activation may already have been created. Find out the state of the code first.
What to do if there is no response to activate: 1. Call /pub/v1/card with this code. 2. You got activating:true and a task_id → the activation has already been created: poll this task_id, do not create a new one. 3. You got activating:false and status:"valid" → the code is intact and no activation took place — you can retry.
The in_progress response means that an activation for the code is already in progress. If it is your own retry for the same account, the same activation is returned as a success (ok:true with the previous task_id). If the activation was created for a different account, an error is returned.
What failed means for the code. For codes with a queue, the code is returned on failure and remains usable — it can be activated again. For other codes both outcomes are possible, so check /pub/v1/card: valid — the code is intact, retry the activation; used but there is no subscription — for Claude use /pub/v1/refresh, in other cases contact us with the task_id.
7. Method reference for /pub/v1
POST/pub/v1/activate
Create an activation of a code on the buyer's account.
Field
Type
Description
card_key
string, required
Activation code. Case-insensitive
account
string, required
The buyer's account ID, a lowercase UUID (section 4)
status — running, queued, or done right away. product — the plan; may be empty.
Errors: bad_request, not_found, already_claimed, revoked, in_progress, queued_exists, reload_needed, out_of_stock, transient.
queue_position is returned only while the activation is in the queue. An empty task_id is a bad_request, not a “failed activation”. As soon as the method returns a final status, that status immediately appears in your history as well (/pub/v1/activations).
POST/pub/v1/card
A single code in detail: its status and whether an activation for it is in progress. The main tool for recovery after a connection drop.
status — the same as in /pub/v1/check (table below). activating:true means that an activation for the code is running right now — poll the task_id. If the activation has already finished, activating will be false, while task_id and task_status keep the last activation and its outcome (done or failed).
POST/pub/v1/check
Code statuses in a batch (up to 100 per request), without activation.
No response was received for the code — this is not a verdict on the code; recheck later
Distinguish invalid from unknown: the former is final, the latter is merely the absence of a response. Go by the status of each item. Duplicates and malformed codes are dropped, so match items by the card_key field, not by order.
POST/pub/v1/cancel-queue
Remove an activation from the queue and release the code. Only for codes with a queue.
A queued activation will run on its own as soon as its turn comes, and the code will be consumed. If the order has been canceled or the buyer is not willing to wait, the activation must be removed from the queue. Errors: not_queued, cancel_failed, already_claimed, not_found, revoked.
POST/pub/v1/refresh
Finalize a Claude subscription using the buyer's Session Key when the code has been consumed but the subscription has not appeared.
session_key — the value of the sessionKey cookie from the claude.ai domain. There is no need to pass task_id: the activation is found by the code. If there was no activation for the code → not_found.
POST/pub/v1/stock
Stock availability.
{"vendor":"claude"}
→ {"ok":true,"products":[{"name":"Pro","level":"high","count":1169}]}
{"vendor":"chatgpt","queue":true} // codes with a queue
→ {"ok":true,"availability":"plenty","queued":0}
level: high / normal / low / none. availability: plenty / normal / low / none. queued — queue length.
POST/pub/v1/health
Whether activations are going through right now — separately for each product.
chatgpt_queue — ChatGPT codes with a queue (section 4). ok — activations are going through · degraded — some are not going through · down — not going through, better to postpone · unknown — not enough data. rate — the share of successful activations over the last hour, samples — the number of activations it was calculated from. These are statistics on recent real activations, not a self-check: an outage cannot be predicted in advance, but it shows up within the first minutes.
POST/pub/v1/account
Check the ChatGPT subscription on an account, without activation.
An empty items means precisely that there are no activations: if the service is unavailable, a transient error is returned, not an empty list.
POST/pub/v1/activations
History of your activations (by your key), newest first.
{} // the last 200
{"limit":500} // up to 1000
→ {"ok":true,"mode":"partner","items":[
{"ts":"2026-10-21T05:00:00","updated":"2026-10-21T05:00:04","vendor":"claude",
"card":"CLAUDE-PRO-7KQ2M9XW…","account":"a63cfbd2-…","task_id":"0f8a6d64-…",
"status":"done","product":"Pro"}]}
status
Meaning
created
The activation has been created, the result has not been received yet
queued
Waiting in the queue
done
Subscription granted
failed
Subscription not granted
timeout
The result was not confirmed within the allotted time; the status may still change to done or failed
The card field holds the code exactly as you sent it. Statuses in the history update on their own, so there is no need to poll each activation separately for that. But for the result of a specific order, use /pub/v1/task — it responds more accurately and faster. ts — when the activation was created, updated — when the status last changed; times are in Moscow time (UTC+3).
With the cdk parameter, the method returns the history of a single code that is activated by session (section 8):
Codes PLUS-PH-…, GO-EG-…, 5X-…, 20X-…, 50X-… (ChatGPT Plus, Go, and Pro) and MAX5-…, MAX20-…, CPRO-… (Claude Max and Pro) — are activated by the buyer's account session, in two steps with a confirmation. They do not go through /pub/v1/activate: reload_needed is returned.
How this flow differs:
· instead of an account ID, the buyer's session is needed: for ChatGPT — the full JSON from the chatgpt.com/api/auth/session page, opened in the same browser where the account is logged in; for Claude — the value of the sessionKey cookie from the claude.ai domain (it starts with sk-ant-sid);
· activation takes minutes, not seconds: usually 2–3, longer during peak hours;
· the order is protected by the order_id + secret pair from the activate response — save both strings; without secret the status cannot be retrieved;
· the session is access to the buyer's account: transmit it only over HTTPS and do not store it longer than the activation requires.
1.(optional)/pub/v1/session/check — check the code without consuming it. 2./pub/v1/session/activate — the code and the session → order_id and secret. 3. Poll /pub/v1/session/order every 2–5 s. 4. If state:"wait_confirm" arrives, show the buyer the account email and the plan from the response and, once the buyer agrees, call /pub/v1/session/confirm. The time for confirmation is limited (the confirm_expires_at field, usually about 150 s). For some codes this step is not required — the order proceeds to execution on its own. 5. Keep polling until done:true and look at state.
Retrying with the same code and session is safe: the same order is returned (duplicate:true).
The account already has a subscription → {"ok":true,"state":"already_active",…}.
ChatGPT codes only: if the active subscription is below the plan of the code (for example, Go with a Plus code), an upgrade_confirm refusal is returned instead, with the current plan, the new plan, and the end date of the active subscription. Show them to the buyer and, once the buyer agrees, repeat the request with "upgrade_ok":true — the subscription will be upgraded to the plan of the code, and the order then proceeds as usual. An upgrade is not possible for every account: if it cannot be done, the order ends with the already_active state and the code stays intact.
Order states (state). Intermediate (done:false) — keep polling: queued — in the queue · login — logging in to the account · wait_confirm — waiting for the buyer's confirmation · running, paying, verifying — the order is being executed.
Final state
Meaning
Code intact?
What to do
success, paid
Subscription granted
consumed
Done
already_active
The account already has a subscription
yes
Use a different account or wait until the subscription ends
declined
The payment did not go through
yes
Retry with the same code
retry_later
A temporary limitation on our side
yes
Retry with the same code in a few minutes
account_busy
Another order is already being executed on this account
yes
Wait for it to finish and retry
session_expired, not_logged_in
The session is no longer valid
yes
Get a fresh session and retry
confirm_timeout
The buyer did not confirm in time
yes
Start over
kyc
The subscription service asks the buyer to verify their identity
—
Pass kyc_url to the buyer
already_paid_external
The account has a subscription purchased through an app store
yes
Use a different account
email_unverified
The account email is not verified
yes
Verify the email and retry
account_rejected
The subscription service does not accept payment on this account
yes
A different account is most likely needed; this one can be retried in 20 minutes. If it is refused again, only a different account will work
needs_review, manual
The result is being checked by an operator
—
Do not retry; wait, or contact us with the order_id
blocked, canceled
The order was stopped before payment
yes
Start over
not_found
The order was not found, or the secret is wrong
—
Check the order_id + secret pair
New state values may be added. The rule for an unknown value: done:false — keep polling; done:true — show the buyer a neutral “failed, please try again” and check the code via /pub/v1/session/check.
9. Fortnite Crew
FN-CREW-… codes activate a Fortnite Crew subscription on the buyer's Epic Games account. The buyer signs in to their account themselves — the password is never shared with anyone. The key is the same as for all other methods.
1. Get the sign-in confirmed in one of two ways:
· by link — /pub/v1/fortnite/login/start returns a link and a short code; the buyer opens the link, signs in to Epic Games and confirms the code, while you poll /pub/v1/fortnite/login/poll;
· by authorization code — the buyer obtains an authorizationCode on the Epic Games page and passes it to you; you call /pub/v1/fortnite/inspect. 2. Either way you receive an inspection_key and the account details — show them to the buyer so they can make sure it is the right account. 3./pub/v1/fortnite/activate — the code and inspection_key → task_id. 4. Poll /pub/v1/task every 3–5 s until done or failed (section 5).
Pass verify_url and user_code to the buyer. The link is valid for expires_in seconds (usually three minutes); if the buyer did not make it in time, start again.
pending — waiting for the sign-in · authorized — sign-in confirmed, you can activate · expired — time is up · error, inspect_failed — it did not work, start again.
POST/pub/v1/fortnite/inspect
Check an authorization code the buyer obtained manually. The activation code is not consumed.
Refusals: bad_request, not_found, already_claimed, revoked, in_progress, transient. Retry rules are the same as in section 6. The subscription usually appears within a few minutes.
code
Meaning
What to do
epic_auth
The sign-in link or authorization code has expired
Get the sign-in again (step 1) and retry
epic_account
Epic Games did not confirm the account details
Get the sign-in again and retry
epic_banned
The Epic Games account is banned
A different account is needed
epic_noplay
The account has no access to Fortnite
A different account is needed
unavailable
Fortnite activation is temporarily unavailable
Retry later
10. Limits and recommendations
Concurrent activations
Two /pub/v1/activate activations run in parallel; the remaining requests wait their turn inside the same call — nothing is lost, the response just arrives later
Polling /pub/v1/task
Every 3–5 s; more often is unnecessary and will not speed up the result
Check batch
Up to 100 codes per /pub/v1/check call; checks run one at a time, so large batches take longer to respond
History
Up to 1000 records per /pub/v1/activations call
Rate limit exceeded
HTTP 429 and code:"rate_limited" — pause for at least a minute
Time
Timestamps without an explicit time zone are Moscow time (UTC+3)
Unknown fields
New fields may appear in responses — ignore unfamiliar ones and do not treat them as an error
For each order, keep on your side: the code, the account, the task_id (or order_id + secret), and the last status. When you contact us, send the task_id or order_id — with them we find the activation right away.
11. Integration example
The full cycle of a single order with protection against a repeat charge (pseudocode):
BASE = "https://pay2cdkey.com"
H = {"Content-Type": "application/json", "X-API-Key": KEY}
# 1. activation; on a connection drop we do NOT retry blindly
try:
r = post(BASE + "/pub/v1/activate",
{"card_key": code, "account": buyer_account}, headers=H, timeout=90).json()
except (Timeout, ConnectionError):
c = post(BASE + "/pub/v1/card", {"card_key": code}, headers=H).json()
if c.get("activating"):
r = {"ok": True, "task_id": c["task_id"], "status": "running"} # continue the same one
elif c.get("status") == "valid":
return retry_later() # the code is intact
else:
return manual_check(order, c) # used without an activation — investigate
if not r["ok"]:
if r["code"] in ("not_found", "already_claimed", "revoked", "bad_request"):
return fail_order(r["error"]) # final
return retry_later() # transient / out_of_stock / in_progress
save_task_id(order, r["task_id"]) # save IMMEDIATELY
status = r["status"]
# 2. poll until a final status, no longer than 5 minutes
deadline = now() + 300
while status not in ("done", "failed") and now() < deadline:
sleep(4)
t = post(BASE + "/pub/v1/task", {"task_id": r["task_id"]}, headers=H).json()
if t["ok"]:
status = t["status"] # queued / running — keep polling
if status == "done":
return deliver(order)
if status == "failed":
return handle_failure(order) # section 6: check the code via /pub/v1/card
return check_later(order) # the result is not yet known — recheck later
BASE = "https://pay2cdkey.com"
H = {"Content-Type": "application/json", "X-API-Key": KEY}
# 1. 激活;连接中断时不要盲目重试
try:
r = post(BASE + "/pub/v1/activate",
{"card_key": code, "account": buyer_account}, headers=H, timeout=90).json()
except (Timeout, ConnectionError):
c = post(BASE + "/pub/v1/card", {"card_key": code}, headers=H).json()
if c.get("activating"):
r = {"ok": True, "task_id": c["task_id"], "status": "running"} # 继续同一个激活
elif c.get("status") == "valid":
return retry_later() # 激活码完好
else:
return manual_check(order, c) # used 但没有激活,需排查
if not r["ok"]:
if r["code"] in ("not_found", "already_claimed", "revoked", "bad_request"):
return fail_order(r["error"]) # 最终结果
return retry_later() # transient / out_of_stock / in_progress
save_task_id(order, r["task_id"]) # 立即保存
status = r["status"]
# 2. 轮询直到终态,最长 5 分钟
deadline = now() + 300
while status not in ("done", "failed") and now() < deadline:
sleep(4)
t = post(BASE + "/pub/v1/task", {"task_id": r["task_id"]}, headers=H).json()
if t["ok"]:
status = t["status"] # queued / running:继续轮询
if status == "done":
return deliver(order)
if status == "failed":
return handle_failure(order) # 第 6 节:通过 /pub/v1/card 检查激活码
return check_later(order) # 结果暂时未知,稍后再检查
API ترمینال
فعالسازی برنامهنویسیشدهٔ اشتراکهای Claude، ChatGPT، Grok و Fortnite Crew روی حساب خریدار. هر آنچه برای یکپارچهسازی لازم است اینجاست: انواع کدها، ترتیب فراخوانیها، وضعیتها، محافظت در برابر کسر دوباره و مرجع متدها همراه با مثال.
یکپارچهسازی حداقلی فقط دو متد لازم دارد: ایجاد فعالسازی و انتظار برای پایان آن.
# 1. فعالسازی کد روی حساب خریدار
curl -X POST https://pay2cdkey.com/pub/v1/activate \
-H "Content-Type: application/json" -H "X-API-Key: کلید_شما" \
-d '{"card_key":"CLAUDE-PRO-7KQ2M9XW4TRBZ8HNE5DJ6FGPAC","account":"a63cfbd2-1c4e-4b8a-9d2f-5e7a8b9c0d1e"}'
# → {"ok":true,"task_id":"0f8a6d64-…","status":"running","product":"Pro"}
# 2. پرسوجوی دورهای وضعیت، هر 3 تا 5 ثانیه یک بار، تا وقتی done یا failed برگردد
curl -X POST https://pay2cdkey.com/pub/v1/task \
-H "Content-Type: application/json" -H "X-API-Key: کلید_شما" \
-d '{"task_id":"0f8a6d64-…"}'
# → {"ok":true,"status":"done","product":"Pro"}
فعالسازی معمولاً ظرف چند ثانیه تمام میشود. وضعیت done ممکن است در همان پاسخ activate برگردد — در این صورت نیازی به پرسوجوی دورهای نیست.
2. URL پایه و احراز هویت
https://pay2cdkey.com
همهٔ متدها POST هستند؛ بدنهٔ درخواست و پاسخ، JSON با کدگذاری UTF-8 است.
هدرها: Content-Type: application/json و X-API-Key: کلید_شما.
کلید بهصورت اختصاصی صادر میشود و برای همهٔ متدهای /pub/v1 معتبر است. تاریخچهٔ فعالسازیهای شما بر اساس کلید نگهداری میشود؛ بنابراین آن را در اختیار اشخاص ثالث نگذارید و در کدی که در مرورگر خریدار اجرا میشود قرار ندهید. اگر احتمال میدهید کلید لو رفته باشد، به ما اطلاع دهید تا کلید جدیدی صادر کنیم.
تایماوت کلاینت را دستکم 90 ثانیه تنظیم کنید: بیشتر پاسخها ظرف 1 تا 3 ثانیه میرسند، اما ایجاد فعالسازی گاهی تا یک دقیقه طول میکشد.
فیلد ok را بررسی کنید، نه فقط کد HTTP را. خطای کسبوکاری (مثلاً «کد قبلاً استفاده شده است») با HTTP 200 و ok:false برمیگردد. کد HTTP فقط وضعیت لایهٔ انتقال را نشان میدهد: 401 — کلید نادرست، 429 — درخواستهای بیش از حد پرتکرار، 502 — سرویس موقتاً در دسترس نیست (در این حالت هم همان JSON با code:"transient" در بدنه میآید). منطق خود را بر پایهٔ فیلد code بسازید: متن error برای نمایش به انسان است و ممکن است تغییر کند.
code
معنا
چه باید کرد
not_found
کد وجود ندارد یا نامعتبر است
قطعی
already_claimed
کد قبلاً استفاده شده است
قطعی؛ جزئیات از طریق /pub/v1/card
revoked
فروشنده کد را باطل کرده است
قطعی
in_progress
برای این کد هماکنون یک فعالسازی در جریان است
فعالسازی دوم ایجاد نکنید — بخش 6 را ببینید
queued_exists
کد هماکنون در صف است
منتظر بمانید یا آن را از صف خارج کنید
reload_needed
این کد با نشست حساب فعال میشود، نه با شناسه
از متدهای بخش 8 استفاده کنید
out_of_stock
موقتاً موجود نیست
بعداً دوباره تلاش کنید
transient
خطای موقت سرویس
پس از 30 تا 60 ثانیه دوباره تلاش کنید (برای activate — طبق قواعد بخش 6)
not_queued
کد در صف نیست — چیزی برای خارجکردن وجود ندارد
قطعی
cancel_failed
خارجکردن کد از صف ممکن نشد
یک دقیقهٔ دیگر دوباره تلاش کنید
bad_request
بدنهٔ درخواست یا قالب فیلد نادرست است
درخواست را اصلاح کنید
unauthorized
کلید نادرست است یا ارسال نشده (HTTP 401)
مقدار X-API-Key را بررسی کنید
rate_limited
درخواستهای بیش از حد پرتکرار (HTTP 429)
دستکم یک دقیقه صبر کنید و نرخ درخواستها را کاهش دهید
error
خطای دیگر
بعداً دوباره تلاش کنید؛ اگر تکرار شد به ما پیام دهید
4. انواع کد و روشهای فعالسازی
روش فعالسازی را نوع کد تعیین میکند. به ابتدای کد نگاه کنید:
نوع کد
شکل ظاهری
آنچه از خریدار لازم است
متدها
با شناسهٔ حساب
36 نویسه: CLAUDE-PRO-…, CLAUDE-MAX-5-…, CLAUDE-MAX-20-…, GPT-PLUS-…, GPT-PRO-5-…, GROK-… یا XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
شناسهٔ حساب (UUID)
/pub/v1/* بخشهای 5 تا 7
با شناسهٔ حساب، همراه با صف
16 نویسه یا PLUS- + 16 نویسه: PLUS-T7G2KNTRYCDDWX4L
شناسهٔ حساب (UUID)
/pub/v1/*، وضعیت queued هم ممکن است
با نشست حساب
به این شکل: PLUS-PH-…, GO-EG-…, 5X-…, 20X-…, 50X-…, MAX5-…, MAX20-…, CPRO-…
نشست حساب و تأیید خریدار
/pub/v1/session/* بخش 8
Fortnite Crew
FN-CREW-…
ورود خریدار به حساب Epic Games خودش
/pub/v1/fortnite/* بخش 9
شناسهٔ حساب — همیشه یک UUID با 36 نویسه و حروف کوچک است:
· Claude — Organization ID (claude.ai → Settings → Account)؛
· ChatGPT — Account ID (فیلد id در بلوک account در صفحهٔ chatgpt.com/api/auth/session)؛
· Grok — User ID.
vendor — claude، chatgpt یا grok. برای کدهایی که نام محصول در ابتدایشان آمده است (CLAUDE-…, GPT-…, GROK-…) محصول از روی خود کد تشخیص داده میشود و میتوان vendor را ارسال نکرد. برای بقیهٔ کدها مقدار پیشفرض claude است — برای ChatGPT و Grok مقدار vendor را صریحاً ارسال کنید.
5. فعالسازی با شناسهٔ حساب: روال کار
1.(اختیاری)/pub/v1/health — اگر وضعیت محصول موردنظر down است، بهتر است فعالسازی را به بعد موکول کنید. 2./pub/v1/activate — کد و شناسهٔ حساب. در پاسخ task_id و status میآید. 3.بلافاصله task_id را کنار سفارش ذخیره کنید — نتیجه را با همین مقدار میگیرید. 4. اگر status از همان ابتدا done است، اشتراک فعال شده و نیازی به پرسوجوی دورهای نیست. 5. در غیر این صورت، پرسوجوی دورهای /pub/v1/task را هر 3 تا 5 ثانیه یک بار انجام دهید تا done یا failed برگردد. 6.queued (فقط کدهای دارای صف) — فعالسازی منتظر رسیدن موجودی است و خودش انجام میشود؛ اگر لازم نیست منتظر بمانید، آن را با /pub/v1/cancel-queue از صف خارج کنید، وگرنه کد بعداً مصرف میشود. 7. اگر برای Claude وضعیت failed برگشت ولی کد مصرف شده است، میتوان اشتراک را از طریق /pub/v1/refresh و با Session Key خریدار تکمیل کرد.
وضعیتهای فعالسازی: running — در حال اجرا، یا نتیجه هنوز مشخص نیست؛ queued — در صف منتظر است (همراه با فیلد queue_position)؛ done — اشتراک فعال شد؛ failed — اشتراک فعال نشد.
فقط done و failed وضعیت نهایی هستند. running به معنای خطا نیست: پرسوجوی دورهای را ادامه دهید. سقف معقول انتظار 5 دقیقه است؛ پس از آن کد را با /pub/v1/card بررسی کنید.
6. تلاش مجدد و قطع ارتباط
درخواست activate را کورکورانه تکرار نکنید. اگر پاسخ نرسید (تایماوت، قطع ارتباط، HTTP 502)، ممکن است فعالسازی ایجاد شده باشد. ابتدا وضعیت کد را مشخص کنید.
اگر پاسخ activate نرسید چه باید کرد: 1. متد /pub/v1/card را با همین کد فراخوانی کنید. 2. اگر activating:true و task_id برگشت → فعالسازی از قبل ایجاد شده است: پرسوجوی دورهای را با همین task_id انجام دهید و فعالسازی جدید نسازید. 3. اگر activating:false و status:"valid" برگشت → کد سالم است و فعالسازیای انجام نشده — میتوانید دوباره تلاش کنید.
پاسخ in_progress یعنی برای این کد هماکنون یک فعالسازی در جریان است. اگر این تلاش مجدد خود شما برای همان حساب باشد، همان فعالسازی بهعنوان پاسخ موفق برمیگردد (ok:true با همان task_id قبلی). اگر فعالسازی برای حساب دیگری ایجاد شده باشد، خطا برمیگردد.
وضعیت failed برای کد چه معنایی دارد. در کدهای دارای صف، در صورت ناموفق بودن، کد برمیگردد و قابلاستفاده میماند — میتوان آن را دوباره فعال کرد. در بقیهٔ کدها هر دو حالت ممکن است؛ بنابراین /pub/v1/card را بررسی کنید: valid — کد سالم است، فعالسازی را تکرار کنید؛ used ولی اشتراکی در کار نیست — برای Claude از /pub/v1/refresh استفاده کنید و در سایر موارد همراه با task_id به ما پیام دهید.
status — running، queued یا بلافاصله done. product — پلن؛ ممکن است خالی باشد.
خطاها: bad_request, not_found, already_claimed, revoked, in_progress, queued_exists, reload_needed, out_of_stock, transient.
POST/pub/v1/task
وضعیت فعالسازی. پرسوجوی دورهای: هر 3 تا 5 ثانیه یک بار.
queue_position فقط تا زمانی برمیگردد که فعالسازی در صف است. مقدار خالی task_id یعنی bad_request، نه «شکست فعالسازی». بهمحض اینکه متد وضعیت نهایی را برگرداند، همان وضعیت بلافاصله در تاریخچهٔ شما هم ثبت میشود (/pub/v1/activations).
POST/pub/v1/card
جزئیات یک کد: وضعیت آن و اینکه آیا فعالسازیای برای آن در جریان است یا نه. ابزار اصلی بازیابی پس از قطع ارتباط.
status — مانند /pub/v1/check (جدول زیر). activating:true یعنی فعالسازی این کد هماکنون در حال اجراست — پرسوجوی دورهای را با task_id انجام دهید. اگر فعالسازی تمام شده باشد، activating برابر false خواهد بود و در task_id و task_status آخرین فعالسازی و نتیجهٔ آن (done یا failed) باقی میماند.
POST/pub/v1/check
وضعیت کدها بهصورت دستهای (تا 100 کد در هر درخواست)، بدون فعالسازی.
پاسخی برای این کد دریافت نشد — این حکم نهایی دربارهٔ کد نیست، بعداً دوباره بررسی کنید
میان invalid و unknown فرق بگذارید: اولی قطعی است و دومی فقط به معنای نرسیدن پاسخ. ملاک را وضعیت هر عنصر قرار دهید. موارد تکراری و کدهای با قالب نادرست کنار گذاشته میشوند؛ بنابراین عناصر را بر اساس فیلد card_key تطبیق دهید، نه بر اساس ترتیب.
POST/pub/v1/cancel-queue
خارجکردن فعالسازی از صف و آزادکردن کد. فقط برای کدهای دارای صف.
فعالسازی موجود در صف، بهمحض رسیدن نوبتش خودبهخود انجام میشود و کد مصرف خواهد شد. اگر سفارش لغو شده یا خریدار حاضر نیست منتظر بماند، باید آن را از صف خارج کنید. خطاها: not_queued, cancel_failed, already_claimed, not_found, revoked.
POST/pub/v1/refresh
تکمیل اشتراک Claude با Session Key خریدار، در صورتی که کد مصرف شده ولی اشتراک ظاهر نشده باشد.
session_key — مقدار کوکی sessionKey از دامنهٔ claude.ai. نیازی به ارسال task_id نیست: فعالسازی از روی کد پیدا میشود. اگر برای این کد فعالسازیای انجام نشده باشد → not_found.
POST/pub/v1/stock
موجودی.
{"vendor":"claude"}
→ {"ok":true,"products":[{"name":"Pro","level":"high","count":1169}]}
{"vendor":"chatgpt","queue":true} // کدهای دارای صف
→ {"ok":true,"availability":"plenty","queued":0}
level: high / normal / low / none. availability: plenty / normal / low / none. queued — طول صف.
POST/pub/v1/health
آیا فعالسازیها همین حالا انجام میشوند یا نه — جداگانه برای هر محصول.
chatgpt_queue — کدهای ChatGPT دارای صف (بخش 4). ok — فعالسازیها انجام میشوند · degraded — بخشی از آنها انجام نمیشود · down — انجام نمیشوند، بهتر است به بعد موکول کنید · unknown — داده کافی نیست. rate — سهم فعالسازیهای موفق در یک ساعت گذشته، samples — تعداد فعالسازیهایی که این سهم بر اساس آنها محاسبه شده است. این آمار فعالسازیهای واقعی اخیر است، نه خودآزمایی: اختلال را نمیتوان از پیش پیشبینی کرد، اما در همان دقایق نخست دیده میشود.
مقدار خالی items دقیقاً به معنای نبود فعالسازی است: اگر سرویس در دسترس نباشد، خطای transient برمیگردد، نه فهرست خالی.
POST/pub/v1/activations
تاریخچهٔ فعالسازیهای شما (بر اساس کلید شما)، جدیدترها در بالا.
{} // آخرین 200 مورد
{"limit":500} // تا 1000
→ {"ok":true,"mode":"partner","items":[
{"ts":"2026-10-21T05:00:00","updated":"2026-10-21T05:00:04","vendor":"claude",
"card":"CLAUDE-PRO-7KQ2M9XW…","account":"a63cfbd2-…","task_id":"0f8a6d64-…",
"status":"done","product":"Pro"}]}
status
معنا
created
فعالسازی ایجاد شده و نتیجه هنوز دریافت نشده است
queued
در صف منتظر است
done
اشتراک فعال شد
failed
اشتراک فعال نشد
timeout
نتیجه در زمان تعیینشده تأیید نشد؛ وضعیت هنوز ممکن است به done یا failed تغییر کند
در فیلد card کد به همان شکلی میآید که شما فرستادهاید. وضعیتها در تاریخچه خودبهخود بهروز میشوند و برای این کار لازم نیست پرسوجوی دورهای را برای هر فعالسازی جداگانه انجام دهید. اما برای نتیجهٔ یک سفارش مشخص از /pub/v1/task استفاده کنید — دقیقتر و سریعتر پاسخ میدهد. ts — زمان ایجاد فعالسازی، updated — زمان آخرین تغییر وضعیت؛ زمانها به وقت مسکو (UTC+3) است.
با پارامتر cdk این متد تاریخچهٔ یک کد را برمیگرداند که با نشست فعال میشود (بخش 8):
کدهای PLUS-PH-…, GO-EG-…, 5X-…, 20X-…, 50X-… (ChatGPT Plus، Go و Pro) و MAX5-…, MAX20-…, CPRO-… (Claude Max و Pro) — با نشست حساب خریدار و در دو مرحله همراه با تأیید فعال میشوند. این کدها از طریق /pub/v1/activate فعال نمیشوند: reload_needed برمیگردد.
تفاوتهای این روش:
· بهجای شناسهٔ حساب، نشست خریدار لازم است: برای ChatGPT — JSON کامل صفحهٔ chatgpt.com/api/auth/session که در همان مرورگری باز شده که ورود به حساب در آن انجام شده است؛ برای Claude — مقدار کوکی sessionKey از دامنهٔ claude.ai (با sk-ant-sid شروع میشود)؛
· فعالسازی چند دقیقه طول میکشد، نه چند ثانیه: معمولاً 2 تا 3 دقیقه و در ساعتهای پربار بیشتر؛
· سفارش با زوج order_id + secret از پاسخ activate محافظت میشود — هر دو رشته را ذخیره کنید؛ بدون secret نمیتوان وضعیت را دریافت کرد؛
· نشست یعنی دسترسی به حساب خریدار: آن را فقط از طریق HTTPS منتقل کنید و بیش از زمانی که برای فعالسازی لازم است نگه ندارید.
1.(اختیاری)/pub/v1/session/check — بررسی کد بدون مصرف آن. 2./pub/v1/session/activate — کد و نشست → order_id و secret. 3. پرسوجوی دورهای /pub/v1/session/order را هر 2 تا 5 ثانیه یک بار انجام دهید. 4. اگر state:"wait_confirm" برگشت، ایمیل حساب و پلن موجود در پاسخ را به خریدار نشان دهید و پس از موافقت او /pub/v1/session/confirm را فراخوانی کنید. برای تأیید زمان محدودی در نظر گرفته شده است (فیلد confirm_expires_at، معمولاً حدود 150 ثانیه). برای بخشی از کدها این مرحله لازم نیست — سفارش خودش وارد مرحلهٔ اجرا میشود. 5. پرسوجوی دورهای را تا رسیدن done:true ادامه دهید و به state نگاه کنید.
تکرار درخواست با همان کد و همان نشست بیخطر است: همان سفارش برمیگردد (duplicate:true).
حساب از قبل اشتراک دارد → {"ok":true,"state":"already_active",…}.
فقط برای کدهای ChatGPT: اگر اشتراک فعال حساب پایینتر از پلن کد باشد (مثلاً Go با کد Plus)، بهجای آن رد upgrade_confirm همراه با پلن فعلی، پلن جدید و تاریخ پایان اشتراک فعلی برمیگردد. آنها را به خریدار نشان دهید و پس از موافقت او درخواست را با "upgrade_ok":true تکرار کنید — اشتراک به پلن کد ارتقا مییابد و سفارش مثل همیشه ادامه پیدا میکند. ارتقا برای هر حسابی ممکن نیست: اگر انجامشدنی نباشد، سفارش با وضعیت already_active پایان مییابد و کد محفوظ میماند.
حالتهای سفارش (state). میانی (done:false) — پرسوجوی دورهای را ادامه دهید: queued — در صف · login — ورود به حساب · wait_confirm — در انتظار تأیید خریدار · running, paying, verifying — سفارش در حال اجراست.
مقدار نهایی state
معنا
کد سالم است؟
چه باید کرد
success, paid
اشتراک فعال شد
مصرف شده
انجام شد
already_active
حساب از قبل اشتراک دارد
بله
از حساب دیگری استفاده کنید یا تا پایان اشتراک صبر کنید
declined
پرداخت انجام نشد
بله
با همان کد دوباره تلاش کنید
retry_later
محدودیت موقت در سمت ما
بله
چند دقیقهٔ دیگر با همان کد دوباره تلاش کنید
account_busy
روی این حساب هماکنون سفارش دیگری در حال اجراست
بله
تا پایان آن صبر کنید و دوباره تلاش کنید
session_expired, not_logged_in
نشست دیگر معتبر نیست
بله
نشست تازه بگیرید و دوباره تلاش کنید
confirm_timeout
خریدار بهموقع تأیید نکرد
بله
از ابتدا شروع کنید
kyc
سرویس اشتراک از خریدار میخواهد هویتش را تأیید کند
—
مقدار kyc_url را به خریدار بدهید
already_paid_external
حساب اشتراکی دارد که از طریق فروشگاه اپلیکیشن تهیه شده است
بله
از حساب دیگری استفاده کنید
email_unverified
ایمیل حساب تأیید نشده است
بله
ایمیل را تأیید کنید و دوباره تلاش کنید
account_rejected
سرویس اشتراک پرداخت روی این حساب را نمیپذیرد
بله
به احتمال زیاد به حساب دیگری نیاز است؛ با همین حساب میتوان 20 دقیقه بعد دوباره تلاش کرد. اگر دوباره رد شد، فقط حساب دیگر
needs_review, manual
اپراتور در حال بررسی نتیجه است
—
تکرار نکنید؛ صبر کنید یا همراه با order_id به ما پیام دهید
blocked, canceled
سفارش پیش از پرداخت متوقف شد
بله
از ابتدا شروع کنید
not_found
سفارش پیدا نشد یا secret نادرست است
—
زوج order_id + secret را بررسی کنید
ممکن است مقادیر تازهای برای state اضافه شود. قاعده برای مقدار ناشناخته: done:false — پرسوجوی دورهای را ادامه دهید؛ done:true — پیام خنثای «انجام نشد، دوباره تلاش کنید» را به خریدار نشان دهید و کد را با /pub/v1/session/check بررسی کنید.
9. Fortnite Crew
کدهای FN-CREW-… اشتراک Fortnite Crew را روی حساب Epic Games خریدار فعال میکنند. خریدار خودش وارد حسابش میشود — رمز عبور در اختیار هیچکس قرار نمیگیرد. کلید همان کلید سایر متدهاست.
1. تأیید ورود را به یکی از دو روش بگیرید:
· با لینک — /pub/v1/fortnite/login/start یک لینک و یک کد کوتاه برمیگرداند؛ خریدار لینک را باز میکند، وارد Epic Games میشود و کد را تأیید میکند و شما /pub/v1/fortnite/login/poll را نظرسنجی میکنید؛
· با کد مجوز — خریدار خودش authorizationCode را از صفحهٔ Epic Games میگیرد و به شما میدهد؛ شما /pub/v1/fortnite/inspect را فراخوانی میکنید. 2. در هر دو حالت inspection_key و اطلاعات حساب برمیگردد — آن را به خریدار نشان دهید تا مطمئن شود حساب درست است. 3./pub/v1/fortnite/activate — کد و inspection_key ← task_id. 4./pub/v1/task را هر 3 تا 5 ثانیه نظرسنجی کنید تا done یا failed برسد (بخش 5).
pending — در انتظار ورود · authorized — ورود تأیید شد، میتوانید فعال کنید · expired — زمان تمام شد · error, inspect_failed — انجام نشد، دوباره شروع کنید.
POST/pub/v1/fortnite/inspect
بررسی کد مجوزی که خریدار دستی گرفته است. کد فعالسازی مصرف نمیشود.
موارد رد: bad_request, not_found, already_claimed, revoked, in_progress, transient. قواعد تکرار همانند بخش 6 است. اشتراک معمولاً ظرف چند دقیقه فعال میشود.
code
معنا
چه باید کرد
epic_auth
لینک ورود یا کد مجوز منقضی شده است
ورود را دوباره بگیرید (مرحلهٔ 1) و تکرار کنید
epic_account
Epic Games اطلاعات حساب را تأیید نکرد
ورود را دوباره بگیرید و تکرار کنید
epic_banned
حساب Epic Games مسدود است
حساب دیگری لازم است
epic_noplay
این حساب به Fortnite دسترسی ندارد
حساب دیگری لازم است
unavailable
فعالسازی Fortnite موقتاً در دسترس نیست
بعداً دوباره تلاش کنید
10. محدودیتها و توصیهها
فعالسازیهای همزمان
دو فعالسازی /pub/v1/activate بهطور موازی اجرا میشوند؛ بقیهٔ درخواستها درون همان فراخوانی منتظر نوبت خود میمانند — چیزی از دست نمیرود، فقط پاسخ دیرتر میرسد
پرسوجوی دورهای /pub/v1/task
هر 3 تا 5 ثانیه یک بار؛ بیشتر از این لازم نیست و نتیجه را سریعتر نمیکند
دستهٔ بررسی
تا 100 کد در هر /pub/v1/check؛ بررسیها یکییکی انجام میشوند و دستههای بزرگ دیرتر پاسخ میگیرند
تاریخچه
تا 1000 رکورد در هر /pub/v1/activations
عبور از حد مجاز نرخ درخواست
HTTP 429 و code:"rate_limited" — دستکم یک دقیقه صبر کنید
زمان
زمانهایی که منطقهٔ زمانی ندارند به وقت مسکو (UTC+3) هستند
فیلدهای ناشناخته
ممکن است در پاسخها فیلدهای تازهای ظاهر شود — فیلدهای ناآشنا را نادیده بگیرید و آنها را خطا به حساب نیاورید
برای هر سفارش این موارد را نزد خود نگه دارید: کد، حساب، task_id (یا order_id + secret) و آخرین وضعیت. هنگام تماس با ما task_id یا order_id را بفرستید — با آنها فعالسازی را فوراً پیدا میکنیم.
11. نمونهٔ یکپارچهسازی
چرخهٔ کامل یک سفارش با محافظت در برابر کسر دوباره (شبهکد):
BASE = "https://pay2cdkey.com"
H = {"Content-Type": "application/json", "X-API-Key": KEY}
# 1. فعالسازی؛ در صورت قطع ارتباط، کورکورانه تکرار نمیکنیم
try:
r = post(BASE + "/pub/v1/activate",
{"card_key": code, "account": buyer_account}, headers=H, timeout=90).json()
except (Timeout, ConnectionError):
c = post(BASE + "/pub/v1/card", {"card_key": code}, headers=H).json()
if c.get("activating"):
r = {"ok": True, "task_id": c["task_id"], "status": "running"} # همان فعالسازی را ادامه میدهیم
elif c.get("status") == "valid":
return retry_later() # کد سالم است
else:
return manual_check(order, c) # used بدون فعالسازی — باید بررسی شود
if not r["ok"]:
if r["code"] in ("not_found", "already_claimed", "revoked", "bad_request"):
return fail_order(r["error"]) # قطعی
return retry_later() # transient / out_of_stock / in_progress
save_task_id(order, r["task_id"]) # بلافاصله ذخیره شود
status = r["status"]
# 2. پرسوجوی دورهای تا وضعیت نهایی، حداکثر 5 دقیقه
deadline = now() + 300
while status not in ("done", "failed") and now() < deadline:
sleep(4)
t = post(BASE + "/pub/v1/task", {"task_id": r["task_id"]}, headers=H).json()
if t["ok"]:
status = t["status"] # queued / running — ادامه میدهیم
if status == "done":
return deliver(order)
if status == "failed":
return handle_failure(order) # بخش 6: بررسی کد با /pub/v1/card
return check_later(order) # نتیجه هنوز مشخص نیست — بعداً دوباره بررسی شود