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

Это старая версия API. Переходите на API ЮKassa.

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

Подготовка к тестированию

Шаг 1. Получите нужные сертификаты

Получите нужные сертификаты для взаимодействия с ЮKassa.

Шаг 2. Создайте тестовый шлюз

Тестовый шлюз похож на настоящий. Главные отличия — он используется только для тестовых выплат и его баланс выплат не надо пополнять.

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

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

Зарегистрируйтесь по этой ссылке.
В процессе увидите два варианта: продолжить регистрацию или перейти к тестированию платежей. Выберите тестирование. Вам отобразится созданный тестовый личный кабинет.
В верхнем меню нажмите на блок с названием магазина (в мобильной версии это иконка магазина).
Блок с названием магазина (на компьютере)
Блок с названием магазина (на телефоне)
В открывшемся списке нажмите Добавить тестовый шлюз. Вам отобразится окно создания тестового шлюза.
Окно создания тестового шлюза
При создании тестового шлюза укажите, что будете использовать старый API, введите необходимые данные и нажмите Добавить. В течение минуты вам отобразится созданный тестовый шлюз.

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

Перейдите в личный кабинет.
В верхнем меню нажмите на блок с названием шлюза (в мобильной версии это иконка кошелька).
Блок с названием шлюза (на компьютере)
Блок с иконкой кошелька (на телефоне)
В открывшемся списке нажмите Добавить тестовый шлюз. Вам отобразится окно создания тестового шлюза.
Окно создания тестового шлюза
При создании тестового шлюза укажите, что будете использовать старый API, введите необходимые данные и нажмите Добавить. В течение минуты вам отобразится созданный тестовый шлюз.

Вы можете создать максимум 5 тестовых шлюзов.

Шаг 3. Получите идентификатор тестового шлюза (agentId)

В личном кабинете узнайте agentId тестового шлюза. Его нужно использовать во всех тестовых запросах к ЮKassa.

У тестового и настоящего шлюза разные agentId. Для тестирования нельзя использовать agentId настоящего шлюза — ЮKassa вернет ошибку с кодом 41.

Шаг 4. Дождитесь письма от менеджера ЮKassa

Менеджер ЮKassa пришлет вам письмо, что всё настроено и можно начинать тестироваться.

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

Когда всё готово, вы можете протестировать:

выплаты на кошельки;
выплаты на банковские карты;
запрос баланса выплат.

В запросах необходимо передавать специальные тестовые данные.

Адрес сервера для отправки запросов

https://payouts.yookassa.ru:9094

После проверки подготовьте вашу систему для проведения настоящих выплат.

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

Шаг 1. Переведите деньги (makeDeposition)

Переведите деньги в кошелек. Для этого отправьте запрос makeDeposition и передайте в нём agentId тестового шлюза, сумму выплаты (1 рубль или больше) и dstAccount с одним из номеров тестовых кошельков:

анонимный кошелек — 41001614575714;
именной кошелек — 4100116075156746;
идентифицированный кошелек — 4100116074720387.

Пример запроса

XML

<makeDepositionRequest
              agentId="123"
              clientOrderId="12345"
              requestDT="2019-07-01T20:38:00.000Z"
              dstAccount="41001614575714"
              amount="10.00"
              currency="643"
              contract="Тестовая выплата"
              />

Пример ответа

XML

<makeDepositionResponse
              clientOrderId="12345"
              status="0"
              processedDT="2019-07-01T20:38:01.000Z"
              balance="-19270338.94"
              identification="identified"
              />

В параметре balance вернется случайное отрицательное число.

Шаг 2. Проверьте идемпотентность запросов

Отправьте запрос makeDeposition с теми же данными, которые вы использовали на шаге 1. В ответ вернется результат обработки запроса, отправленного на шаге 1.

Шаг 3. Проверьте обработку ошибок зачисления

Вы можете проверить обработку ошибок зачисления на кошельки. Для этого выберите нужный вам сценарий и отправьте запрос makeDeposition со специальным номером тестового кошелька и определенной суммой выплаты.

Ошибка зачисления	Номер тестового кошелька (dstAccount)	Сумма выплаты
`41` Кошелек ЮMoney заблокирован. Данная операция для этого кошелька запрещена.	410011788545536	1 рубль или больше
`42` Счета с таким идентификатором не существует	410011806060695	1 рубль или больше
`43` Превышен лимит на разовое зачисление или лимит остатка на счете получателя	41001614575572	1 рубль или больше
`44` Превышено ограничение на максимальную сумму зачислений за сутки	41001614575643	1 рубль или больше
`45` Недостаточно средств для проведения операции	410011806060766	1 рубль или больше
`46` Сумма операции слишком мала	41001614575714	Меньше 1 рубля
`57` Кошелек ЮMoney не идентифицирован. Пополнение анонимного кошелька запрещено. Пользователю необходимо идентифицировать кошелек.	4100116103609421	1 рубль или больше

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

Идентификатор получателя перевода (dstAccount): 25700120202056919

