Публикация агента на маркетплейсе

Перед интеграцией вам нужны два параметра для работы с API ЮKassa. Их выдает ваш менеджер маркетплейса или напишите на contact@just-ai.com, в теме письма «Паблишер. Публикация агента на маркетплейсе».

Рекомендуем использовать готовую библиотеку — она берет на себя авторизацию, формирование запросов и обработку ответов.

PHP (официальный SDK)

composer require yoomoney/yookassa-sdk-php

Python (официальный SDK)

pip install yookassa

Node.js (SDK от сообщества)

npm install @a2seven/yoo-checkout

Платеж создается HTTP-запросом к API ЮKassa. Ниже два варианта — для платформ без своего сервера и для проектов с бэкендом.

Вариант А — без своего сервера (no-code)

Подходит для Just AI Agent Platform, Jay Flow, n8n, Make и подобных платформ с поддержкой REST API и webhook. Создайте платеж через HTTP-блок платформы:

{
  "amount": {
    "value": "500.00",
    "currency": "RUB"
  },
  "confirmation": {
    "type": "redirect",
    "return_url": "https://ваш-сайт.ru/success"
  },
  "capture": true,
  "description": "Заказ №42"
}

В ответе придет поле confirmation.confirmation_url — ссылка, на которую нужно перенаправить пользователя для оплаты.

Вариант Б — со своим сервером (PHP / Python)

require_once('./vendor/autoload.php');

$client = new \YooKassa\Client();
$client->setAuth('ВАШ_SHOP_ID', 'ВАШ_SECRET_KEY');

$payment = $client->createPayment([
    'amount'       => ['value' => '500.00', 'currency' => 'RUB'],
    'confirmation' => ['type' => 'redirect', 'return_url' => 'https://ваш-сайт.ru/success'],
    'capture'      => true,
    'description'  => 'Заказ №42',
], uniqid('', true)); // Idempotence-Key

$url = $payment->getConfirmation()->getConfirmationUrl();
header('Location: ' . $url);
exit;

from yookassa import Configuration, Payment
import uuid

Configuration.account_id = 'ВАШ_SHOP_ID'
Configuration.secret_key = 'ВАШ_SECRET_KEY'

payment = Payment.create({
    "amount": {"value": "500.00", "currency": "RUB"},
    "confirmation": {"type": "redirect", "return_url": "https://ваш-сайт.ru/success"},
    "capture": True,
    "description": "Заказ №42",
}, uuid.uuid4())  # уникальный Idempotence-Key

confirmation_url = payment.confirmation.confirmation_url
# перенаправьте пользователя на confirmation_url

Webhook ЮKassa отправляет уведомления только на адреса с https://. Без HTTPS вы не сможете получать уведомления об оплате.

Быстрый способ развернуть сайт с HTTPS

1. Зарегистрируйтесь на хостинге с поддержкой Let's Encrypt (например, Beget или Jino — у многих есть бесплатный тестовый период).
2. Добавьте домен или используйте бесплатный поддомен, загрузите файлы проекта через файловый менеджер или FTP.
3. В панели включите бесплатный SSL-сертификат Let's Encrypt (обычно одной кнопкой) и принудительный редирект с HTTP на HTTPS.

Webhook — это URL на вашем сервере, куда ЮKassa автоматически отправит запрос после оплаты и других событий.

1. Откройте личный кабинет ЮKassa → раздел Интеграция → HTTP-уведомления.
2. Укажите URL обработчика, например https://ваш-сайт.ru/webhook.

$body = file_get_contents('php://input');
$data = json_decode($body, true);

if ($data['event'] === 'payment.succeeded') {
    $paymentId = $data['object']['id'];
    // ВАЖНО: проверьте статус через API (Шаг 5),
    // и только потом открывайте доступ к товару
}

// Обязательно отвечаем кодом 200,
// иначе ЮKassa будет повторять запрос в течение 24 часов
http_response_code(200);

После webhook-уведомления обязательно перепроверьте статус платежа через API — это защита от поддельных уведомлений.

$payment = $client->getPaymentInfo($paymentId);
if ($payment->getStatus() === 'succeeded') {
    // Платеж подтвержден — открываем доступ к товару/услуге
}

from yookassa import Payment

payment = Payment.find_one(payment_id)
if payment.status == 'succeeded':
    # Платеж подтвержден — открываем доступ к товару/услуге
    pass

Перед боевым запуском протестируйте интеграцию на тестовом магазине. Запросите у вашего менеджера маркетплейса данные тестового магазина — тестовый секретный ключ начинается с test_.

Тестовые карты

Срок действия — любой в будущем (например, 12/30), CVC — любые 3 цифры, код 3-D Secure — любые цифры.