Агентіңізді таңдаңыз: Claude Code, Codex, Claude немесе ChatGPT. Ол сізді Sandbox-тан алғашқы нақты төлемге дейін жеткізеді: аккаунт пен кілттерді дайындайды, интеграция кодын жазады, төлемдерді, вебхуктар мен қайтарулар тексереді.
Плагиннің дағдылары Claude (claude.ai, қосымша, Cowork), Claude Code және Codex-те жұмыс істейді. Браузердегі ChatGPT тек xPayment құралдарын алады, дағдыларсыз.
Агентті таңдаңыз және Kaspi Pay кассиріңіз бар-жоғын көрсетіңіз. Бет жолды және көмекшіңізге арналған дайын хабарламаны көрсетеді.
xPayment арқылы төлем қабылдауды қос. Менде әзірге Kaspi Pay кассирі жоқ, сондықтан Sandbox-тан баста: тестілік кілт, тестілік касса, тестілік вебхук. Интеграцияны менің жобамда жаз да, төлемдерді, барлық нәтижелерді, вебхуктар мен қайтаруларды тексер. Кілттерді .env файлында сақта, жауапта басып шығарма.xPayment арқылы Kaspi Pay төлемін қабылдауға көмектес. xPayment құралдарын қолдан, whoami-дан баста. Менде әзірге Kaspi Pay кассирі жоқ, сондықтан тек Sandbox-та жұмыс істе (environment: sandbox): xapi_test_… тестілік кілтін шығар, вебхукке тестілік жазылым жаса, тестілік төлем жаса, simulate_test_payment арқылы paid, declined, expired және failed нәтижелерін қой да, қайтаруларды тексер. Нәтижені кестемен көрсет. Нақты ортада ештеңе жасама. Бір мезетте бір сұрақ қой.Менің жобамда Kaspi Pay-ді xPayment API v2 арқылы қос. Құжаттама бір файлда: https://xpayment.kz/llms-full.txt, API сипаттамасы: https://xpayment.kz/openapi/xpayment-api-v2.json. Менде әзірге Kaspi Pay кассирі жоқ, сондықтан Sandbox-та жұмыс істейміз: xapi_test_… тестілік кілтін және test кассасын кабинеттен («Sandbox» → «Кілттер») өзім алып, .env файлына өзім саламын, кілтті чатқа қоюды сұрама. Клиент пен вебхук өңдегішін жаз (қолтаңбаны тексеру, идемпотенттілік) және төлемдерді, барлық нәтижелерді және қайтаруларды POST /v2/sandbox/payments/PAYMENT_ID/simulate арқылы тексер.xapi_test_… тестілік кілті, test кассасы және вебхукке тестілік жазылым: тарифсіз және Kaspi-сіз.paid, declined, expired, failed нәтижелері бар тестілік төлемдер және қайтарулар.xPayment арқылы төлем қабылдауды қос. Менде Kaspi Pay кассирі бар. Алдымен Sandbox-та толық циклді өткіз, содан кейін мені нақты режимге дейін жеткіз: касса, вебхук және кілт. Нақты кілттер мен құпиялар тек бір реттік сілтемелер арқылы, нақты әрекеттер тек менің «иә» деуімнен кейін.xPayment арқылы Kaspi Pay төлемін қабылдауға көмектес. xPayment құралдарын қолдан, whoami-дан баста. Менде Kaspi Pay кассирі бар. Алдымен Sandbox-та толық циклді өткіз (environment: sandbox), содан кейін кассаны қосуға және нақты вебхук пен кілтті баптауға көмектес. Нақты кілттер мен құпияларды тек бір реттік сілтемемен бер, чатта көрсетпе. Нақты төлем бойынша жою, қайтарып алу және қайтару тек менің анық «иә» деуімнен кейін. Нақты төлемдерді жасама. Бір мезетте бір сұрақ қой.Менің жобамда Kaspi Pay-ді xPayment API v2 арқылы қос. Құжаттама бір файлда: https://xpayment.kz/llms-full.txt, API сипаттамасы: https://xpayment.kz/openapi/xpayment-api-v2.json. Менің Kaspi Pay кассам xPayment кабинетінде қосулы. Алдымен бәрін xapi_test_… тестілік кілтімен Sandbox-та тексер, содан кейін нақты режимге көшуді дайында: кілт, device_name және вебхук құпиясы. Кілттерді .env файлына өзім саламын, оларды чатқа қоюды сұрама. Клиент пен вебхук өңдегішін жаз (қолтаңбаны тексеру, идемпотенттілік).test сіздің кассаңызға ауысады.Kaspi кассирінсіз бірден, Sandbox-та бастайсыз. Кассирмен сол Sandbox-тан өтіп, содан кейін нақты режимге көшесіз. Белгілер кім не істейтінін көрсетеді.
Тегін және тіркелген бойда қолжетімді. Kaspi кассасы, тариф және ақша қажет емес; мекенжайлар, сұраныстар мен жауаптар нақты режимдегідей.
xapi_test_… кілтін және вебхукке тестілік жазылым шығарады. Жобаңызда мәндерді .env файлына басып шығармай жазады.X-Idempotency-Key, шикі денедегі қолтаңбаны тексеру, қайталанған delivery_id екі рет өңделмейді, әр оқиғадан кейін төлем сұралады.paid, declined, expired, failed.13.13 қайтару әрқашан қабылданбайды; …7000000001 және …7000000002 телефондары Kaspi қателерін береді.Көпшілікке арналған мекенжай болмаса, вебхуктар компьютеріңіздегі серверге жетпейді: көмекші туннельді (ұсынады) немесе жергілікті қолтаңбамен тексеруді ұсынады.
Sandbox-та статикалық QR, онлайн жазылу, тұрақты төлемдер және жазылымдар жоқ. Лимит: минутына 60 және тәулігіне 1000 тестілік жазба. Тестілік төлемдер 30 күн сақталады.
Алдымен Sandbox-та сол цикл, содан кейін нақты касса, вебхук және кілт. Тек сіз жасай алатын нәрсе белгіленген.
xapi_test_… → xapi_…), device_name (test → кассаңыздың атауы) және вебхук құпиясы. Қалған код сол күйінде.Сайт немесе әзірлеуші жоқ па? Кодтың орнына көмекші кабинетте төлем бетін жасайды. Жариялау тек сіздің «иә» деуіңізден кейін.
Көмекшіңіз өтетін цикл осындай: төлем, нәтиже, вебхук, қайтару.
paid → COMPLETED, payment.completeddeclined → CANCELLED, payment.cancelledexpired → EXPIRED, payment.expiredfailed → FAILED, payment.failedВебхук денесінде сома мен күй жоқ: оқиғадан кейін кодыңыз GET /v2/payments/PAYMENT_ID сұрап, төлем күйіне сүйенеді.
Төрт баған: көмекші өзі не істейді, тек сіздің «иә» деуіңізден кейін не істейді, тек сіз не істей аласыз және ол ешқашан не істемейді.
Артық сұрақсыз, сіз берген құқықтар шегінде.
Көмекші әрекетті дәл атап, дәл соған «иә» жауабын күтеді.
Мұны көмекші істей алмайды.
Мұны плагин ережелері жабады.
.env файлын ашу және оқуКелісім бетінде көмекші нені сұрайтынын көресіз де, рұқсат бересіз не бас тартасыз. Қажетті құқығы жоқ құрал SCOPE_REQUIRED деп жауап береді: қайта қосылып, сол құқыққа рұқсат беріңіз.
account:read: Аккаунтты көру: кассалар, кілттер (мәнсіз), вебхуктар, төлемдер мен қайтаруларdevices:write: Кассаларды қосу, атын өзгерту және жоюkeys:write: API кілттерін шығару және қайтарып алуwebhooks:write: Вебхук жазылымдарын жасау, өзгерту және жоюlinks:write: Төлем беттерін жасау, жариялау және мұрағаттауsandbox:write: Тестілік төлемдерді жасау және «төлеу»refunds:write: Нақты төлемдер бойынша қайтару жасауКөмекшінің әрекеттер журналы мен қолжетімділікті қайтарып алу: «Настройки» → «Подключённые AI».
Алдымен бәрі Sandbox-та тестілік кілттермен өтеді — ақшасыз және Kaspi-сіз. AI нақты төлем жасай алмайды, ал нақты объектілерді тек сіз дәл нақты режимді сұрағанда ғана өзгерте бастайды.
.env файлында. Кілтті чатқа жіберіп алсаңыз, AI оны ауыстыруды айтады.Деректеріңіз өзіңіз таңдаған AI-сервиске жіберіледі. AI аккаунтыңыздан оқитын барлық нәрсе, соның ішінде төлеушілердің телефон нөмірлері мен email-дері, осы сервиске (Claude, ChatGPT немесе Codex) жіберіледі.
AI-мен қайда жұмыс істейтініңізді таңдаңыз. Агентіңізге арналған жылдам нұсқа жоғарыда, «Неден бастау» блогында.
Плагин маркетплейстен орнатылады. Бұл қадамдар браузердегі claude.ai-да тексерілді; компьютерге арналған қосымшада және Cowork-та жол дәл осындай, бірақ оларда жеке өтіп көрмедік.
Персонализация → Плагины → «+ Добавить» ашыңыз, «Добавить маркетплейс» (маркетплейс қосу), содан кейін «Добавить из репозитория» (репозиторийден қосу) таңдаңыз.
Іздеу өрісіне репозиторий мекенжайын енгізіп, «Синхронизация» (синхрондау) түймесін басыңыз.
xpayment-kz/xpayment-ai«xPayment» карточкасы (авторы xpayment-ai) шығады. «Добавить» (қосу) түймесін басыңыз. Ескерту терезесі шықса, оны оқып, «Продолжить» (жалғастыру) түймесін басыңыз.
Плагин бетіндегі «Коннекторы · 2» (коннекторлар) тізімінде екі коннектор бар: екеуін де қосыңыз. Әрқайсысы үшін: «Подключить» (қосу) → «Добавить пользовательский коннектор» (өз коннекторыңызды қосу) → «Продолжить», содан кейін «Добавить» және қайтадан «Подключить». xpayment-docs — құжаттама, оған кіру қажет емес.
xpayment үшін браузерде xpayment.kz/login ашылады: «Войти через xPayment» арқылы кіріп, келісім бетінде «Разрешить» (рұқсат беру) түймесін басыңыз. Содан кейін коннектор қосылған болып көрсетіледі.
Алғашқы рет Claude әр құрал үшін рұқсат сұрайды: «Разрешить один раз» (бір реттік рұқсат). Плагинде скрипттер мен хуктар жоқ; «Может отправлять данные в другие сервисы» (басқа сервистерге деректер жібере алады) белгісі екі MCP-серверге қатысты.
Қалай шақыруға болады. Плагин бетіндегі «Попробовать в чате» (чатта байқап көру) түймесін басыңыз: /integrate командасы алдын ала жазылған чат ашылады. Сұрауыңыз дағдыға сәйкес келсе, дағды өздігінен де іске қосылады.
Қалай жаңартуға болады. Персонализация → Плагины → «+ Добавить» → «Управлять маркетплейсами» (маркетплейстерді басқару) → xpayment-ai → ⋯ → «Проверить обновления» (жаңартуларды тексеру).
Claude Code 2.1.319 немесе одан жаңасы қажет.
Плагинді терминалда орнатыңыз (ол сіздің пайдаланушыңыз үшін орнатылады):
claude plugin marketplace add xpayment-kz/xpayment-aiclaude plugin install xpayment@xpaymentДәл осыны сессия ішінде де істеуге болады: /plugin marketplace add xpayment-kz/xpayment-ai, содан кейін /plugin install xpayment@xpayment. Орнатқаннан кейін жаңа сессия бастаңыз.
Барлығы орнында екеніне көз жеткізіңіз: төрт дағдысы бар xpayment плагині (xpayment:ask, xpayment:check, xpayment:integrate, xpayment:migrate-v2). xpayment-docs сервері қосылған, xpayment сервері кіруді күтіп тұр.
Аккаунтқа кіріңіз: сессияда /mcp орындап, plugin:xpayment:xpayment пен Authenticate таңдаңыз. Интерактивті терминал қажет. Браузерде «Войти через xPayment» ашылады.
Бұл қадам плагиннің өз нұсқаулығы бойынша сипатталған; біздің тексеруімізде Claude Code-тан аккаунтқа кіру іске қосылған жоқ.
Дәл осыны терминалда бір командамен істеуге болады:
claude mcp login plugin:xpayment:xpaymentҚалай шақыруға болады. /xpayment:ask, /xpayment:integrate, /xpayment:migrate-v2 немесе /xpayment:check деп жазыңыз не міндетті жай сипаттап беріңіз.
Қалай жаңартуға болады. Екі команданы орындаңыз, содан кейін /reload-plugins енгізіңіз немесе жаңа сессия бастаңыз.
claude plugin marketplace update xpaymentclaude plugin update xpayment@xpayment
Браузердегі ChatGPT xPayment құралдарын алады, бірақ дағдыларды алмайды: мұнда ask және integrate командалары жоқ, сондықтан міндетті жай сөзбен сипаттаңыз.
chatgpt.com сайтында Плагины → «Добавить» (қосу) → «Добавить пользовательский сервер MCP» (өз MCP-серверін қосу) ашыңыз.
«Название» (атауы): xPayment. «Описание» (сипаттамасы): өз сөзіңізбен.
«Подключение» (қосылу) → «URL-адрес сервера» (сервер мекенжайы): мекенжайды енгізіңіз.
https://api.xpayment.kz/mcp«Аутентификация» (аутентификация): OAuth. «Расширенные настройки OAuth» (OAuth кеңейтілген баптаулары) бөлімінде ChatGPT клиент деректерін өзі табады, ештеңе теру қажет емес.
«Я понимаю и хочу продолжить» (түсінемін және жалғастырғым келеді) белгісін қойып, «Создать в виде плагина» (плагин ретінде жасау) түймесін басыңыз. Бұл шешімді өзіңіз қабылдайсыз.
«Войти через xPayment» арқылы кіріп, «Разрешить» (рұқсат беру) түймесін басыңыз.
Қалай шақыруға болады. Чатта @xPayment деп жазып, сұрауыңызды қосыңыз немесе «Попробовать в чате» (чатта байқап көру) түймесін басыңыз.
Қалай жаңартуға болады. Ештеңе істеудің қажеті жоқ: сервер қашықтағы, сондықтан өзгерістер қайта орнатусыз-ақ келеді.
Компьютерге арналған ChatGPT қосымшасы туралы плагин репозиторийіндегі README-ден оқыңыз. GitHub-тағы плагин
Codex CLI 0.167.0 нұсқасында тексерілді.
Плагинді орнатыңыз:
codex plugin marketplace add xpayment-kz/xpayment-aicodex plugin add xpayment@xpaymentАккаунтқа кіріңіз:
codex mcp login xpaymentCodex xPayment-ке өзін өзі таныстырады, ештеңе толтырудың қажеті жоқ. Браузерде «Войти через xPayment» ашылады: рұқсат беріңіз, сонда Codex кіру орындалғанын хабарлайды.
Егер әдепкі браузеріңізде xPayment-ке басқа аккаунтпен кірген болсаңыз, Codex басып шығарған сілтемені керекті аккаунт бар браузерде ашыңыз.
Тексеріңіз: codex mcp list xpayment және xpayment-docs көрсетеді (кірмей тұрып xpayment жанында «Not logged in» деп жазылады), ал дағдылар xpayment:ask, xpayment:check, xpayment:integrate, xpayment:migrate-v2 деп аталады.
Қалай шақыруға болады. Дағдыны атымен атаңыз не міндетті сипаттап беріңіз.
Қалай жаңартуға болады. Команданы орындап, жаңа сессия бастаңыз.
codex plugin marketplace upgrade xpayment
Біз тек Claude, Claude Code, Codex және ChatGPT-ді тексердік. Бұл нұсқалар тексерілмеген: клиентіңіздегі түймелер атауы басқаша болуы мүмкін.
«құжаттама» MCP-сервері клиент HTTP арқылы MCP-ны қолдаса, кірусіз жұмыс істейді. Мекенжайы:
https://api.xpayment.kz/mcp/docs«аккаунт» MCP-сервері клиент MCP үшін OAuth-ты қолдаса, аккаунтыңызға OAuth арқылы кіреді («Войти через xPayment»). Мекенжайы:
https://api.xpayment.kz/mcpMCP-сіз: кабинеттен xapi_test_… тестілік кілтін алып («Sandbox» → «Кілттер»), .env файлына өзіңіз сақтаңыз. Нақты кілттер де кабинетте шығарылады.
Агентке құжаттаманы бір файлмен беріңіз: онда API v1 мен v2 барлық эндпоинттері бар.
https://xpayment.kz/llms-full.txtҚалай шақыруға болады. Тапсырманы өз сөзіңізбен сипаттаңыз немесе «Неден бастау» блогындағы дайын хабарламаны қолданыңыз.
Қалай жаңартуға болады. Жаңартатын ештеңе жоқ: серверлер қашықтағы.
Қадамдар 2026 жылғы 10 қарашада тексерілді: Claude Code 2.1.319, Codex CLI 0.167.0, браузердегі claude.ai және chatgpt.com (орыс тіліндегі интерфейс). Түймелердің атаулары орыс интерфейсіндегідей берілген; Claude мен ChatGPT экрандары өзгеріп тұрады, сондықтан сізде атаулар басқаша болуы мүмкін.
Плагинсіз тек xPayment MCP-серверлерін қосуға болады. Құралдар мен құжаттама болады, бірақ дағдылар болмайды: ask, integrate, migrate-v2 және check қадамдық нұсқаулары жүктелмейді.
Claude-та: Персонализация → Коннекторы → «+ Добавить» → «Добавить пользовательский коннектор» (өз коннекторыңызды қосу). Екі коннектор қосыңыз.
Құжаттама. Кіру қажет емес.
https://api.xpayment.kz/mcp/docs
Аккаунт. OAuth: «Войти через xPayment» арқылы кіріп, «Разрешить» (рұқсат беру) түймесін басыңыз.
https://api.xpayment.kz/mcp
Бұл нұсқаның тек мәзір арқылы жолын тексердік.
MCP көмекшіге құралдар береді. Плагин xPayment-тің екі серверін де қосады және дағдылар қосады: дайын нұсқаулар.
Бес құрал: API паспорты, бөлімдер тізімі, бөлім, іздеу және эндпоинт сипаттамасы. Көмекші өзекті құжаттама бойынша жауап береді. https://api.xpayment.kz/mcp/docs
Аккаунтыңыздың құралдары: кассалар, кілттер, вебхуктар, төлем беттері, тестілік төлемдер және қайтарулар. Тек сіздің құқықтарыңыз бен көмекшіге берілген құқықтар шегінде. https://api.xpayment.kz/mcp
Дағдылар — AI-ға арналған дайын нұсқаулар. Плагинде скрипттер мен хуктар жоқ.
ask: xPayment туралы сұрақтарға өзекті құжаттама бойынша, ал кірген болсаңыз — аккаунтыңыз бойынша жауап береді. Ештеңені өзгертпейді.integrate: Кіруден бастап алғашқы нақты төлемге дейін жетелейді: сценарий, аккаунт пен касса, Sandbox-та толық цикл, код немесе төлем беті, вебхук және нақты режимге көшу.migrate-v2: Интеграцияны API v1-ден API v2-ге (beta) флаг арқылы, тоқтаусыз көшіреді; v1 кілттерін ең соңында қайтарып алады.check: Интеграцияны (код пен аккаунтты) өзекті құжаттама бойынша тексеріп, мәселелерді маңыздылығы бойынша, түзетулерімен бірге хабарлайды.Иә. Sandbox тегін және тіркелген бойда қолжетімді: test тестілік кассасы, xapi_test_… тестілік кілттері, тарифсіз, Kaspi-сіз және ақшасыз. Төлемнен бастап вебхук пен қайтаруға дейінгі бүкіл жол осында өтеді. Нақты төлемдер кассаны қосқаннан кейін басталады.
Тестілік кілтті көмекші өзі шығарып, жобаңыздың .env файлына басып шығармай жазады. Нақты кілттер мен вебхук құпияларын ол көрмейді: бір сағатқа жарамды бір реттік сілтеме береді, мәнді өзіңіз сақтайсыз. Кілт чатқа түсіп кетсе, көмекші оны ауыстыруды айтады.
Жоқ. Көмекші нақты төлемдерді жасамайды да, болдырмайды да: алғашқы нақты төлемді өзіңіз жасайсыз. Нақты төлем бойынша қайтаруды ол тек осы әрекетке сіз «иә» дегеннен кейін жасайды.
Браузердегі ChatGPT-де xPayment MCP-сервері қосылады: құралдар бар, дағдылар жоқ, сондықтан тапсырманы сөзбен сипаттаңыз немесе «Неден бастау» блогындағы дайын хабарламаны жіберіңіз. Плагин архивін chatgpt.com қабылдады, бірақ компьютерге арналған ChatGPT қосымшасында тексермедік.
Кабинетте: «Настройки» → «Подключённые AI». Онда әрекеттер журналы мен қолжетімділікті қайтарып алу түймесі бар.
Жаңа интеграцияға API v2 ұсынамыз: қазір ол beta мәртебесінде және өзгеруі мүмкін. API v1 тұрақты және толық қолдау табады.
Иә, бірақ бұл нұсқаларды біз тексермедік. Агентке құжаттама бар llms-full.txt файлын және API v2 сипаттамасын беріңіз, ал тестілік кілтті кабинеттен алыңыз («Sandbox» → «Кілттер»). Клиентіңіз MCP-ны қолдаса, екі серверді де қосуға болады.
Sandbox тегін және тіркелген бойда қолжетімді. Жоғарыда агентті таңдап, оған дайын хабарламаны жіберіңіз.