API ЮKassa
Помощь
Подключить ЮKassa
Тестирование выплат
Перед тем как отправлять запросы с реальными данными, вы можете проверить свою интеграцию и протестировать перевод денег на кошельки и на банковские карты, а также запрос баланса выплат. При тестировании всё проходит как при настоящих выплатах, но деньги никуда не переводятся. Протестировать можно только выплаты физическим лицам.
Подготовка к тестированию
Шаг 1. Получите нужные сертификаты
Получите нужные сертификаты для взаимодействия с ЮKassa.
Шаг 2. Создайте тестовый шлюз
Тестовый шлюз похож на настоящий. Главные отличия — он используется только для тестовых выплат и его баланс выплат не надо пополнять.
Создать тестовый шлюз можно до регистрации в ЮKassa и после.
Если вы не зарегистрированы в ЮKassa
  1. Зарегистрируйтесь по этой ссылке.
  2. В процессе увидите два варианта: продолжить регистрацию или перейти к тестированию платежей. Выберите тестирование. Вам отобразится созданный тестовый личный кабинет.
  3. В личном кабинете нажмите Все магазины, затем Добавить тестовый шлюз.
  4. При создании тестового шлюза укажите, что будете использовать старый API, введите необходимые данные и нажмите Добавить. Вам отобразится созданный тестовый шлюз.
Если у вас есть личный кабинет ЮKassa
  1. Перейдите в личный кабинет.
  2. Нажмите Все выплаты, затем Добавить шлюз.
  3. При создании тестового шлюза укажите, что будете использовать старый API, введите необходимые данные и нажмите Добавить. Вам отобразится созданный тестовый шлюз.
Шаг 3. Получите идентификатор тестового шлюза (agentId)
В личном кабинете узнайте agentId тестового шлюза. Его нужно использовать во всех тестовых запросах к ЮKassa.
Шаг 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"
              />
Шаг 2. Проверьте идемпотентность запросов
Отправьте запрос makeDeposition с теми же данными, которые вы использовали на шаге 2. В ответ вернется результат обработки запроса, отправленного на шаге 2.
Шаг 3. Проверьте обработку ошибок зачисления
Вы можете проверить обработку ошибок зачисления на кошельки. Для этого выберите нужный вам сценарий и отправьте запрос makeDeposition со специальным номером тестового кошелька и определенной суммой выплаты.
Ошибка зачисленияНомер тестового кошелька (dstAccount)Сумма выплаты
41
Кошелек ЮMoney заблокирован. Данная операция для этого кошелька запрещена.
4100117885455361 рубль или больше
42
Счета с таким идентификатором не существует
4100118060606951 рубль или больше
43
Превышен лимит на разовое зачисление или лимит остатка на счете получателя
410016145755721 рубль или больше
44
Превышено ограничение на максимальную сумму зачислений за сутки
410016145756431 рубль или больше
45
Недостаточно средств для проведения операции
4100118060607661 рубль или больше
46
Сумма операции слишком мала
41001614575714Меньше 1 рубля
57
Кошелек ЮMoney не идентифицирован. Пополнение анонимного кошелька запрещено. Пользователю необходимо идентифицировать кошелек.
41001161036094211 рубль или больше
Тестирование выплат на карты
Идентификатор получателя перевода (dstAccount): 25700120202056919
Если делаете обычные выплаты, не c расчетного счета, для проверки выплат на банковские карты в paymentParams необходимо передавать тестовые персональные данные получателя выплаты:
  • фамилия получателя — Иванов
  • имя получателя — Иван
  • отчество получателя — Иванович
  • номер паспорта — 1234567890
  • все остальные параметры — любые значения
Шаг 1. Переведите деньги (makeDeposition)
Для зачисления денег на карту:
  1. Получите синоним банковской карты самостоятельно или с помощью формы ЮKassa. Подойдут данные любой банковской карты.
  2. Отправьте запрос 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"
/>
Шаг 2. Проверьте идемпотентность запросов
Отправьте запрос makeDeposition с теми же данными, которые вы использовали на шаге 1. В ответ вернется результат обработки запроса, отправленного на шаге 1.
Шаг 3. Проверьте обработку ошибок зачисления
Вы можете проверить обработку ошибок зачисления на карты. Для этого выберите нужный вам сценарий и отправьте запрос makeDeposition со специальными тестовыми данными.
Ошибка зачисленияСиноним банковской картыПерсональные данныеСумма выплаты
31
Получатель перевода отклонил выплату (под получателем понимается сотовый оператор или процессинговый банк)
BFtJqriXvLaIOr0BDLdcjwgC.SC.000.201904Иванов Иван Иванович, 1234567890100 рублей или больше
46
Сумма операции слишком мала
Подойдет любой синоним, кроме тех, которые указаны в этой таблице.
Иванов Иван Иванович, 1234567890Меньше 100 рублей
48
Ошибка запроса зачисления перевода на банковский счет, карту, мобильный телефон
HW0xgquwIm-h4H9bfpiIRF3u.SC.000.201904Иванов Иван Иванович, 1234567890100 рублей или больше
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"
/>
Проведение настоящих выплат
Уточните у менеджера, что всё готово для запуска. После этого отправляйте запросы с идентификатором настоящего шлюза (agentId) и реальными данными.
Что почитать еще
Выплаты с расчетного счетаПодключение выплатЗачисление переводовТипы данныхКоды ошибок