YooMoney API
Guides
Old versions of the API
Help
Sign up for YooMoney
Тестирование выплат
В этой статье описано, как проверять выплаты в тестовом режиме ЮKassa. При использовании тестового режима всё проходит, как при настоящих выплатах, но деньги никуда не переводятся.
 
О тестовом режиме
Тестовый режим доступен сразу после регистрации в личном кабинете ЮKassa — вы можете протестировать выплаты в любой момент, даже до указания данных компании и заключения договора.
Чтобы использовать тестовый режим, нужно зарегистрироваться в личном кабинете Ю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": "Выплата по заказу № 37",
    "created_at": "21.06.2021T14:28:45.132Z",
    "metadata": {
        "order_id": "37"
    },
    "test": "test"
}
Что можно протестировать
Вы можете проверить эти возможности API ЮKassa:
  • Выплаты на банковские карты
  • Выплаты на кошельки ЮMoney
  • Использование универсального токена для платежей и выплат
  • Запрос баланса выплат
Можно протестировать:
  • успешное проведение выплат;
  • обработку некоторых лимитов выплат;
  • обработку некоторых неуспешных сценариев с отменой выплаты (обработка значений объекта cancellation_details).
Тестовый шлюз
Создать тестовый шлюз можно до регистрации в ЮKassa и после.
Если вы не зарегистрированы в ЮKassa
Шаг 1. Зарегистрируйтесь в ЮKassa по этой ссылке.
Шаг 2. В процессе увидите два варианта: продолжить регистрацию или перейти к тестированию платежей. Выберите тестирование. Вам отобразится созданный тестовый личный кабинет.
Шаг 3. В личном кабинете нажмите Все магазины, затем Добавить тестовый шлюз.
Шаг 4. При создании тестового шлюза укажите, что будете использовать новый API, введите необходимые данные и нажмите Добавить. Вам отобразится созданный тестовый шлюз.
Если у вас есть личный кабинет ЮKassa
Шаг 2. Нажмите Все магазины и выплаты, затем Добавить шлюз.
Шаг 3. При создании тестового шлюза укажите, что будете использовать новый API, введите необходимые данные и нажмите Добавить. Вам отобразится созданный тестовый шлюз.
Тестирование интеграции
Шаг 1. Получите идентификатор и секретный ключ тестового шлюза. Они нужны для аутентификации запросов.
Шаг 2. Выберите ту функциональность, которую хотите протестировать:
Шаг 3. Протестируйте выбранную функциональность по инструкциям.
Проведение настоящих выплат
Если вы успешно всё проверили и хотите начать делать реальные выплаты, убедитесь, что для аутентификации запросов теперь используете данные настоящего, а не тестового шлюза.
Проверьте, что вам подключены все возможности, которые вы хотите использовать: проведите пробные выплаты на минимальную сумму или уточните у менеджера, какие возможности вам доступны. При необходимости согласуйте с менеджером нужные вам опции и дождитесь, когда вам настроят шлюз.
Что почитать еще