Перед тем как отправлять запросы с реальными данными, вы можете проверить свою интеграцию и протестировать перевод денег на кошельки и на банковские карты, а также запрос баланса выплат. При тестировании всё проходит как при настоящих выплатах, но деньги никуда не переводятся. Протестировать можно только выплаты физическим лицам.
Получите нужные сертификаты для взаимодействия с ЮKassa.
Тестовый шлюз похож на настоящий.
Главные отличия — он используется только для тестовых выплат и его баланс выплат не надо пополнять.
Создать тестовый шлюз можно до регистрации в ЮKassa и после.
- Зарегистрируйтесь по этой ссылке.
- В процессе увидите два варианта: продолжить регистрацию или перейти к тестированию платежей. Выберите тестирование. Вам отобразится созданный тестовый личный кабинет.
- В личном кабинете нажмите Все магазины, затем Добавить тестовый шлюз.
- При создании тестового шлюза укажите, что будете использовать старый API, введите необходимые данные и нажмите Добавить. Вам отобразится созданный тестовый шлюз.
- Перейдите в личный кабинет.
- Нажмите Все выплаты, затем Добавить шлюз.
- При создании тестового шлюза укажите, что будете использовать старый API, введите необходимые данные и нажмите Добавить. Вам отобразится созданный тестовый шлюз.
В личном кабинете узнайте
agentId
тестового шлюза.
Его нужно использовать во всех тестовых запросах к ЮKassa.Менеджер ЮKassa пришлет вам письмо, что всё настроено и можно начинать тестироваться.
Когда всё готово, вы можете протестировать:
В запросах необходимо передавать специальные тестовые данные.
Адрес сервера для отправки запросов
https://payouts.yookassa.ru:9094
После проверки подготовьте вашу систему для проведения настоящих выплат.
Переведите деньги в кошелек. Для этого отправьте запрос makeDeposition и передайте в нём
agentId
тестового шлюза, сумму выплаты (1 рубль или больше) и dstAccount
с одним из номеров тестовых кошельков:- анонимный кошелек —
41001614575714
; - именной кошелек —
4100116075156746
; - идентифицированный кошелек —
4100116074720387
.
Пример запроса
<makeDepositionRequest agentId="123" clientOrderId="12345" requestDT="2019-07-01T20:38:00.000Z" dstAccount="41001614575714" amount="10.00" currency="643" contract="Тестовая выплата" />
Пример ответа
<makeDepositionResponse clientOrderId="12345" status="0" processedDT="2019-07-01T20:38:01.000Z" balance="-19270338.94" identification="identified" />
Отправьте запрос
makeDeposition
с теми же данными, которые вы использовали на шаге 2. В ответ вернется результат обработки запроса, отправленного на шаге 2.Вы можете проверить обработку ошибок зачисления на кошельки. Для этого выберите нужный вам сценарий и отправьте запрос
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
- все остальные параметры — любые значения
Для зачисления денег на карту:
- Получите синоним банковской карты самостоятельно или с помощью формы ЮKassa. Подойдут данные любой банковской карты.
- Отправьте запрос makeDeposition и передайте в нём полученный синоним,
agentId
тестового шлюза, тестовый идентификатор получателя перевода (dstAccount
), сумму от 100 рублей. Если делаете обычные выплаты, то также передайте тестовые персональные данные получателя выплаты (Иванов Иван Иванович
,1234567890
).
Пример запроса для обычных выплат
<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>
Пример ответа
<makeDepositionResponse clientOrderId="12345" status="0" processedDT="2019-06-07T15:43:31.606+03:00" balance="-100000" invoiceId="2000028645828" />
Отправьте запрос
makeDeposition
с теми же данными, которые вы использовали на шаге 1. В ответ вернется результат обработки запроса, отправленного на шаге 1.Вы можете проверить обработку ошибок зачисления на карты. Для этого выберите нужный вам сценарий и отправьте запрос
makeDeposition
со специальными тестовыми данными.Ошибка зачисления | Синоним банковской карты | Персональные данные | Сумма выплаты |
---|---|---|---|
31 Получатель перевода отклонил выплату (под получателем понимается сотовый оператор или процессинговый банк) | BFtJqriXvLaIOr0BDLdcjwgC.SC.000.201904 | Иванов Иван Иванович, 1234567890 | 100 рублей или больше |
46 Сумма операции слишком мала | Подойдет любой синоним, кроме тех, которые указаны в этой таблице. | Иванов Иван Иванович, 1234567890 | Меньше 100 рублей |
48 Ошибка запроса зачисления перевода на банковский счет, карту, мобильный телефон | HW0xgquwIm-h4H9bfpiIRF3u.SC.000.201904 | Иванов Иван Иванович, 1234567890 | 100 рублей или больше |
48 Ошибка запроса зачисления перевода на банковский счет, карту, мобильный телефон ( techMessage= «Паспортные данные не прошли проверку" ) | Подойдет любой синоним, кроме тех, которые указаны в этой таблице. | Любые данные, кроме тестовых | 100 рублей или больше |
Чтобы проверить баланс выплат тестового шлюза, отправьте запрос balance и передайте в нём
agentId
тестового шлюза.Пример запроса
<balanceRequest agentId="123" clientOrderId="12345" requestDT="2019-07-01T20:38:00.000Z" />
Пример ответа
<balanceResponse clientOrderId="12345" status="0" processedDT="2019-07-01T20:38:01.000Z" balance="-19270338.94" />
Уточните у менеджера, что всё готово для запуска. После этого отправляйте запросы с идентификатором настоящего шлюза (
agentId
) и реальными данными.