Если делаете обычные выплаты, не c расчетного счета, для проверки выплат на банковские карты в paymentParams необходимо передавать тестовые персональные данные получателя выплаты:

фамилия получателя — Иванов
имя получателя — Иван
отчество получателя — Иванович
номер паспорта — 1234567890
все остальные параметры — любые значения

Шаг 1. Переведите деньги (makeDeposition)

Для зачисления денег на карту:

Получите синоним банковской карты самостоятельно или с помощью формы ЮKassa. Подойдут данные любой банковской карты.
Отправьте запрос makeDeposition и передайте в нём полученный синоним, agentId тестового шлюза, тестовый идентификатор получателя перевода (dstAccount), сумму от 100 рублей. Если делаете обычные выплаты, то также передайте тестовые персональные данные получателя выплаты (Иванов Иван Иванович, 1234567890).

Пример запроса для обычных выплат

XML

<makeDepositionRequest
    agentId="123"
    clientOrderId="12345"
    requestDT="2019-06-07T15:43:29.000Z"
    dstAccount="25700120202056919"
    amount="249.00"
    currency="643"
    contract="">
    <paymentParams>
    <skr_destinationCardSynonim>sRKjOLa32DBbBa-Oej5r9BvA.SC.000.201906</skr_destinationCardSynonim>
        <pdr_firstName>Иван</pdr_firstName>
        <pdr_middleName>Иванович</pdr_middleName>
        <pdr_lastName>Иванов</pdr_lastName>
        <pdr_docNumber>1234567890</pdr_docNumber>
        <pdr_postcode>194044</pdr_postcode>
        <pdr_country>643</pdr_country>
        <pdr_city>Санкт-Петербург</pdr_city>
        <pdr_address>3-я улица Строителей, д. 25</pdr_address>
        <pdr_birthDate>01.01.1940</pdr_birthDate>
        <pdr_birthPlace>гор.Ленинград</pdr_birthPlace>
        <pdr_docIssueYear>1999</pdr_docIssueYear>
        <pdr_docIssueMonth>07</pdr_docIssueMonth>
        <pdr_docIssueDay>30</pdr_docIssueDay>
        <pdr_docIssuedBy>ТП №20 по СПб и ЛО</pdr_docIssuedBy>
        <pof_offerAccepted>1</pof_offerAccepted>
        <smsPhoneNumber>79000000000</smsPhoneNumber>
    </paymentParams>
</makeDepositionRequest>

Развернуть

Пример ответа

XML

<makeDepositionResponse
    clientOrderId="12345"
    status="0"
    processedDT="2019-06-07T15:43:31.606+03:00"
    balance="-100000"
    invoiceId="2000028645828"
/>

В параметре balance вернется случайное отрицательное число.

Шаг 2. Проверьте идемпотентность запросов

Шаг 3. Проверьте обработку ошибок зачисления

Вы можете проверить обработку ошибок зачисления на карты. Для этого выберите нужный вам сценарий и отправьте запрос makeDeposition со специальными тестовыми данными.

Ошибка зачисления	Синоним банковской карты	Персональные данные	Сумма выплаты
`31` Получатель перевода отклонил выплату (под получателем понимается сотовый оператор или процессинговый банк)	BFtJqriXvLaIOr0BDLdcjwgC.SC.000.201904	Иванов Иван Иванович, 1234567890	100 рублей или больше
`46` Сумма операции слишком мала	Подойдет любой синоним, кроме тех, которые указаны в этой таблице. Как получить синоним банковской карты	Иванов Иван Иванович, 1234567890	Меньше 100 рублей
`48` Ошибка запроса зачисления перевода на банковский счет, карту, мобильный телефон	HW0xgquwIm-h4H9bfpiIRF3u.SC.000.201904	Иванов Иван Иванович, 1234567890	100 рублей или больше
`48` Ошибка запроса зачисления перевода на банковский счет, карту, мобильный телефон (`techMessage= «Паспортные данные не прошли проверку"`)	Подойдет любой синоним, кроме тех, которые указаны в этой таблице. Как получить синоним банковской карты	Любые данные, кроме тестовых	100 рублей или больше

Проверка баланса выплат (balance)

Чтобы проверить баланс выплат тестового шлюза, отправьте запрос balance и передайте в нём agentId тестового шлюза.

Пример запроса

XML

<balanceRequest
    agentId="123"
    clientOrderId="12345"
    requestDT="2019-07-01T20:38:00.000Z"
/>

Пример ответа

XML

<balanceResponse
    clientOrderId="12345"
    status="0"
    processedDT="2019-07-01T20:38:01.000Z"
    balance="-19270338.94"
/>

В параметре balance вернется случайное отрицательное число.

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

Уточните у менеджера, что всё готово для запуска. После этого отправляйте запросы с идентификатором настоящего шлюза (agentId) и реальными данными.

У тестового и настоящего шлюза разные agentId. Для настоящих выплат нельзя использовать agentId тестового шлюза — ЮKassa вернет ошибку с кодом 41.

Что почитать еще

Выплаты с расчетного счета Подключение выплат Зачисление переводов Типы данных Коды ошибок