Тестирование выплат

В этой статье описано, как проверять выплаты в тестовом режиме ЮKassa. При использовании тестового режима всё проходит, как при настоящих выплатах, но деньги никуда не переводятся.

О тестовом режиме

Тестовый режим доступен сразу после регистрации в личном кабинете ЮKassa — вы можете протестировать выплаты в любой момент, даже до указания данных компании и заключения договора.

Чтобы использовать тестовый режим, нужно зарегистрироваться в личном кабинете ЮKassa и создать тестовый шлюз.

В тестовом режиме доступны все основные возможности API, даже те, которые для настоящего шлюза нужно подключать через менеджера ЮKassa.

Особенности использования тестового режима:

для аутентификации запросов необходимо использовать идентификатор и секретный ключ тестового шлюза;
в запросах необходимо передавать специальные тестовые данные (зависят от того, какую функциональность вы проверяете);
в объектах выплат, созданных для тестового шлюза, параметр test принимает значение true.

Пример тестовой выплаты

JSON
{
    "id": "po-285ec15d-0003-5000-a000-08d1bec7dade",
    "amount": {
        "value": "2.00",
        "currency": "RUB"
    },
    "status": "succeeded",
    "payout_destination": {
        "type": "yoo_money",
        "account_number": "4100116075156746"
    },
    "description": "Payout for order No. 37",
    "created_at": "21.06.2021T14:28:45.132Z",
    "metadata": {
        "order_id": "37"
    },
    "test": "test"
}

Что можно протестировать

В тестовом режиме можно проверить только выплаты обычным физическим лицам.

Вы можете проверить эти возможности API ЮKassa:

Можно протестировать:

успешное проведение выплат;
обработку некоторых лимитов выплат;
обработку некоторых неуспешных сценариев с отменой выплаты (обработка значений объекта cancellation_details).

Тестовый шлюз

Создать тестовый шлюз можно до регистрации в ЮKassa и после.

Если вы не зарегистрированы в ЮKassa

Шаг 1. Зарегистрируйтесь в ЮKassa по этой ссылке.

Шаг 2. В процессе увидите два варианта: продолжить регистрацию или перейти к тестированию платежей. Выберите тестирование. Вам отобразится созданный тестовый личный кабинет.

Шаг 3. Click on the block with the name of the store (or the store icon in the mobile version).

Block with the name of the store (on desktop)

Block with the name of the store (on mobile)

Шаг 4. Click Add a test gateway in the opened list. You will see the window for creating a test gateway.

Window for creating a test gateway

Step 5. When creating a test gateway, specify that you're going to use a new API, enter the necessary information, and click Add. The newly created test gateway will be displayed within a minute.

Если у вас есть личный кабинет ЮKassa

Шаг 1. Перейдите в личный кабинет.

Шаг 2. Click on the block with the name of the gateway (or the wallet icon in the mobile version)

Block with the name of the gateway (on desktop)

Block with the wallet icon (on mobile)

Шаг 3. Click Add a test gateway in the opened list. You will see the window for creating a test gateway.

Window for creating a test gateway

Step 4. When creating a test gateway, specify that you're going to use a new API, enter the necessary information, and click Add. The newly created test gateway will be displayed within a minute.

Тестирование интеграции

Шаг 1. Получите идентификатор и секретный ключ тестового шлюза. Они нужны для аутентификации запросов.

Шаг 2. Выберите ту функциональность, которую хотите протестировать:

Шаг 3. Протестируйте выбранную функциональность по инструкциям.

Проведение настоящих выплат

Если вы успешно всё проверили и хотите начать делать реальные выплаты, убедитесь, что для аутентификации запросов теперь используете данные настоящего, а не тестового шлюза.

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