{"name":"ЮKassa","vendor":"ЮMoney","industry":"finance","summary":"REST API ЮKassa для приема онлайн-платежей: создание и подтверждение платежей, возвраты, чеки по 54-ФЗ, автоплатежи, счета, выплаты и Безопасная сделка. Запросы — POST, GET и DELETE по HTTPS, тело POST-запросов в JSON, ответы всегда в JSON. Аутентификация — HTTP Basic: идентификатор магазина и секретный ключ.","docsUrl":"https://yookassa.ru/developers/api","coverage":{"included":["Платежи: создание, подтверждение, отмена, статус и выгрузка списка","Возвраты: полные и частичные","Чеки по 54-ФЗ вместе с платежом","Автоплатежи по сохраненному способу оплаты","Входящие HTTP-уведомления: настройка, события, проверка подлинности","Все методы API v3 с параметрами из официальной спецификации: счета, выплаты, Безопасная сделка, кассовые ссылки, участники СБП, персональные данные, webhook для партнеров, настройки магазина"],"excluded":["Полные схемы объектов (платеж, возврат, чек, выплата) — у методов только основные поля","Виджет ЮKassa, Checkout.js и мобильные SDK","Готовые SDK для PHP, Python и других языков","Сценарии выплат, Сплитования платежей и Безопасной сделки целиком","Полные справочники для чеков: признаки предмета и способа расчета, отраслевые реквизиты, маркировка"]},"scenarios":[{"id":"prinyat-oplatu-s-pereadresatsiey","title":"Принять оплату с переадресацией на ЮKassa","summary":"Покупатель платит на странице ЮKassa и возвращается на сайт. Подходит большинству интернет-магазинов.","steps":["Создай платеж: POST /payments с amount, capture: true, confirmation.type = redirect и confirmation.return_url. Передай заголовок Idempotence-Key — новый для каждой новой операции.","Сохрани id платежа в заказе и перенаправь покупателя по ссылке confirmation.confirmation_url из ответа.","Когда покупатель вернется на return_url, проверь статус на сервере: GET /payments/{payment_id}. Оплата прошла, если status = succeeded.","Если status = canceled, причина — в cancellation_details. Для повторной попытки создай новый платеж с новым ключом идемпотентности."],"code":"curl https://api.yookassa.ru/v3/payments \\\n  -X POST \\\n  -u <Идентификатор магазина>:<Секретный ключ> \\\n  -H 'Idempotence-Key: <Ключ идемпотентности>' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n        \"amount\": {\"value\": \"1000.00\", \"currency\": \"RUB\"},\n        \"capture\": true,\n        \"confirmation\": {\"type\": \"redirect\", \"return_url\": \"https://example.ru/orders/72\"},\n        \"description\": \"Оплата заказа № 72\",\n        \"metadata\": {\"order_id\": \"72\"}\n      }'","language":"bash","methods":["POST /payments","GET /payments/{payment_id}"]},{"id":"dvuhstadiynaya-oplata-zablokirovat","title":"Двухстадийная оплата: заблокировать и списать","summary":"Деньги сначала холдируются на счете покупателя и списываются, когда вы подтвердите заказ.","steps":["Создай платеж с capture: false: POST /payments. По умолчанию capture и так false.","После оплаты платеж переходит в статус waiting_for_capture. Срок, до которого его можно подтвердить или отменить, — в поле expires_at.","Спиши деньги: POST /payments/{payment_id}/capture. В amount можно передать часть суммы, если способ оплаты поддерживает частичное списание, — остаток вернется покупателю.","Если заказ не состоится, отмени платеж: POST /payments/{payment_id}/cancel. Платеж, не подтвержденный до expires_at, отменится сам, а деньги вернутся покупателю."],"code":"curl https://api.yookassa.ru/v3/payments/{payment_id}/capture \\\n  -X POST \\\n  -u <Идентификатор магазина>:<Секретный ключ> \\\n  -H 'Idempotence-Key: <Ключ идемпотентности>' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"amount\": {\"value\": \"1000.00\", \"currency\": \"RUB\"}}'","language":"bash","methods":["POST /payments","POST /payments/{payment_id}/capture","POST /payments/{payment_id}/cancel"]},{"id":"vernut-dengi-pokupatelyu","title":"Вернуть деньги покупателю","summary":"Полный или частичный возврат успешного платежа.","steps":["Проверь платеж: GET /payments/{payment_id}. Вернуть можно платеж в статусе succeeded, если refundable = true.","Создай возврат: POST /refunds с payment_id и amount — всей суммой или ее частью. Если используешь чеки, передай receipt.","Проверь итог: GET /refunds/{refund_id}. Финальные статусы — succeeded и canceled; причина отмены — в cancellation_details."],"code":"curl https://api.yookassa.ru/v3/refunds \\\n  -X POST \\\n  -u <Идентификатор магазина>:<Секретный ключ> \\\n  -H 'Idempotence-Key: <Ключ идемпотентности>' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n        \"amount\": {\n          \"value\": \"2.00\",\n          \"currency\": \"RUB\"\n        },\n        \"payment_id\": \"215d8da0-000f-50be-b000-0003308c89be\"\n      }'","language":"bash","methods":["GET /payments/{payment_id}","POST /refunds","GET /refunds/{refund_id}"]},{"id":"otpravit-chek-po-54-fz-vmeste","title":"Отправить чек по 54-ФЗ вместе с платежом","summary":"Для компаний и ИП, которые используют Чеки от ЮKassa или стороннюю онлайн-кассу.","steps":["Добавь в POST /payments объект receipt: receipt.customer с контактом покупателя (для Чеков от ЮKassa — email) и receipt.items — список позиций.","Для каждой позиции обязательны description, quantity, amount и vat_code. Для Чеков от ЮKassa vat_code: 1 — без НДС, 2 — 0%, 3 — 10%, 11 — 22%.","Укажи payment_subject (commodity — товар, service — услуга) и payment_mode (full_payment — полный расчет, full_prepayment — полная предоплата). Для сторонних касс значения сверь с официальной документацией.","Проверь, что чек зарегистрирован: GET /receipts с payment_id платежа."],"code":"curl https://api.yookassa.ru/v3/payments \\\n  -X POST \\\n  -u <Идентификатор магазина>:<Секретный ключ> \\\n  -H 'Idempotence-Key: <Ключ идемпотентности>' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n        \"amount\": {\"value\": \"1000.00\", \"currency\": \"RUB\"},\n        \"capture\": true,\n        \"confirmation\": {\"type\": \"redirect\", \"return_url\": \"https://example.ru/orders/72\"},\n        \"description\": \"Оплата заказа № 72\",\n        \"receipt\": {\n          \"customer\": {\"email\": \"user@example.ru\"},\n          \"items\": [\n            {\n              \"description\": \"Кружка\",\n              \"quantity\": 1,\n              \"amount\": {\"value\": \"1000.00\", \"currency\": \"RUB\"},\n              \"vat_code\": 1,\n              \"payment_subject\": \"commodity\",\n              \"payment_mode\": \"full_payment\"\n            }\n          ]\n        }\n      }'","language":"bash","methods":["POST /payments","GET /receipts"]},{"id":"avtoplatezhi-sohranit-sposob-oplaty","title":"Автоплатежи: сохранить способ оплаты и списывать без покупателя","summary":"Для подписок и повторных списаний. Сохранение способа оплаты доступно после согласования с менеджером ЮKassa.","steps":["Создай первый платеж с save_payment_method: true: POST /payments. Покупатель подтверждает его как обычно.","После успешной оплаты проверь в ответе GET /payments/{payment_id}, что payment_method.saved = true, и сохрани payment_method.id.","Для следующих списаний создай платеж с payment_method_id = сохраненный id: POST /payments. Подтверждение покупателя не требуется."],"code":"curl https://api.yookassa.ru/v3/payments \\\n  -X POST \\\n  -u <Идентификатор магазина>:<Секретный ключ> \\\n  -H 'Idempotence-Key: <Ключ идемпотентности>' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n        \"amount\": {\"value\": \"2.00\", \"currency\": \"RUB\"},\n        \"capture\": true,\n        \"payment_method_id\": \"<Идентификатор сохраненного способа оплаты>\",\n        \"description\": \"Заказ №37\"\n      }'","language":"bash","methods":["POST /payments","GET /payments/{payment_id}"]},{"id":"uznavat-ob-oplate-cherez-http","title":"Узнавать об оплате через HTTP-уведомления","summary":"ЮKassa сама сообщает о смене статуса платежа или возврата, не нужно опрашивать API.","steps":["В личном кабинете, в разделе Интеграция — HTTP-уведомления, укажи URL и события: payment.succeeded, payment.waiting_for_capture, payment.canceled, refund.succeeded. URL — только HTTPS на порту 443 или 8443, TLS 1.2 и выше.","Принимай POST-запрос с объектом события и отвечай HTTP 200. На любой другой код ЮKassa повторяет отправку в течение 24 часов.","Проверь подлинность: запроси объект — GET /payments/{payment_id} — и сверь статус. Еще один способ — проверить IP отправителя: 185.71.76.0/27, 185.71.77.0/27, 77.75.153.0/25, 77.75.156.11, 77.75.156.35, 77.75.154.128/25, 2a02:5180::/32.","Партнерам с OAuth-токеном подписка доступна через API: POST /webhooks."],"code":"","language":"","methods":["GET /payments/{payment_id}","POST /webhooks"]},{"id":"vygruzit-platezhi-za-period","title":"Выгрузить платежи за период","summary":"Для сверки и отчетов: список платежей с фильтром по дате и статусу.","steps":["Запроси GET /payments с created_at.gte и created_at.lt в формате ISO 8601, при необходимости — status (например, succeeded) и limit до 100.","Если в ответе есть next_cursor, запроси следующую страницу с cursor = next_cursor. Повторяй, пока next_cursor не исчезнет.","Доступны платежи, созданные за последние 3 года."],"code":"curl 'https://api.yookassa.ru/v3/payments?created_at.gte=2026-09-01T00:00:00.000Z&created_at.lt=2026-10-01T00:00:00.000Z&status=succeeded&limit=100' \\\n  -u <Идентификатор магазина>:<Секретный ключ>","language":"bash","methods":["GET /payments"]}],"baseUrls":[{"label":"Основной","url":"https://api.yookassa.ru/v3"}],"auth":{"type":"basic","description":"HTTP Basic Auth: имя пользователя — идентификатор магазина (shopId, раздел Настройки — Магазин) или шлюза для выплат (agentId, раздел Настройки выплат), пароль — секретный ключ (раздел Интеграция — Ключи API). Для тестового магазина ключ выпускается автоматически. Участники партнерской программы используют OAuth 2.0 и передают Bearer-токен. Секретный ключ и OAuth-токен нельзя публиковать.","example":"curl https://api.yookassa.ru/v3/payments/{payment_id} \\\n  -u <Идентификатор магазина>:<Секретный ключ>"},"methods":[{"id":"POST /payments","title":"Создание платежа","httpMethod":"POST","path":"/payments","description":"Чтобы принять платеж, нужно создать объект платежа — Payment. Он содержит всю необходимую информацию о платеже (сумму, валюту и статус). Платеж проходит линейный жизненный цикл, последовательно переходя из статуса в статус.","params":[{"name":"Idempotence-Key","in":"header","type":"string","required":true,"description":"Ключ идемпотентности. Рекомендуется использовать строку вида UUID v7"},{"name":"amount","in":"body","type":"object","required":true,"description":"Сумма платежа. Иногда партнеры ЮKassa берут с пользователя дополнительную комиссию, которая не входит в эту сумму. Сумма указывается вместе с кодом валюты. Валюта должна совпадать с валютой субаккаунта (recipient.gateway_id), если вы разделяете потоки платежей, и с валютой аккаунта (shopId в личном кабинете), если не разделяете."},{"name":"amount.value","in":"body","type":"string","required":true,"description":"Сумма в выбранной валюте, всегда в дробном формате. Разделитель дробной части — точка, разделителя тысяч нет. Количество знаков после точки зависит от выбранной валюты. Пример: 1000.00."},{"name":"amount.currency","in":"body","type":"string (RUB, EUR, USD, KZT, BYN, UAH, UZS, TRY)","required":true,"description":"Трехбуквенный код валюты в формате ISO-4217. Пример: RUB."},{"name":"description","in":"body","type":"string","required":false,"description":"Описание транзакции (не более 128 символов), которое вы увидите в личном кабинете ЮKassa, а пользователь — при оплате. Например: «Оплата заказа № 72 для user@yoomoney.ru»."},{"name":"receipt","in":"body","type":"object","required":false,"description":"Данные для формирования чека. Параметр передается, если вы компания или ИП и используете Чеки от ЮKassa, либо если вы компания или ИП, используете стороннюю онлайн-кассу и отправляете данные для формирования чеков по одному из сценариев: «Платеж и чек одновременно» или «Сначала чек, потом платеж»."},{"name":"receipt.customer","in":"body","type":"object","required":false,"description":"Информация о пользователе. Необходимо указать как минимум контактные данные: для Чеков от ЮKassa — электронную почту (customer.email), в остальных случаях — электронную почту (customer.email) или номер телефона (customer.phone)."},{"name":"receipt.items","in":"body","type":"object[]","required":false,"description":"Список товаров в заказе. Если вы используете Чеки от ЮKassa, можно передать до 80 товаров, если стороннюю онлайн-кассу — до 100 товаров."},{"name":"receipt.internet","in":"body","type":"boolean","required":false,"description":"Признак проведения платежа в интернете (тег в 54 ФЗ — 1125). Возможные значения: true — платеж проведен онлайн, через интернет (например, на сайте или в приложении); false — платеж проведен офлайн, при личном взаимодействии (например, в торговой точке или при встрече с курьером). По умолчанию true. Если вы принимаете платежи офлайн, передайте false."},{"name":"receipt.tax_system_code","in":"body","type":"integer","required":false,"description":"Система налогообложения магазина (тег в 54 ФЗ — 1055). Для сторонних онлайн-касс: обязательный параметр, если вы используете онлайн-кассу Атол Онлайн, обновленную до ФФД 1.2, или у вас несколько систем налогообложения; в остальных случаях не передается. Для Чеков от ЮKassa: параметр передавать не нужно, ЮKassa его проигнорирует."},{"name":"receipt.timezone","in":"body","type":"integer","required":false,"description":"Номер часовой зоны для адреса, по которому вы принимаете платежи (тег в 54 ФЗ — 1011). Указывается, только если в чеке есть товары, которые подлежат обязательной маркировке (в items.mark_code_info передается параметр gs_1m, short или fur). Перечень возможных значений: для Чеков от ЮKassa; для сторонних онлайн-касс."},{"name":"receipt.receipt_industry_details","in":"body","type":"object[]","required":false,"description":"Отраслевой реквизит чека (тег в 54 ФЗ — 1261). Можно передавать, если используете Чеки от ЮKassa или онлайн-кассу, обновленную до ФФД 1.2."},{"name":"receipt.receipt_operational_details","in":"body","type":"object","required":false,"description":"Операционный реквизит чека (тег в 54 ФЗ — 1270). Можно передавать, если используете Чеки от ЮKassa или онлайн-кассу, обновленную до ФФД 1.2."},{"name":"recipient","in":"body","type":"object","required":false,"description":"Получатель платежа. Нужен, если вы разделяете потоки платежей в рамках одного аккаунта или создаете платеж в адрес другого аккаунта."},{"name":"recipient.gateway_id","in":"body","type":"string","required":false,"description":"Идентификатор субаккаунта. Используется для разделения потоков платежей в рамках одного аккаунта."},{"name":"payment_token","in":"body","type":"string","required":false,"description":"Одноразовый токен для проведения оплаты, сформированный с помощью Checkout.js или мобильного SDK."},{"name":"payment_method_id","in":"body","type":"string","required":false,"description":"Идентификатор сохраненного способа оплаты."},{"name":"payment_method_data","in":"body","type":"object","required":false,"description":""},{"name":"payment_method_data.type","in":"body","type":"string (bank_card, cash, sberbank, tinkoff_bank, yoo_money, mobile_balance, b2b_sberbank, sbp)","required":false,"description":""},{"name":"payment_method_data.card","in":"body","type":"object","required":false,"description":"Данные банковской карты (необходимы, если вы собираете данные карты пользователей на своей стороне)."},{"name":"payment_method_data.phone","in":"body","type":"string","required":false,"description":"Телефон пользователя, на который придет смс с кодом платежа (для внесения наличных). Указывается в формате ITU-T E.164, например 79000000000. Поле можно оставить пустым: пользователь сможет заполнить его при оплате на стороне ЮKassa."},{"name":"payment_method_data.payment_purpose","in":"body","type":"string","required":false,"description":"Назначение платежа (не больше 210 символов)."},{"name":"payment_method_data.vat_data","in":"body","type":"object","required":false,"description":""},{"name":"payment_method_data.electronic_certificate","in":"body","type":"object","required":false,"description":"Данные от ФЭС НСПК для оплаты по электронному сертификату. Неоходимо передавать только при оплате со сбором данных на вашей стороне."},{"name":"payment_method_data.articles","in":"body","type":"object[]","required":false,"description":"Корзина покупки (в терминах НСПК) — список товаров, которые можно оплатить по сертификату. Необходимо передавать только при оплате на готовой странице ЮKassa."},{"name":"confirmation","in":"body","type":"object","required":false,"description":"Данные, необходимые для инициирования выбранного сценария подтверждения платежа пользователем."},{"name":"confirmation.type","in":"body","type":"string (redirect, external, qr, embedded, mobile_application)","required":false,"description":"Код сценария подтверждения платежа пользователем. Возможные значения: redirect — перенаправление пользователя на готовую страницу ЮKassa или страницу партнера; external — ожидание, что пользователь самостоятельно подтвердит платеж; qr — формирование QR-кода и его отображение на странице оплаты, чтобы пользователь подтвердил платеж; embedded — отображение платежного виджета ЮKassa; mobile_application — перенаправление пользователя в платежное приложение партнера."},{"name":"confirmation.locale","in":"body","type":"string (ru_RU, en_US)","required":false,"description":"Язык интерфейса, писем и сообщений, которые будет видеть или получать пользователь. Формат соответствует ISO/IEC 15897. Возможные значения: ru_RU, en_US. Регистр важен."},{"name":"confirmation.enforce","in":"body","type":"boolean","required":false,"description":"Запрос на проведение платежа с аутентификацией по 3-D Secure. Сработает, если вы по умолчанию принимаете оплату банковской картой без подтверждения платежа пользователем; в остальных случаях аутентификацией по 3-D Secure управляет ЮKassa. Чтобы принимать платежи без дополнительного подтверждения пользователем, напишите вашему менеджеру ЮKassa."},{"name":"confirmation.return_url","in":"body","type":"string","required":false,"description":"URL, на который вернется пользователь после подтверждения или отмены платежа на веб-странице. Не более 2048 символов."},{"name":"save_payment_method","in":"body","type":"boolean","required":false,"description":"Сохранение платежных данных для проведения автоплатежей. Возможные значения: * true — сохранить способ оплаты (сохранить платежные данные); * false — провести платеж без сохранения способа оплаты. Доступно только после согласования с менеджером ЮKassa."},{"name":"capture","in":"body","type":"boolean","required":false,"description":"Автоматический прием поступившего платежа. Возможные значения: * true — оплата списывается сразу (платеж в одну стадию); * false — оплата холдируется и списывается по вашему запросу (платеж в две стадии: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-process#capture-and-cancel). По умолчанию false."},{"name":"client_ip","in":"body","type":"string","required":false,"description":"IPv4- или IPv6-адрес пользователя. Если не указан, используется IP-адрес TCP-подключения."},{"name":"metadata","in":"body","type":"object","required":false,"description":"Любые дополнительные данные, которые нужны вам для работы (например, внутренний идентификатор заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в ответе ЮKassa. Ограничения: не более 16 ключей, название ключа — не больше 32 символов, значение ключа — не больше 512 символов, тип данных — строка в формате UTF-8."},{"name":"airline","in":"body","type":"object","required":false,"description":"Объект с данными для продажи авиабилетов. Используется только для платежей банковской картой."},{"name":"airline.ticket_number","in":"body","type":"string","required":false,"description":"Уникальный номер билета. Если номер билета известен при создании платежа, ticket_number — обязательный параметр; если неизвестен, передайте booking_reference вместо ticket_number."},{"name":"airline.booking_reference","in":"body","type":"string","required":false,"description":"Номер бронирования. Обязателен, если не указан ticket_number."},{"name":"airline.passengers","in":"body","type":"object[]","required":false,"description":"Список пассажиров."},{"name":"airline.legs","in":"body","type":"object[]","required":false,"description":"Список перелетов."},{"name":"transfers","in":"body","type":"object[]","required":false,"description":"Данные о распределении денег: суммы переводов и магазины, в пользу которых они совершаются. Передаются, если вы используете Сплитование платежей."},{"name":"deal","in":"body","type":"object","required":false,"description":"Сделка, в рамках которой проводится платеж. Передается, если вы используете Безопасную сделку."},{"name":"deal.id","in":"body","type":"string","required":false,"description":"Идентификатор сделки."},{"name":"deal.settlements","in":"body","type":"object[]","required":false,"description":"Данные о распределении денег."},{"name":"merchant_customer_id","in":"body","type":"string","required":false,"description":"Идентификатор покупателя в вашей системе, например адрес электронной почты или номер телефона. Не более 200 символов. Передается, если вы хотите сохранить банковскую карту и предложить ее для автоплатежей в платежном виджете ЮKassa."},{"name":"payment_order","in":"body","type":"object","required":false,"description":"Платежное поручение — распоряжение банку на перевод для оплаты жилищно-коммунальных услуг (ЖКУ), сведения о платеже для регистрации в ГИС ЖКХ. Нужно передавать при оплате ЖКУ. Кроме обязательных параметров, должен быть передан хотя бы один из параметров: payment_document_id, payment_document_number, account_number, unified_account_number или service_id."},{"name":"receiver","in":"body","type":"object","required":false,"description":""},{"name":"receiver.type","in":"body","type":"string (mobile_balance, digital_wallet, bank_account)","required":false,"description":"Код получателя платежа."},{"name":"receiver.phone","in":"body","type":"string","required":false,"description":"Номер телефона для пополнения. Максимум 15 символов. Указывается в формате ITU-T E.164. Пример: 79000000000."},{"name":"receiver.account_number","in":"body","type":"string","required":false,"description":"Идентификатор электронного кошелька для пополнения. Максимум 20 символов."},{"name":"receiver.bic","in":"body","type":"string","required":false,"description":"Банковский идентификационный код (БИК) банка, в котором открыт счет. Формат — 9 символов."},{"name":"statements","in":"body","type":"object[]","required":false,"description":"Данные для отправки выписок; обязательны, если пользователь должен получить выписку после платежа. Сейчас доступен один тип — выписка об оплате: информация об успешном платеже, которую ЮKassa отправляет на электронную почту пользователя. Отправляется, если платеж проведен банковской картой, через SberPay или СБП; доступна для всех сценариев интеграции."},{"name":"pos_link","in":"body","type":"object","required":false,"description":"Данные о кассовой ссылке для проведения платежа в офлайне."},{"name":"pos_link.id","in":"body","type":"string","required":false,"description":"Идентификатор кассовой ссылки в ЮKassa."},{"name":"pos_link.expires_at","in":"body","type":"string","required":false,"description":"Срок действия оплаты. Может составлять от 1 до 20 минут с момента создания платежа, по умолчанию 20 минут. Указывается по UTC и передается в формате ISO 8601. Пример: 2024-10-18T10:51:18.139Z"}],"requestExample":"{\n  \"amount\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  },\n  \"capture\": true,\n  \"confirmation\": {\n    \"type\": \"redirect\",\n    \"return_url\": \"https://example.ru/return\"\n  },\n  \"description\": \"Оплата заказа № 72\"\n}","responseExample":"{\n  \"id\": \"1da5c87d-0984-50e8-a7f3-8de646dd9ec9\",\n  \"status\": \"succeeded\",\n  \"amount\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  },\n  \"created_at\": \"2017-11-03T11:52:31.827Z\",\n  \"paid\": true,\n  \"test\": false,\n  \"refundable\": true,\n  \"recipient\": {\n    \"account_id\": \"123\",\n    \"gateway_id\": \"456\"\n  }\n}","docsUrl":"https://yookassa.ru/developers/api#create_payment"},{"id":"GET /payments","title":"Список платежей","httpMethod":"GET","path":"/payments","description":"Запрос позволяет получить список платежей. Можно запросить платежи, созданные за последние 3 года. Список можно отфильтровать по заданным критериям.","params":[{"name":"created_at.gte","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть больше или равно указанного значения («от указанного момента, включительно»). Указывается в формате ISO 8601. Пример: created_at.gte=2018-07-18T10:51:18.139Z"},{"name":"created_at.gt","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть больше указанного значения («от указанного момента, не включая»). Указывается в формате ISO 8601. Пример: created_at.gt=2018-07-18T10:51:18.139Z"},{"name":"created_at.lte","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть меньше или равно указанного значения («до указанного момента, включительно»). Указывается в формате ISO 8601. Пример: created_at.lte=2018-07-18T10:51:18.139Z"},{"name":"created_at.lt","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть меньше указанного значения («до указанного момента, не включая»). Указывается в формате ISO 8601. Пример: created_at.lt=2018-07-18T10:51:18.139Z"},{"name":"captured_at.gte","in":"query","type":"string","required":false,"description":"Фильтр по времени подтверждения платежа: время должно быть больше или равно указанного значения («от указанного момента, включительно»). Указывается в формате ISO 8601. Пример: captured_at.gte=2018-07-18T10:51:18.139Z"},{"name":"captured_at.gt","in":"query","type":"string","required":false,"description":"Фильтр по времени подтверждения платежа: время должно быть больше указанного значения («от указанного момента, не включая»). Указывается в формате ISO 8601. Пример: captured_at.gt=2018-07-18T10:51:18.139Z"},{"name":"captured_at.lte","in":"query","type":"string","required":false,"description":"Фильтр по времени подтверждения платежа: время должно быть меньше или равно указанного значения («до указанного момента, включительно»). Указывается в формате ISO 8601. Пример: captured_at.lte=2018-07-18T10:51:18.139Z"},{"name":"captured_at.lt","in":"query","type":"string","required":false,"description":"Фильтр по времени подтверждения платежа: время должно быть меньше указанного значения («до указанного момента, не включая»). Указывается в формате ISO 8601. Пример: captured_at.lt=2018-07-18T10:51:18.139Z"},{"name":"payment_method","in":"query","type":"string (bank_card, cash, alfabank, webmoney, wechat, apple_pay, google_pay, qiwi)","required":false,"description":"Фильтр по коду способа оплаты. Пример: payment_method=bank_card"},{"name":"status","in":"query","type":"string (pending, waiting_for_capture, succeeded, canceled)","required":false,"description":"Фильтр по статусу платежа. Пример: status=succeeded"},{"name":"limit","in":"query","type":"integer","required":false,"description":"Ограничение размера выдачи: количество объектов, передаваемых в ответе. Возможные значения: от 1 до 100. Пример: limit=50. Значение по умолчанию: 10"},{"name":"cursor","in":"query","type":"string","required":false,"description":"Указатель на следующий фрагмент списка. Пример: cursor=37a5c87d-3984-51e8-a7f3-8de646d39ec15. В качестве cursor нужно использовать значение параметра next_cursor из ответа на предыдущий запрос. Используется, если размер списка больше размера выдачи (limit) и конец выдачи не достигнут."}],"requestExample":"","responseExample":"{\n  \"type\": \"list\",\n  \"items\": [\n    {\n      \"id\": \"1da5c87d-0984-50e8-a7f3-8de646dd9ec9\",\n      \"status\": \"succeeded\",\n      \"amount\": {\n        \"value\": \"1000.00\",\n        \"currency\": \"RUB\"\n      },\n      \"created_at\": \"2017-11-03T11:52:31.827Z\",\n      \"paid\": true,\n      \"test\": false,\n      \"refundable\": true,\n      \"recipient\": {\n        \"account_id\": \"123\",\n        \"gateway_id\": \"456\"\n      }\n    }\n  ]\n}","docsUrl":"https://yookassa.ru/developers/api#get_payments_list"},{"id":"GET /payments/{payment_id}","title":"Информация о платеже","httpMethod":"GET","path":"/payments/{payment_id}","description":"Запрос позволяет получить информацию о текущем состоянии платежа по его уникальному идентификатору.","params":[{"name":"payment_id","in":"path","type":"string","required":true,"description":"Идентификатор платежа."}],"requestExample":"","responseExample":"{\n  \"id\": \"1da5c87d-0984-50e8-a7f3-8de646dd9ec9\",\n  \"status\": \"succeeded\",\n  \"amount\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  },\n  \"created_at\": \"2017-11-03T11:52:31.827Z\",\n  \"paid\": true,\n  \"test\": false,\n  \"refundable\": true,\n  \"recipient\": {\n    \"account_id\": \"123\",\n    \"gateway_id\": \"456\"\n  }\n}","docsUrl":"https://yookassa.ru/developers/api#get_payment"},{"id":"POST /payments/{payment_id}/capture","title":"Подтверждение платежа","httpMethod":"POST","path":"/payments/{payment_id}/capture","description":"Подтверждение готовности принять платеж: статус изменится на succeeded, и можно передать пользователю товар или услугу. Подтвердить можно только платеж в статусе waiting_for_capture и только в течение ограниченного времени (зависит от способа оплаты); иначе статус изменится на canceled, а деньги вернутся пользователю.","params":[{"name":"payment_id","in":"path","type":"string","required":true,"description":"Идентификатор платежа."},{"name":"Idempotence-Key","in":"header","type":"string","required":true,"description":"Ключ идемпотентности. Рекомендуется использовать строку вида UUID v7"},{"name":"amount","in":"body","type":"object","required":false,"description":"Итоговая сумма, которая будет списана с пользователя. Можно указать часть первоначальной суммы, чтобы вернуть остаток пользователю, если способ оплаты поддерживает частичное списание. Указывается вместе с кодом валюты, которая должна совпадать с валютой субаккаунта (recipient.gateway_id) при разделении потоков платежей или с валютой аккаунта (shopId в личном кабинете) без него."},{"name":"amount.value","in":"body","type":"string","required":false,"description":"Сумма в выбранной валюте, всегда в дробном формате. Разделитель дробной части — точка, разделителя тысяч нет. Количество знаков после точки зависит от выбранной валюты. Пример: 1000.00."},{"name":"amount.currency","in":"body","type":"string (RUB, EUR, USD, KZT, BYN, UAH, UZS, TRY)","required":false,"description":"Трехбуквенный код валюты в формате ISO-4217. Пример: RUB."},{"name":"receipt","in":"body","type":"object","required":false,"description":"Данные для формирования чека. Параметр передается, если вы компания или индивидуальный предприниматель и используете Чеки от ЮKassa, либо используете стороннюю онлайн-кассу и отправляете данные для формирования чеков по одному из сценариев: Платеж и чек одновременно или Сначала чек, потом платеж."},{"name":"receipt.customer","in":"body","type":"object","required":false,"description":"Информация о пользователе. Необходимо указать как минимум контактные данные: для Чеков от ЮKassa — электронную почту (customer.email), в остальных случаях — электронную почту (customer.email) или номер телефона (customer.phone)."},{"name":"receipt.items","in":"body","type":"object[]","required":false,"description":"Список товаров в заказе. Если вы используете Чеки от ЮKassa, можно указать до 80 товаров, если стороннюю онлайн-кассу — до 100 товаров."},{"name":"receipt.internet","in":"body","type":"boolean","required":false,"description":"Признак проведения платежа в интернете (тег в 54 ФЗ — 1125). Возможные значения: true — оплата прошла онлайн (например, на вашем сайте или в приложении); false — оплата прошла офлайн, при личном взаимодействии (например, в торговой точке или при встрече с курьером). По умолчанию true; если вы принимаете платежи офлайн, передайте false."},{"name":"receipt.tax_system_code","in":"body","type":"integer","required":false,"description":"Система налогообложения магазина (тег в 54 ФЗ — 1055). Для сторонних онлайн-касс: обязательный параметр, если вы используете онлайн-кассу Атол Онлайн, обновленную до ФФД 1.2, или у вас несколько систем налогообложения, в остальных случаях не передается. Для Чеков от ЮKassa: параметр передавать не нужно, ЮKassa его проигнорирует."},{"name":"receipt.timezone","in":"body","type":"integer","required":false,"description":"Номер часовой зоны для адреса, по которому вы принимаете платежи (тег в 54 ФЗ — 1011). Указывается, только если в чеке есть товары, которые подлежат обязательной маркировке (в items.mark_code_info передается параметр gs_1m, short или fur). Перечень возможных значений: для Чеков от ЮKassa; для сторонних онлайн-касс."},{"name":"receipt.receipt_industry_details","in":"body","type":"object[]","required":false,"description":"Отраслевой реквизит чека (тег в 54 ФЗ — 1261). Можно передавать, если используете Чеки от ЮKassa или онлайн-кассу, обновленную до ФФД 1.2."},{"name":"receipt.receipt_operational_details","in":"body","type":"object","required":false,"description":"Операционный реквизит чека (тег в 54 ФЗ — 1270). Можно передавать, если используете Чеки от ЮKassa или онлайн-кассу, обновленную до ФФД 1.2."},{"name":"airline","in":"body","type":"object","required":false,"description":"Объект с данными для продажи авиабилетов. Используется только для платежей банковской картой."},{"name":"airline.ticket_number","in":"body","type":"string","required":false,"description":"Уникальный номер билета. Если номер билета известен при создании платежа, ticket_number обязателен. Если нет — передайте booking_reference вместо ticket_number."},{"name":"airline.booking_reference","in":"body","type":"string","required":false,"description":"Номер бронирования. Обязателен, если не передан ticket_number."},{"name":"airline.passengers","in":"body","type":"object[]","required":false,"description":"Список пассажиров."},{"name":"airline.legs","in":"body","type":"object[]","required":false,"description":"Список перелетов."},{"name":"transfers","in":"body","type":"object[]","required":false,"description":"Информация о распределении денег: суммы переводов и магазины, в пользу которых они совершаются. Передается при частичном подтверждении платежа, если вы используете Сплитование платежей."},{"name":"deal","in":"body","type":"object","required":false,"description":"Сделка, в рамках которой проводится платеж. Передается при частичном подтверждении платежа, если вы используете Безопасную сделку."},{"name":"deal.settlements","in":"body","type":"object[]","required":false,"description":"Данные о распределении денег."}],"requestExample":"{\n  \"amount\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  },\n  \"receipt\": {\n    \"items\": [\n      {\n        \"description\": \"string\",\n        \"quantity\": 1,\n        \"amount\": {\n          \"value\": null,\n          \"currency\": null\n        },\n        \"vat_code\": 0\n      }\n    ]\n  },\n  \"airline\": {\n    \"ticket_number\": \"5554916004417\",\n    \"booking_reference\": \"IIIKRV\",\n    \"passengers\": [\n      {\n        \"first_name\": \"SERGEI\",\n        \"last_name\": \"IVANOV\"\n      }\n    ],\n    \"legs\": [\n      {\n        \"departure_airport\": \"LED\",\n        \"destination_airport\": \"AMS\",\n        \"departure_date\": \"2018-06-20\"\n      }\n    ]\n  },\n  \"transfers\": [\n    {\n      \"account_id\": \"123\",\n      \"amount\": {\n        \"value\": \"1000.00\",\n        \"currency\": \"RUB\"\n      }\n    }\n  ],\n  \"deal\": {\n    \"settlements\": [\n      {\n        \"type\": \"payout\",\n        \"amount\": {\n          \"value\": null,\n          \"currency\": null\n        }\n      }\n    ]\n  }\n}","responseExample":"{\n  \"id\": \"1da5c87d-0984-50e8-a7f3-8de646dd9ec9\",\n  \"status\": \"succeeded\",\n  \"amount\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  },\n  \"created_at\": \"2017-11-03T11:52:31.827Z\",\n  \"paid\": true,\n  \"test\": false,\n  \"refundable\": true,\n  \"recipient\": {\n    \"account_id\": \"123\",\n    \"gateway_id\": \"456\"\n  }\n}","docsUrl":"https://yookassa.ru/developers/api#capture_payment"},{"id":"POST /payments/{payment_id}/cancel","title":"Отмена платежа","httpMethod":"POST","path":"/payments/{payment_id}/cancel","description":"Отменяет платеж в статусе waiting_for_capture. Отмена означает, что вы не готовы выдать товар или оказать услугу пользователю; после отмены деньги начнут возвращаться на счет плательщика. Если платеж был совершен банковской картой, из кошелька ЮMoney или через SberPay, деньги вернутся сразу, если другими способами — процесс может занять до нескольких дней.","params":[{"name":"payment_id","in":"path","type":"string","required":true,"description":"Идентификатор платежа."},{"name":"Idempotence-Key","in":"header","type":"string","required":true,"description":"Ключ идемпотентности. Рекомендуется использовать строку вида UUID v7"}],"requestExample":"","responseExample":"{\n  \"id\": \"1da5c87d-0984-50e8-a7f3-8de646dd9ec9\",\n  \"status\": \"succeeded\",\n  \"amount\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  },\n  \"created_at\": \"2017-11-03T11:52:31.827Z\",\n  \"paid\": true,\n  \"test\": false,\n  \"refundable\": true,\n  \"recipient\": {\n    \"account_id\": \"123\",\n    \"gateway_id\": \"456\"\n  }\n}","docsUrl":"https://yookassa.ru/developers/api#cancel_payment"},{"id":"POST /refunds","title":"Создание возврата","httpMethod":"POST","path":"/refunds","description":"Создает возврат успешного платежа на указанную сумму. Платеж можно вернуть только в течение трех лет с момента его создания. Комиссия ЮKassa за проведение платежа не возвращается.","params":[{"name":"Idempotence-Key","in":"header","type":"string","required":true,"description":"Ключ идемпотентности. Рекомендуется использовать строку вида UUID v7"},{"name":"payment_id","in":"body","type":"string","required":true,"description":"Идентификатор платежа в ЮKassa."},{"name":"amount","in":"body","type":"object","required":true,"description":"Сумма, которую нужно вернуть пользователю. Указывается вместе с кодом валюты. Должна совпадать с валютой субаккаунта (recipient.gateway_id), если вы разделяете потоки платежей, или с валютой аккаунта (shopId в личном кабинете), если не разделяете."},{"name":"amount.value","in":"body","type":"string","required":true,"description":"Сумма в выбранной валюте, всегда в дробном формате. Разделитель дробной части — точка, разделителя тысяч нет. Количество знаков после точки зависит от выбранной валюты. Пример: 1000.00."},{"name":"amount.currency","in":"body","type":"string (RUB, EUR, USD, KZT, BYN, UAH, UZS, TRY)","required":true,"description":"Трехбуквенный код валюты в формате ISO-4217. Пример: RUB."},{"name":"description","in":"body","type":"string","required":false,"description":"Комментарий к возврату, основание для возврата денег пользователю."},{"name":"receipt","in":"body","type":"object","required":false,"description":"Данные для формирования чека. Параметр передается, если вы компания или индивидуальный предприниматель и используете Чеки от ЮKassa, либо используете стороннюю онлайн-кассу и отправляете данные для формирования чеков по одному из сценариев: Платеж и чек одновременно или Сначала чек, потом платеж."},{"name":"receipt.customer","in":"body","type":"object","required":false,"description":"Информация о пользователе. Необходимо указать как минимум контактные данные: для Чеков от ЮKassa — электронную почту (customer.email), в остальных случаях — электронную почту (customer.email) или номер телефона (customer.phone)."},{"name":"receipt.items","in":"body","type":"object[]","required":false,"description":"Список товаров в заказе. Если вы используете Чеки от ЮKassa, можно указать до 80 товаров, если стороннюю онлайн-кассу — до 100 товаров."},{"name":"receipt.internet","in":"body","type":"boolean","required":false,"description":"Признак проведения платежа в интернете (тег в 54 ФЗ — 1125). Возможные значения: true — оплата прошла онлайн (например, на вашем сайте или в приложении); false — оплата прошла офлайн, при личном взаимодействии (например, в торговой точке или при встрече с курьером). По умолчанию true; если вы принимаете платежи офлайн, передайте false."},{"name":"receipt.tax_system_code","in":"body","type":"integer","required":false,"description":"Система налогообложения магазина (тег в 54 ФЗ — 1055). Для сторонних онлайн-касс: обязательный параметр, если вы используете онлайн-кассу Атол Онлайн, обновленную до ФФД 1.2, или у вас несколько систем налогообложения, в остальных случаях не передается. Для Чеков от ЮKassa: параметр передавать не нужно, ЮKassa его проигнорирует."},{"name":"receipt.timezone","in":"body","type":"integer","required":false,"description":"Номер часовой зоны для адреса, по которому вы принимаете платежи (тег в 54 ФЗ — 1011). Указывается, только если в чеке есть товары, которые подлежат обязательной маркировке (в items.mark_code_info передается параметр gs_1m, short или fur). Перечень возможных значений: для Чеков от ЮKassa; для сторонних онлайн-касс."},{"name":"receipt.receipt_industry_details","in":"body","type":"object[]","required":false,"description":"Отраслевой реквизит чека (тег в 54 ФЗ — 1261). Можно передавать, если используете Чеки от ЮKassa или онлайн-кассу, обновленную до ФФД 1.2."},{"name":"receipt.receipt_operational_details","in":"body","type":"object","required":false,"description":"Операционный реквизит чека (тег в 54 ФЗ — 1270). Можно передавать, если используете Чеки от ЮKassa или онлайн-кассу, обновленную до ФФД 1.2."},{"name":"sources","in":"body","type":"object[]","required":false,"description":"Данные о том, с какого магазина и какую сумму нужно удержать для проведения возврата. Необходимо передавать, если вы используете Сплитование платежей. Сейчас в этом параметре можно передать данные только одного магазина."},{"name":"deal","in":"body","type":"object","required":false,"description":"Данные о сделке, в составе которой проходит возврат. Необходимо передавать, если вы проводите Безопасную сделку."},{"name":"deal.refund_settlements","in":"body","type":"object[]","required":false,"description":"Данные о распределении денег."},{"name":"refund_method_data","in":"body","type":"object","required":false,"description":"Данные для возврата платежа по электронному сертификату."},{"name":"refund_method_data.type","in":"body","type":"string (sbp, electronic_certificate)","required":false,"description":"Код способа оплаты, который использовался при проведении платежа."},{"name":"refund_method_data.electronic_certificate","in":"body","type":"object","required":false,"description":"Данные от ФЭС НСПК для возврата на электронный сертификат. Неоходимо передавать только при оплате со сбором данных на вашей стороне."},{"name":"refund_method_data.articles","in":"body","type":"object[]","required":false,"description":"Корзина возврата (в терминах НСПК) — список возвращаемых товаров, для оплаты которых использовался электронный сертификат. Данные должны соответствовать товарам из одобренной корзины покупки (articles в объекте платежа: https://yookassa.ru/developers/api#payment_object). Необходимо передавать только при оплате на готовой странице ЮKassa."},{"name":"metadata","in":"body","type":"object","required":false,"description":"Любые дополнительные данные, которые нужны вам для работы (например, ваш внутренний идентификатор заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в ответе от ЮKassa. Ограничения: не более 16 ключей, не более 32 символов в названии ключа, не более 512 символов в значении ключа, тип данных — строка в формате UTF-8."}],"requestExample":"{\n  \"payment_id\": \"1da5c87d-0984-50e8-a7f3-8de646dd9ec9\",\n  \"amount\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  }\n}","responseExample":"{\n  \"id\": \"1ddd77af-0bd7-500d-895b-c475c55fdefc\",\n  \"payment_id\": \"1da5c87d-0984-50e8-a7f3-8de646dd9ec9\",\n  \"amount\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  },\n  \"status\": \"succeeded\",\n  \"created_at\": \"2017-11-03T11:52:31.827Z\"\n}","docsUrl":"https://yookassa.ru/developers/api#create_refund"},{"id":"GET /refunds","title":"Список возвратов","httpMethod":"GET","path":"/refunds","description":"Возвращает список возвратов. Доступны возвраты, созданные за последние 3 года. Список можно фильтровать по заданным критериям.","params":[{"name":"created_at.gte","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть больше указанного значения или равно ему («от момента, включительно»). Указывается в формате ISO 8601. Пример: created_at.gte=2018-07-18T10:51:18.139Z"},{"name":"created_at.gt","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть больше указанного значения («от момента, не включая его»). Указывается в формате ISO 8601. Пример: created_at.gt=2018-07-18T10:51:18.139Z"},{"name":"created_at.lte","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть меньше указанного значения или равно ему («до момента, включительно»). Указывается в формате ISO 8601. Пример: created_at.lte=2018-07-18T10:51:18.139Z"},{"name":"created_at.lt","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть меньше указанного значения («до момента, не включая его»). Указывается в формате ISO 8601. Пример: created_at.lt=2018-07-18T10:51:18.139Z"},{"name":"payment_id","in":"query","type":"string","required":false,"description":"Фильтр по идентификатору платежа (получить все возвраты по платежу). Пример: payment_id=1da5c87d-0984-50e8-a7f3-8de646dd9ec9"},{"name":"status","in":"query","type":"string (pending, succeeded, canceled)","required":false,"description":"Фильтр по статусу возврата. Возможные значения: pending — в обработке, succeeded — успешно выполнен, canceled — отменен. Пример: status=succeeded"},{"name":"limit","in":"query","type":"integer","required":false,"description":"Размер выдачи результатов запроса — количество объектов, передаваемых в ответе. Возможные значения: от 1 до 100. Пример: limit=50. Значение по умолчанию: 10."},{"name":"cursor","in":"query","type":"string","required":false,"description":"Указатель на следующий фрагмент списка. Пример: cursor=37a5c87d-3984-51e8-a7f3-8de646d39ec15. В качестве cursor нужно использовать значение параметра next_cursor из ответа на предыдущий запрос. Используется, если размер списка больше размера выдачи (limit) и конец выдачи не достигнут."}],"requestExample":"","responseExample":"{\n  \"type\": \"list\",\n  \"items\": [\n    {\n      \"id\": \"1ddd77af-0bd7-500d-895b-c475c55fdefc\",\n      \"payment_id\": \"1da5c87d-0984-50e8-a7f3-8de646dd9ec9\",\n      \"amount\": {\n        \"value\": \"1000.00\",\n        \"currency\": \"RUB\"\n      },\n      \"status\": \"succeeded\",\n      \"created_at\": \"2017-11-03T11:52:31.827Z\"\n    }\n  ]\n}","docsUrl":"https://yookassa.ru/developers/api#get_refunds_list"},{"id":"GET /refunds/{refund_id}","title":"Информация о возврате","httpMethod":"GET","path":"/refunds/{refund_id}","description":"Запрос позволяет получить информацию о текущем состоянии возврата по его уникальному идентификатору.","params":[{"name":"refund_id","in":"path","type":"string","required":true,"description":"Идентификатор возврата."}],"requestExample":"","responseExample":"{\n  \"id\": \"1ddd77af-0bd7-500d-895b-c475c55fdefc\",\n  \"payment_id\": \"1da5c87d-0984-50e8-a7f3-8de646dd9ec9\",\n  \"amount\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  },\n  \"status\": \"succeeded\",\n  \"created_at\": \"2017-11-03T11:52:31.827Z\"\n}","docsUrl":"https://yookassa.ru/developers/api#get_refund"},{"id":"POST /receipts","title":"Создание чека","httpMethod":"POST","path":"/receipts","description":"Используйте этот запрос при оплате с соблюдением требований 54-ФЗ, чтобы создать чек зачета предоплаты. Если вы работаете по сценарию «Сначала платеж, потом чек», в запросе также нужно передавать данные для формирования чека прихода и чека возврата прихода.","params":[{"name":"Idempotence-Key","in":"header","type":"string","required":true,"description":"Ключ идемпотентности. Рекомендуется использовать строку вида UUID v7"},{"name":"type","in":"body","type":"string (payment, refund)","required":true,"description":"Тип чека в онлайн-кассе. Возможные значения: payment (приход), refund (возврат прихода)."},{"name":"payment_id","in":"body","type":"string","required":false,"description":"Идентификатор платежа в ЮKassa для отображения информации о чеке в личном кабинете; на платеж не влияет. Обязателен при создании чека платежа (тип чека: payment, статус платежа: waiting_for_capture или succeeded) и чека возврата для отмененных или частично подтвержденных платежей (тип чека: refund, статус платежа: canceled или succeeded). Для одного платежа можно создать до 50 чеков."},{"name":"refund_id","in":"body","type":"string","required":false,"description":"Идентификатор возврата в ЮKassa для отображения информации о чеке в личном кабинете. Обязателен при создании чека возврата (тип чека: refund, статус платежа: succeeded). Для одного возврата можно создать до 50 чеков."},{"name":"customer","in":"body","type":"object","required":true,"description":"Информация о пользователе. Необходимо указать как минимум контактные данные: для Чеков от ЮKassa — электронную почту (customer.email), в остальных случаях — электронную почту (customer.email) или номер телефона (customer.phone)."},{"name":"customer.full_name","in":"body","type":"string","required":false,"description":"Для юрлица — название организации, для ИП и физического лица — ФИО. Если у физлица отсутствует ИНН, в этом же параметре передаются паспортные данные. Не более 256 символов. Можно передавать, если используете Чеки от ЮKassa или онлайн-кассу Orange Data, Атол Онлайн."},{"name":"customer.inn","in":"body","type":"string","required":false,"description":"ИНН пользователя (10 или 12 цифр). Если у физического лица отсутствует ИНН, необходимо передать паспортные данные в параметре full_name. Можно передавать, если используете Чеки от ЮKassa или онлайн-кассу Orange Data, Атол Онлайн."},{"name":"customer.email","in":"body","type":"string","required":false,"description":"Адрес электронной почты пользователя для отправки чека. Обязательный параметр, если вы используете Чеки от ЮKassa или стороннюю онлайн-кассу и не передаете параметр phone."},{"name":"customer.phone","in":"body","type":"string","required":false,"description":"Телефон пользователя для отправки чека. Указывается в формате ITU-T E.164, например 79000000000. Обязательный параметр, если не передан email."},{"name":"items","in":"body","type":"object[]","required":true,"description":"Список товаров в чеке: не более 80 позиций для Чеков от ЮKassa, не более 100 позиций для сторонних онлайн-касс."},{"name":"internet","in":"body","type":"boolean","required":false,"description":"Признак проведения платежа в интернете (тег в 54 ФЗ — 1125). Возможные значения: true — оплата прошла онлайн, через интернет (например, на вашем сайте или в приложении); false — оплата прошла офлайн, при личном взаимодействии (например, в торговой точке или при встрече с курьером). По умолчанию true; если вы принимаете платежи офлайн, передайте в запросе значение false."},{"name":"send","in":"body","type":"boolean","required":true,"description":"Формирование чека в онлайн-кассе сразу после создания объекта чека. Сейчас можно передать только значение true."},{"name":"tax_system_code","in":"body","type":"integer","required":false,"description":"Система налогообложения магазина (тег в 54 ФЗ — 1055). Для сторонних онлайн-касс: обязательный параметр, если вы используете онлайн-кассу Атол Онлайн, обновленную до ФФД 1.2, или у вас несколько систем налогообложения, в остальных случаях не передается. Для Чеков от ЮKassa: параметр передавать не нужно, ЮKassa его проигнорирует."},{"name":"timezone","in":"body","type":"integer","required":false,"description":"Номер часовой зоны для адреса, по которому вы принимаете платежи (тег в 54 ФЗ — 1011). Указывается, только если в чеке есть товары, которые подлежат обязательной маркировке (в items.mark_code_info передается параметр gs_1m, short или fur). Перечень возможных значений: для Чеков от ЮKassa; для сторонних онлайн-касс."},{"name":"additional_user_props","in":"body","type":"object","required":false,"description":"Дополнительный реквизит пользователя (тег в 54 ФЗ — 1084). Можно передавать, если вы отправляете данные для формирования чека по сценарию Сначала платеж, потом чек"},{"name":"additional_user_props.name","in":"body","type":"string","required":false,"description":"Наименование дополнительного реквизита пользователя (тег в 54 ФЗ — 1085). Не более 64 символов."},{"name":"additional_user_props.value","in":"body","type":"string","required":false,"description":"Значение дополнительного реквизита пользователя (тег в 54 ФЗ — 1086). Не более 234 символов."},{"name":"receipt_industry_details","in":"body","type":"object[]","required":false,"description":"Отраслевой реквизит чека (тег в 54 ФЗ — 1261). Нужно передавать, если используете ФФД 1.2."},{"name":"receipt_operational_details","in":"body","type":"object","required":false,"description":"Операционный реквизит чека (тег в 54 ФЗ — 1270). Нужно передавать, если используете ФФД 1.2."},{"name":"receipt_operational_details.operation_id","in":"body","type":"integer","required":false,"description":"Идентификатор операции (тег в 54 ФЗ — 1271). Число от 0 до 255."},{"name":"receipt_operational_details.value","in":"body","type":"string","required":false,"description":"Данные операции (тег в 54 ФЗ — 1272)."},{"name":"receipt_operational_details.created_at","in":"body","type":"string","required":false,"description":"Время создания операции (тег в 54 ФЗ — 1273). Указывается по UTC и передается в формате ISO 8601. Пример: 2017-11-03T11:52:31.827Z"},{"name":"settlements","in":"body","type":"object[]","required":true,"description":"Перечень совершенных расчетов."},{"name":"on_behalf_of","in":"body","type":"string","required":false,"description":"Идентификатор магазина, от имени которого нужно отправить чек. Выдается ЮKassa, отображается в разделе Продавцы личного кабинета (столбец shopId). Необходимо передавать, если вы используете Сплитование платежей."}],"requestExample":"{\n  \"customer\": {\n    \"full_name\": \"Иванов Иван Иванович\",\n    \"inn\": \"6321341814\",\n    \"email\": \"user@yoomoney.ru\",\n    \"phone\": \"79000000000\"\n  },\n  \"type\": \"payment\",\n  \"send\": true,\n  \"settlements\": [\n    {\n      \"type\": \"cashless\",\n      \"amount\": {\n        \"value\": \"1000.00\",\n        \"currency\": \"RUB\"\n      }\n    }\n  ],\n  \"items\": [\n    {\n      \"description\": \"string\",\n      \"quantity\": 1,\n      \"amount\": {\n        \"value\": \"1000.00\",\n        \"currency\": \"RUB\"\n      },\n      \"vat_code\": 0\n    }\n  ]\n}","responseExample":"{\n  \"id\": \"rt-1da5c87d-0984-50e8-a7f3-8de646dd9ec9\",\n  \"type\": \"payment\",\n  \"status\": \"succeeded\",\n  \"items\": [\n    {\n      \"description\": \"string\",\n      \"quantity\": 1,\n      \"amount\": {\n        \"value\": \"1000.00\",\n        \"currency\": \"RUB\"\n      },\n      \"vat_code\": 0\n    }\n  ]\n}","docsUrl":"https://yookassa.ru/developers/api#create_receipt"},{"id":"GET /receipts","title":"Список чеков","httpMethod":"GET","path":"/receipts","description":"Запрос позволяет получить список чеков, отфильтрованный по заданным критериям. Можно запросить чеки по конкретному платежу, чеки по конкретному возврату или все чеки магазина.","params":[{"name":"created_at.gte","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть больше указанного значения или равно ему («от такого-то момента включительно»). Указывается в формате ISO 8601. Пример: created_at.gte=2018-07-18T10:51:18.139Z"},{"name":"created_at.gt","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть больше указанного значения («от такого-то момента не включительно»). Указывается в формате ISO 8601. Пример: created_at.gt=2018-07-18T10:51:18.139Z"},{"name":"created_at.lte","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть меньше указанного значения или равно ему («до такого-то момента включительно»). Указывается в формате ISO 8601. Пример: created_at.lte=2018-07-18T10:51:18.139Z"},{"name":"created_at.lt","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть меньше указанного значения («до такого-то момента не включительно»). Указывается в формате ISO 8601. Пример: created_at.lt=2018-07-18T10:51:18.139Z"},{"name":"status","in":"query","type":"string (pending, succeeded, canceled)","required":false,"description":"Фильтр по статусу чека. Возможные значения: pending — в обработке, succeeded — успешно зарегистрирован, canceled — отменен. Пример: status=succeeded"},{"name":"payment_id","in":"query","type":"string","required":false,"description":"Фильтр по идентификатору платежа (получить все чеки для указанного платежа). Пример: payment_id=1da5c87d-0984-50e8-a7f3-8de646dd9ec9 В запросе можно передать только что-то одно: или идентификатор платежа, или идентификатор возврата."},{"name":"refund_id","in":"query","type":"string","required":false,"description":"Фильтр по идентификатору возврата (получить все чеки для указанного возврата). Пример: refund_id=1da5c87d-0984-50e8-a7f3-8de646dd9ec9 В запросе можно передать только что-то одно: или идентификатор платежа, или идентификатор возврата."},{"name":"limit","in":"query","type":"integer","required":false,"description":"Размер выдачи результатов запроса — количество объектов, передаваемых в ответе. Возможные значения: от 1 до 100. Пример: limit=50. Значение по умолчанию: 10"},{"name":"cursor","in":"query","type":"string","required":false,"description":"Указатель на следующий фрагмент списка. Пример: cursor=37a5c87d-3984-51e8-a7f3-8de646d39ec15. В качестве cursor необходимо использовать значение параметра next_cursor, полученное в ответе на предыдущий запрос. Используется, если размер списка больше размера выдачи (limit) и конец выдачи не достигнут."}],"requestExample":"","responseExample":"{\n  \"type\": \"list\",\n  \"items\": [\n    {\n      \"id\": \"rt-1da5c87d-0984-50e8-a7f3-8de646dd9ec9\",\n      \"type\": \"payment\",\n      \"status\": \"succeeded\",\n      \"items\": [\n        {\n          \"description\": null,\n          \"quantity\": null,\n          \"amount\": null,\n          \"vat_code\": null\n        }\n      ]\n    }\n  ]\n}","docsUrl":"https://yookassa.ru/developers/api#get_receipts_list"},{"id":"GET /receipts/{receipt_id}","title":"Информация о чеке","httpMethod":"GET","path":"/receipts/{receipt_id}","description":"Запрос позволяет получить информацию о текущем состоянии чека по его уникальному идентификатору.","params":[{"name":"receipt_id","in":"path","type":"string","required":true,"description":"Идентификатор чека."}],"requestExample":"","responseExample":"{\n  \"id\": \"rt-1da5c87d-0984-50e8-a7f3-8de646dd9ec9\",\n  \"type\": \"payment\",\n  \"status\": \"succeeded\",\n  \"items\": [\n    {\n      \"description\": \"string\",\n      \"quantity\": 1,\n      \"amount\": {\n        \"value\": \"1000.00\",\n        \"currency\": \"RUB\"\n      },\n      \"vat_code\": 0\n    }\n  ]\n}","docsUrl":"https://yookassa.ru/developers/api#get_receipt"},{"id":"GET /me","title":"Информация о настройках магазина или шлюза","httpMethod":"GET","path":"/me","description":"С помощью этого запроса можно получить информацию о магазине или шлюзе. Для Сплитования платежей в запросе нужно передать параметр on_behalf_of с идентификатором магазина продавца и ваши данные для аутентификации (идентификатор и секретный ключ вашей платформы). Для партнеров нужно передать OAuth-токен магазина. Для выплат нужно передать ваши данные для аутентификации (идентификатор и секретный ключ вашего шлюза).","params":[{"name":"on_behalf_of","in":"query","type":"string","required":false,"description":"Только для тех, кто использует Сплитование платежей. Идентификатор магазина продавца, подключенного к вашей платформе, информацию о котором нужно получить."}],"requestExample":"","responseExample":"{\n  \"account_id\": \"123\",\n  \"test\": true,\n  \"status\": \"enabled\"\n}","docsUrl":"https://yookassa.ru/developers/api#get_me"},{"id":"POST /webhooks","title":"Создание webhook","httpMethod":"POST","path":"/webhooks","description":"С помощью этого запроса можно подписаться на уведомления о событии (например, об изменении статуса платежа на succeeded). Через вебхуки можно подписаться только на события платежей и возвратов; чтобы получать уведомления о нескольких событиях, нужно создать отдельный вебхук для каждого из них. Для каждого OAuth-токена нужен свой набор вебхуков.","params":[{"name":"Idempotence-Key","in":"header","type":"string","required":true,"description":"Ключ идемпотентности. Рекомендуется использовать строку вида UUID v7"},{"name":"event","in":"body","type":"string (payment.waiting_for_capture, payment.succeeded, payment.canceled, refund.succeeded, payment_method.active)","required":true,"description":"Событие, которое вы хотите отслеживать."},{"name":"url","in":"body","type":"string","required":true,"description":"URL, на который ЮKassa будет отправлять уведомления."}],"requestExample":"{\n  \"event\": \"payment.succeeded\",\n  \"url\": \"https://www.example.com/notification_url\"\n}","responseExample":"{\n  \"id\": \"wh-e44e8088-bd73-43b1-959a-954f3a7d0c54\",\n  \"event\": \"payment.succeeded\",\n  \"url\": \"https://www.example.com/notification_url\"\n}","docsUrl":"https://yookassa.ru/developers/api#create_webhook"},{"id":"GET /webhooks","title":"Список созданных webhook","httpMethod":"GET","path":"/webhooks","description":"С помощью этого запроса можно проверить, какие вебхуки доступны для переданного OAuth-токена.","params":[],"requestExample":"","responseExample":"{\n  \"type\": \"list\",\n  \"items\": [\n    {\n      \"id\": \"wh-e44e8088-bd73-43b1-959a-954f3a7d0c54\",\n      \"event\": \"payment.succeeded\",\n      \"url\": \"https://www.example.com/notification_url\"\n    }\n  ]\n}","docsUrl":"https://yookassa.ru/developers/api#get_webhook_list"},{"id":"DELETE /webhooks/{webhook_id}","title":"Удаление webhook","httpMethod":"DELETE","path":"/webhooks/{webhook_id}","description":"С помощью этого запроса можно отписаться от уведомлений о событиях для переданного OAuth-токена. Чтобы удалить вебхук, укажите его идентификатор в запросе.","params":[{"name":"webhook_id","in":"path","type":"string","required":true,"description":"Идентификатор webhook-a."}],"requestExample":"","responseExample":"{}","docsUrl":"https://yookassa.ru/developers/api#delete_webhook"},{"id":"POST /payment_methods","title":"Создание способа оплаты","httpMethod":"POST","path":"/payment_methods","description":"Создает в ЮKassa объект способа оплаты. В запросе передайте код способа оплаты, который хотите сохранить, и при необходимости дополнительные параметры нужной функциональности. Идентификатор созданного способа оплаты можно использовать при проведении автоплатежей или выплат.","params":[{"name":"Idempotence-Key","in":"header","type":"string","required":true,"description":"Ключ идемпотентности. Рекомендуется использовать строку вида UUID v7"},{"name":"type","in":"body","type":"string (bank_card, sbp)","required":true,"description":""},{"name":"holder","in":"body","type":"object","required":false,"description":"Данные магазина, для которого сохраняется способ оплаты."},{"name":"holder.gateway_id","in":"body","type":"string","required":false,"description":"Идентификатор субаккаунта. Используется для разделения потоков платежей в рамках одного аккаунта."},{"name":"client_ip","in":"body","type":"string","required":false,"description":"IPv4- или IPv6-адрес пользователя. Если не указан, используется IP-адрес TCP-соединения."},{"name":"confirmation","in":"body","type":"object","required":false,"description":""},{"name":"confirmation.type","in":"body","type":"string (redirect, qr)","required":false,"description":"Код сценария подтверждения пользователем привязки платежного средства к вашему магазину в ЮKassa."},{"name":"confirmation.enforce","in":"body","type":"boolean","required":false,"description":"Запрос на проведение привязки с аутентификацией по 3-D Secure. Сработает, если вы по умолчанию принимаете оплату банковской картой без подтверждения платежа пользователем; в остальных случаях аутентификацией по 3-D Secure управляет ЮKassa. Чтобы принимать платежи и создавать привязки без дополнительного подтверждения пользователем, напишите вашему менеджеру ЮKassa."},{"name":"confirmation.return_url","in":"body","type":"string","required":false,"description":"URL, на который вернется пользователь после подтверждения или отмены привязки на веб-странице. Не более 2048 символов."},{"name":"confirmation.locale","in":"body","type":"string (ru_RU, en_US)","required":false,"description":"Язык интерфейса, писем и смс, которые будут показаны или отправлены пользователю. Формат соответствует ISO/IEC 15897. Возможные значения: ru_RU, en_US. Регистр важен."},{"name":"metadata","in":"body","type":"object","required":false,"description":"Любые дополнительные данные, которые нужны вам для работы (например, ваш внутренний идентификатор заказа). Передаются в виде набора пар «ключ — значение» и возвращаются в ответе от ЮKassa. Ограничения: не более 16 ключей, имя ключа — не более 32 символов, значение ключа — не более 512 символов, тип данных — строка в формате UTF-8."},{"name":"card","in":"body","type":"object","required":false,"description":"Данные банковской карты (необходимы, если вы собираете данные карты пользователей на своей стороне)."},{"name":"card.number","in":"body","type":"string","required":false,"description":"Номер банковской карты."},{"name":"card.expiry_year","in":"body","type":"string","required":false,"description":"Срок действия, год, YYYY."},{"name":"card.expiry_month","in":"body","type":"string","required":false,"description":"Срок действия, месяц, MM."},{"name":"card.cardholder","in":"body","type":"string","required":false,"description":"Имя владельца карты."},{"name":"card.csc","in":"body","type":"string","required":false,"description":"Код CVC2 или CVV2, 3 или 4 символа, печатается на обратной стороне карты."}],"requestExample":"{\n  \"type\": \"bank_card\"\n}","responseExample":"{\n  \"id\": \"1da5c87d-0984-50e8-a7f3-8de646dd9ec9\",\n  \"type\": \"bank_card\",\n  \"saved\": true,\n  \"status\": \"active\",\n  \"holder\": {\n    \"account_id\": \"123\"\n  }\n}","docsUrl":"https://yookassa.ru/developers/api#create_payment_method"},{"id":"GET /payment_methods/{payment_method_id}","title":"Информация о способе оплаты","httpMethod":"GET","path":"/payment_methods/{payment_method_id}","description":"Используйте этот запрос, чтобы получить информацию о текущем состоянии способа оплаты по его уникальному идентификатору.","params":[{"name":"payment_method_id","in":"path","type":"string","required":true,"description":"Идентификатор сохраненного способа оплаты."}],"requestExample":"","responseExample":"{\n  \"id\": \"1da5c87d-0984-50e8-a7f3-8de646dd9ec9\",\n  \"type\": \"bank_card\",\n  \"saved\": true,\n  \"status\": \"active\",\n  \"holder\": {\n    \"account_id\": \"123\"\n  }\n}","docsUrl":"https://yookassa.ru/developers/api#get_payment_method"},{"id":"POST /invoices","title":"Создание счета","httpMethod":"POST","path":"/invoices","description":"Создает в ЮKassa объект счета. В запросе передайте данные о заказе, которые отобразятся на странице счета, и данные для проведения платежа.","params":[{"name":"Idempotence-Key","in":"header","type":"string","required":true,"description":"Ключ идемпотентности. Рекомендуется использовать строку вида UUID v7"},{"name":"payment_data","in":"body","type":"object","required":true,"description":"Данные для проведения платежа по выставленному счету."},{"name":"payment_data.amount","in":"body","type":"object","required":true,"description":"Сумма платежа. Должна быть в пределах лимитов. Указывается вместе с кодом валюты. Должна совпадать с валютой субаккаунта (recipient.gateway_id), если вы разделяете потоки платежей, или с валютой аккаунта (shopId в личном кабинете), если не разделяете."},{"name":"payment_data.receipt","in":"body","type":"object","required":false,"description":"Данные для формирования чека. Параметр передается, если вы компания или индивидуальный предприниматель и используете Чеки от ЮKassa, либо используете стороннюю онлайн-кассу и отправляете данные для формирования чеков по одному из сценариев: Платеж и чек одновременно или Сначала чек, потом платеж."},{"name":"payment_data.recipient","in":"body","type":"object","required":false,"description":"Получатель платежа. Нужен, если вы разделяете потоки платежей в рамках одного аккаунта или создаете платеж в адрес другого аккаунта."},{"name":"payment_data.save_payment_method","in":"body","type":"boolean","required":false,"description":"Сохранение платежных данных для проведения автоплатежей. Возможные значения: * true — сохранить способ оплаты (сохранить платежные данные); * false — провести платеж без сохранения способа оплаты. Доступно только после согласования с менеджером ЮKassa."},{"name":"payment_data.capture","in":"body","type":"boolean","required":false,"description":"Автоматический прием поступившего платежа. Возможные значения: * true — оплата списывается сразу (платеж в одну стадию); * false — оплата холдируется и списывается по вашему запросу (платеж в две стадии: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-process#capture-and-cancel). По умолчанию false."},{"name":"payment_data.client_ip","in":"body","type":"string","required":false,"description":"IPv4- или IPv6-адрес пользователя. Если не указан, используется IP-адрес TCP-соединения."},{"name":"payment_data.description","in":"body","type":"string","required":false,"description":"Описание транзакции (не более 128 символов), которое вы увидите в личном кабинете ЮKassa, а пользователь — при оплате. Например: «Оплата заказа № 72 для user@yoomoney.ru»."},{"name":"payment_data.metadata","in":"body","type":"object","required":false,"description":"Любые дополнительные данные, которые нужны вам для работы (например, ваш внутренний идентификатор заказа). Передаются в виде набора пар «ключ — значение» и возвращаются в ответе от ЮKassa. Ограничения: не более 16 ключей, имя ключа — не более 32 символов, значение ключа — не более 512 символов, тип данных — строка в формате UTF-8."},{"name":"cart","in":"body","type":"object[]","required":true,"description":"Корзина заказа — список товаров или услуг, который отобразится на странице счета перед оплатой."},{"name":"delivery_method_data","in":"body","type":"object","required":false,"description":""},{"name":"delivery_method_data.type","in":"body","type":"string (self, sms, email)","required":false,"description":"Код способа доставки счета."},{"name":"delivery_method_data.phone","in":"body","type":"string","required":false,"description":"Номер телефона, на который ЮKassa отправит смс со ссылкой на счет. Указывается в формате ITU-T E.164, например 79000000000."},{"name":"delivery_method_data.email","in":"body","type":"string","required":false,"description":"Адрес электронной почты, на который ЮKassa отправит письмо со ссылкой на счет."},{"name":"expires_at","in":"body","type":"string","required":true,"description":"Срок действия счета — дата и время, до которых можно оплатить выставленный счет. Указывается по UTC и передается в формате ISO 8601. Пример: 2024-10-18T10:51:18.139Z"},{"name":"locale","in":"body","type":"string (ru_RU, en_US)","required":false,"description":"Язык интерфейса, писем и смс, которые будут показаны или отправлены пользователю. Формат соответствует ISO/IEC 15897. Возможные значения: ru_RU, en_US. Регистр важен."},{"name":"description","in":"body","type":"string","required":false,"description":"Описание выставленного счета (не более 128 символов), которое вы увидите в личном кабинете ЮKassa, а пользователь на странице счета. Например: «Счет на оплату по договору 37»."},{"name":"metadata","in":"body","type":"object","required":false,"description":"Любые дополнительные данные, которые нужны вам для работы (например, ваш внутренний идентификатор заказа). Передаются в виде набора пар «ключ — значение» и возвращаются в ответе от ЮKassa. Ограничения: не более 16 ключей, имя ключа — не более 32 символов, значение ключа — не более 512 символов, тип данных — строка в формате UTF-8."}],"requestExample":"{\n  \"payment_data\": {\n    \"amount\": {\n      \"value\": \"1000.00\",\n      \"currency\": \"RUB\"\n    }\n  },\n  \"cart\": [\n    {\n      \"description\": \"string\",\n      \"price\": {\n        \"value\": \"1000.00\",\n        \"currency\": \"RUB\"\n      },\n      \"quantity\": 1\n    }\n  ],\n  \"expires_at\": \"2024-10-18T10:51:18.139Z\"\n}","responseExample":"{\n  \"id\": \"in-e44e8088-bd73-43b1-959a-954f3a7d0c54\",\n  \"status\": \"succeeded\",\n  \"cart\": [\n    {\n      \"description\": \"string\",\n      \"price\": {\n        \"value\": \"1000.00\",\n        \"currency\": \"RUB\"\n      },\n      \"quantity\": 1\n    }\n  ],\n  \"created_at\": \"2017-11-03T11:52:31.827Z\"\n}","docsUrl":"https://yookassa.ru/developers/api#create_invoice"},{"id":"GET /invoices/{invoice_id}","title":"Информация о счете","httpMethod":"GET","path":"/invoices/{invoice_id}","description":"Используйте этот запрос, чтобы получить информацию о текущем состоянии счета по его уникальному идентификатору.","params":[{"name":"invoice_id","in":"path","type":"string","required":true,"description":"Идентификатор счета в ЮKassa."}],"requestExample":"","responseExample":"{\n  \"id\": \"in-e44e8088-bd73-43b1-959a-954f3a7d0c54\",\n  \"status\": \"succeeded\",\n  \"cart\": [\n    {\n      \"description\": \"string\",\n      \"price\": {\n        \"value\": \"1000.00\",\n        \"currency\": \"RUB\"\n      },\n      \"quantity\": 1\n    }\n  ],\n  \"created_at\": \"2017-11-03T11:52:31.827Z\"\n}","docsUrl":"https://yookassa.ru/developers/api#get_invoice"},{"id":"POST /deals","title":"Создание сделки","httpMethod":"POST","path":"/deals","description":"Отправьте запрос, чтобы создать сделку, в рамках которой нужно принять платеж от покупателя и перевести его продавцу.","params":[{"name":"Idempotence-Key","in":"header","type":"string","required":true,"description":"Ключ идемпотентности. Рекомендуется использовать строку вида UUID v7"},{"name":"type","in":"body","type":"string (safe_deal)","required":true,"description":"Тип сделки. Фиксированное значение: safe_deal — Безопасная сделка."},{"name":"fee_moment","in":"body","type":"string (payment_succeeded, deal_closed)","required":true,"description":"Момент, когда вам зачисляется вознаграждение маркетплейса. Возможные значения: payment_succeeded — после успешной оплаты; deal_closed — после закрытия сделки по итогам успешной выплаты."},{"name":"metadata","in":"body","type":"object","required":false,"description":"Любые дополнительные данные, которые нужны вам для работы (например, ваш внутренний идентификатор заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в ответе от ЮKassa. Ограничения: не более 16 ключей, не более 32 символов в названии ключа, не более 512 символов в значении ключа, тип данных — строка в формате UTF-8."},{"name":"description","in":"body","type":"string","required":false,"description":"Описание сделки (не более 128 символов). Используется для фильтрации при получении списка сделок."}],"requestExample":"{\n  \"type\": \"safe_deal\",\n  \"fee_moment\": \"payment_succeeded\"\n}","responseExample":"{\n  \"type\": \"safe_deal\",\n  \"id\": \"dl-d68d2fe4-2abb-47e5-8112-32e28f87fb52\",\n  \"balance\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  },\n  \"payout_balance\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  },\n  \"status\": \"closed\",\n  \"created_at\": \"2020-07-03T11:52:31.827Z\",\n  \"expires_at\": \"2021-01-03T18:31:22.532Z\",\n  \"test\": false,\n  \"fee_moment\": \"payment_succeeded\"\n}","docsUrl":"https://yookassa.ru/developers/api#create_deal"},{"id":"GET /deals","title":"Список сделок","httpMethod":"GET","path":"/deals","description":"Запрос позволяет получить список сделок, отфильтрованный по заданным критериям.","params":[{"name":"created_at.gte","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть больше указанного значения или равно ему («от такого-то момента включительно»). Указывается в формате ISO 8601. Пример: created_at.gte=2018-07-18T10:51:18.139Z"},{"name":"created_at.gt","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть больше указанного значения («от такого-то момента не включительно»). Указывается в формате ISO 8601. Пример: created_at.gt=2018-07-18T10:51:18.139Z"},{"name":"created_at.lte","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть меньше указанного значения или равно ему («до такого-то момента включительно»). Указывается в формате ISO 8601. Пример: created_at.lte=2018-07-18T10:51:18.139Z"},{"name":"created_at.lt","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть меньше указанного значения («до такого-то момента не включительно»). Указывается в формате ISO 8601. Пример: created_at.lt=2018-07-18T10:51:18.139Z"},{"name":"expires_at.gte","in":"query","type":"string","required":false,"description":"Фильтр по времени автоматического закрытия сделки: время должно быть больше указанного значения или равно ему («от такого-то момента включительно»). Указывается в формате ISO 8601. Пример: expires_at.gte=2018-07-18T10:51:18.139Z"},{"name":"expires_at.gt","in":"query","type":"string","required":false,"description":"Фильтр по времени автоматического закрытия сделки: время должно быть больше указанного значения («от такого-то момента не включительно»). Указывается в формате ISO 8601. Пример: expires_at.gt=2018-07-18T10:51:18.139Z"},{"name":"expires_at.lte","in":"query","type":"string","required":false,"description":"Фильтр по времени автоматического закрытия сделки: время должно быть меньше указанного значения или равно ему («до такого-то момента включительно»). Указывается в формате ISO 8601. Пример: expires_at.lte=2018-07-18T10:51:18.139Z"},{"name":"expires_at.lt","in":"query","type":"string","required":false,"description":"Фильтр по времени автоматического закрытия сделки: время должно быть меньше указанного значения («до такого-то момента не включительно»). Указывается в формате ISO 8601. Пример: expires_at.lt=2018-07-18T10:51:18.139Z"},{"name":"status","in":"query","type":"string (opened, closed)","required":false,"description":"Фильтр по статусу сделки. Пример: status=closed"},{"name":"full_text_search","in":"query","type":"string","required":false,"description":"Фильтр по описанию сделки в параметре description (например, по идентификатору сделки на стороне вашего маркетплейса в ЮKassa либо по идентификатору покупателя или продавца). От 4 до 128 символов. Пример: 123554642-2432FF344R"},{"name":"limit","in":"query","type":"integer","required":false,"description":"Размер выдачи результатов запроса — количество объектов, передаваемых в ответе. Возможные значения: от 1 до 100. Пример: limit=50. Значение по умолчанию: 10"},{"name":"cursor","in":"query","type":"string","required":false,"description":"Указатель на следующий фрагмент списка. Пример: cursor=37a5c87d-3984-51e8-a7f3-8de646d39ec15. В качестве cursor необходимо использовать значение параметра next_cursor, полученное в ответе на предыдущий запрос. Используется, если размер списка больше размера выдачи (limit) и конец выдачи не достигнут."}],"requestExample":"","responseExample":"{\n  \"type\": \"list\",\n  \"items\": [\n    {\n      \"type\": \"safe_deal\",\n      \"id\": \"dl-d68d2fe4-2abb-47e5-8112-32e28f87fb52\",\n      \"balance\": {\n        \"value\": \"1000.00\",\n        \"currency\": \"RUB\"\n      },\n      \"payout_balance\": {\n        \"value\": \"1000.00\",\n        \"currency\": \"RUB\"\n      },\n      \"status\": \"closed\",\n      \"created_at\": \"2020-07-03T11:52:31.827Z\",\n      \"expires_at\": \"2021-01-03T18:31:22.532Z\",\n      \"test\": false,\n      \"fee_moment\": \"payment_succeeded\"\n    }\n  ]\n}","docsUrl":"https://yookassa.ru/developers/api#get_deals_list"},{"id":"GET /deals/{deal_id}","title":"Информация о сделке","httpMethod":"GET","path":"/deals/{deal_id}","description":"Запрос позволяет получить информацию о текущем состоянии сделки по ее уникальному идентификатору.","params":[{"name":"deal_id","in":"path","type":"string","required":true,"description":"Идентификатор сделки."}],"requestExample":"","responseExample":"{\n  \"type\": \"safe_deal\",\n  \"id\": \"dl-d68d2fe4-2abb-47e5-8112-32e28f87fb52\",\n  \"balance\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  },\n  \"payout_balance\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  },\n  \"status\": \"closed\",\n  \"created_at\": \"2020-07-03T11:52:31.827Z\",\n  \"expires_at\": \"2021-01-03T18:31:22.532Z\",\n  \"test\": false,\n  \"fee_moment\": \"payment_succeeded\"\n}","docsUrl":"https://yookassa.ru/developers/api#get_deal"},{"id":"POST /payouts","title":"Создание выплаты","httpMethod":"POST","path":"/payouts","description":"Используйте этот запрос, чтобы создать в ЮKassa объект выплаты. В запросе нужно передать сумму выплаты, данные о способе получения выплаты (например, номер кошелька ЮMoney), описание выплаты и при необходимости дополнительные параметры. Параметры и данные для аутентификации зависят от платежного решения — обычные выплаты или выплаты в рамках Безопасной сделки.","params":[{"name":"Idempotence-Key","in":"header","type":"string","required":true,"description":"Ключ идемпотентности. Рекомендуется использовать строку вида UUID v7"},{"name":"amount","in":"body","type":"object","required":true,"description":"Сумма выплаты. Есть ограничения на минимальный и максимальный размер выплаты и сумму выплат за месяц. Подробнее о лимитах обычных выплат и выплат в рамках Безопасной сделки"},{"name":"amount.value","in":"body","type":"string","required":true,"description":"Сумма в выбранной валюте, всегда в дробном виде. Разделитель дробной части — точка, разделителя тысяч нет. Количество знаков после точки зависит от выбранной валюты. Пример: 1000.00."},{"name":"amount.currency","in":"body","type":"string (RUB, EUR, USD, KZT, BYN, UAH, UZS, TRY)","required":true,"description":"Трехбуквенный код валюты в формате ISO-4217. Пример: RUB."},{"name":"payout_destination_data","in":"body","type":"object","required":false,"description":""},{"name":"payout_destination_data.type","in":"body","type":"string (yoo_money, bank_card, sbp)","required":false,"description":"Способ получения выплаты: * yoo_money — выплаты на кошелек ЮMoney; * bank_card — выплаты на банковскую карту; * sbp — выплаты через СБП на счет в банке или платежном сервисе."},{"name":"payout_destination_data.account_number","in":"body","type":"string","required":false,"description":"Номер кошелька ЮMoney, например 41001614575714. Длина от 11 до 33 цифр. Статус кошелька для обычных выплат — любой, для выплат в рамках Безопасной сделки — именной или идентифицированный."},{"name":"payout_destination_data.card","in":"body","type":"object","required":false,"description":"Данные банковской карты для выплаты."},{"name":"payout_destination_data.phone","in":"body","type":"string","required":false,"description":"Телефон, к которому привязан счет получателя выплаты в системе участника СБП. Указывается в формате ITU-T E.164, например 79000000000."},{"name":"payout_destination_data.bank_id","in":"body","type":"string","required":false,"description":"Идентификатор участника СБП — банка или платежного сервиса, подключенного к сервису. Максимум 12 символов."},{"name":"payout_token","in":"body","type":"string","required":false,"description":"Токенизированные данные для выплаты. Например, синоним банковской карты. Обязательный параметр, если не передан payout_destination_data или payment_method_id."},{"name":"payment_method_id","in":"body","type":"string","required":false,"description":"Идентификатор сохраненного способа оплаты, данные которого нужно использовать для проведения выплаты. Подробнее о выплатах с использованием идентификатора сохраненного способа оплаты Обязательный параметр, если не передан payout_destination_data или payout_token."},{"name":"description","in":"body","type":"string","required":false,"description":"Описание транзакции (не более 128 символов). Например: «Выплата по договору 37»."},{"name":"deal","in":"body","type":"object","required":false,"description":"Сделка, в рамках которой нужно провести выплату. Необходимо передавать, если вы проводите Безопасную сделку"},{"name":"deal.id","in":"body","type":"string","required":false,"description":"Идентификатор сделки."},{"name":"personal_data","in":"body","type":"object[]","required":false,"description":"Персональные данные получателя выплаты. Только для обычных выплат. Необходимо передавать в этих сценариях: * выплаты с проверкой получателя (только для выплат через СБП); * выплаты с передачей данных получателя для выписок из реестра. В массиве можно одновременно передать несколько идентификаторов, но только для разных типов данных."},{"name":"metadata","in":"body","type":"object","required":false,"description":"Любые дополнительные данные, которые нужны вам для работы (например, ваш внутренний идентификатор заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в ответе от ЮKassa. Ограничения: не больше 16 ключей, имя ключа — не больше 32 символов, значение ключа — не больше 512 символов, тип данных — строка в формате UTF-8."}],"requestExample":"{\n  \"amount\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  }\n}","responseExample":"{\n  \"id\": \"po-27ced252-0025-5000-9000-0a682a8bab8f\",\n  \"amount\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  },\n  \"status\": \"pending\",\n  \"payout_destination\": {\n    \"type\": \"bank_card\"\n  },\n  \"created_at\": \"2020-07-03T11:52:31.827Z\",\n  \"test\": false\n}","docsUrl":"https://yookassa.ru/developers/api#create_payout"},{"id":"GET /payouts","title":"Список выплат","httpMethod":"GET","path":"/payouts","description":"Используйте этот запрос, чтобы получить список выплат. Доступны выплаты, созданные за последние 3 года. Список можно отфильтровать по заданным критериям. Способ аутентификации запроса зависит от решения, которое вы используете: обычные выплаты или выплаты в рамках Безопасной сделки.","params":[{"name":"created_at.gte","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть больше указанного значения или равно ему («от такого-то момента включительно»). Указывается в формате ISO 8601. Пример: created_at.gte=2018-07-18T10:51:18.139Z"},{"name":"created_at.gt","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть больше указанного значения («от такого-то момента не включительно»). Указывается в формате ISO 8601. Пример: created_at.gt=2018-07-18T10:51:18.139Z"},{"name":"created_at.lte","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть меньше указанного значения или равно ему («до такого-то момента включительно»). Указывается в формате ISO 8601. Пример: created_at.lte=2018-07-18T10:51:18.139Z"},{"name":"created_at.lt","in":"query","type":"string","required":false,"description":"Фильтр по времени создания: время должно быть меньше указанного значения («до такого-то момента не включительно»). Указывается в формате ISO 8601. Пример: created_at.lt=2018-07-18T10:51:18.139Z"},{"name":"succeeded_at.gte","in":"query","type":"string","required":false,"description":"Фильтр по времени успешной обработки выплаты: время должно быть больше указанного значения или равно ему («от такого-то момента включительно»). Указывается в формате ISO 8601. Пример: succeeded_at.gte=2018-07-18T10:51:18.139Z"},{"name":"succeeded_at.gt","in":"query","type":"string","required":false,"description":"Фильтр по времени успешной обработки выплаты: время должно быть больше указанного значения («от такого-то момента не включительно»). Указывается в формате ISO 8601. Пример: succeeded_at.gt=2018-07-18T10:51:18.139Z"},{"name":"succeeded_at.lte","in":"query","type":"string","required":false,"description":"Фильтр по времени успешного проведения выплаты: время должно быть меньше указанного значения или равно ему («до момента времени включительно»). Указывается в формате ISO 8601. Пример: succeeded_at.lte=2018-07-18T10:51:18.139Z"},{"name":"succeeded_at.lt","in":"query","type":"string","required":false,"description":"Фильтр по времени успешного проведения выплаты: время должно быть меньше указанного значения («до момента времени исключительно»). Указывается в формате ISO 8601. Пример: succeeded_at.lt=2018-07-18T10:51:18.139Z"},{"name":"payout_destination.type","in":"query","type":"string (yoo_money, bank_card, sbp)","required":false,"description":"Фильтр по способу получения выплаты. Пример: payout_destination.type=bank_card"},{"name":"status","in":"query","type":"string (pending, succeeded, canceled)","required":false,"description":"Фильтр по статусу выплаты. Пример: status=succeeded"},{"name":"limit","in":"query","type":"integer","required":false,"description":"Размер выдачи результатов запроса — количество объектов, передаваемых в ответе. Возможные значения: от 1 до 100. Пример: limit=50. Значение по умолчанию: 10."},{"name":"cursor","in":"query","type":"string","required":false,"description":"Указатель на следующий фрагмент списка. Пример: cursor=37a5c87d-3984-51e8-a7f3-8de646d39ec15. В качестве cursor необходимо использовать параметр next_cursor, полученный в ответе на предыдущий запрос. Используется, если размер списка больше размера выдачи (limit) и конец выдачи не достигнут."}],"requestExample":"","responseExample":"{\n  \"type\": \"list\",\n  \"items\": [\n    {\n      \"id\": \"po-27ced252-0025-5000-9000-0a682a8bab8f\",\n      \"amount\": {\n        \"value\": \"1000.00\",\n        \"currency\": \"RUB\"\n      },\n      \"status\": \"pending\",\n      \"payout_destination\": {\n        \"type\": \"bank_card\"\n      },\n      \"created_at\": \"2020-07-03T11:52:31.827Z\",\n      \"test\": false\n    }\n  ]\n}","docsUrl":"https://yookassa.ru/developers/api#get_payouts_list"},{"id":"GET /payouts/search","title":"Поиск выплат","httpMethod":"GET","path":"/payouts/search","description":"Используйте этот запрос, чтобы найти выплаты по заданным критериям. Доступен только для выплат, созданных за последние 3 месяца; сейчас поддерживается поиск только по параметру metadata, а также можно указать дату и время создания выплаты (параметр created_at). Данные для аутентификации запросов зависят от платежного решения — обычные выплаты или выплаты в рамках Безопасной сделки.","params":[{"name":"created_at.gte","in":"query","type":"string","required":false,"description":"Фильтр по дате создания: время должно быть больше указанного значения или равно ему («от момента времени включительно»). Указывается в формате ISO 8601. Пример: created_at.gte=2018-07-18T10:51:18.139Z"},{"name":"created_at.gt","in":"query","type":"string","required":false,"description":"Фильтр по дате создания: время должно быть больше указанного значения («от момента времени исключительно»). Указывается в формате ISO 8601. Пример: created_at.gt=2018-07-18T10:51:18.139Z"},{"name":"created_at.lte","in":"query","type":"string","required":false,"description":"Фильтр по дате создания: время должно быть меньше указанного значения или равно ему («до момента времени включительно»). Указывается в формате ISO 8601. Пример: created_at.lte=2018-07-18T10:51:18.139Z"},{"name":"created_at.lt","in":"query","type":"string","required":false,"description":"Фильтр по дате создания: время должно быть меньше указанного значения («до момента времени исключительно»). Указывается в формате ISO 8601. Пример: created_at.lt=2018-07-18T10:51:18.139Z"},{"name":"metadata","in":"query","type":"object","required":false,"description":"Фильтр по объекту metadata: строгий поиск по паре «ключ-значение» (возвращаются объекты с точным совпадением ключа и значения). Ограничения: не больше одной пары «ключ-значение», имя ключа — не больше 32 символов, значение ключа — не больше 512 символов, тип данных — строка в формате UTF-8 в URL-кодированном виде. Шаблон: metadata[key]=value. Пример: metadata%5Boperation_id%5D=e2ab2e1c-776d-4376-aba8-d2099243d1f6"},{"name":"limit","in":"query","type":"integer","required":false,"description":"Размер выдачи результатов запроса — количество объектов, передаваемых в ответе. Возможные значения: от 1 до 100. Пример: limit=50. Значение по умолчанию: 10."},{"name":"cursor","in":"query","type":"string","required":false,"description":"Указатель на следующий фрагмент списка. Пример: cursor=37a5c87d-3984-51e8-a7f3-8de646d39ec15. В качестве cursor необходимо использовать параметр next_cursor, полученный в ответе на предыдущий запрос. Используется, если размер списка больше размера выдачи (limit) и конец выдачи не достигнут."}],"requestExample":"","responseExample":"{\n  \"type\": \"list\",\n  \"items\": [\n    {\n      \"id\": \"po-27ced252-0025-5000-9000-0a682a8bab8f\",\n      \"amount\": {\n        \"value\": \"1000.00\",\n        \"currency\": \"RUB\"\n      },\n      \"status\": \"pending\",\n      \"payout_destination\": {\n        \"type\": \"bank_card\"\n      },\n      \"created_at\": \"2020-07-03T11:52:31.827Z\",\n      \"test\": false\n    }\n  ]\n}","docsUrl":"https://yookassa.ru/developers/api#get_payouts_search"},{"id":"GET /payouts/{payout_id}","title":"Информация о выплате","httpMethod":"GET","path":"/payouts/{payout_id}","description":"Используйте этот запрос, чтобы получить информацию о текущем состоянии выплаты по ее уникальному идентификатору. Данные для аутентификации запросов зависят от платежного решения — обычные выплаты или выплаты в рамках Безопасной сделки.","params":[{"name":"payout_id","in":"path","type":"string","required":true,"description":"Идентификатор выплаты."}],"requestExample":"","responseExample":"{\n  \"id\": \"po-27ced252-0025-5000-9000-0a682a8bab8f\",\n  \"amount\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  },\n  \"status\": \"pending\",\n  \"payout_destination\": {\n    \"type\": \"bank_card\"\n  },\n  \"created_at\": \"2020-07-03T11:52:31.827Z\",\n  \"test\": false\n}","docsUrl":"https://yookassa.ru/developers/api#get_payout"},{"id":"GET /sbp_banks","title":"Список участников СБП","httpMethod":"GET","path":"/sbp_banks","description":"С помощью этого запроса можно получить актуальный список всех участников СБП. Список необходимо показать получателю выплаты, а идентификатор выбранного участника СБП — передать в запросе на создание выплаты.","params":[],"requestExample":"","responseExample":"{\n  \"type\": \"list\",\n  \"items\": [\n    {\n      \"bank_id\": \"100000000111\",\n      \"name\": \"Сбербанк\",\n      \"bic\": \"044525225\"\n    }\n  ]\n}","docsUrl":"https://yookassa.ru/developers/api#get_sbp_banks_list"},{"id":"POST /personal_data","title":"Создание персональных данных","httpMethod":"POST","path":"/personal_data","description":"Используйте этот запрос, чтобы создать в ЮKassa объект персональных данных. Укажите тип данных (цель, для которой они будут использоваться) и информацию о пользователе: имя, фамилию, отчество и другие данные в зависимости от выбранного типа. Идентификатор созданного объекта персональных данных используйте в запросе на создание выплаты.","params":[{"name":"Idempotence-Key","in":"header","type":"string","required":true,"description":"Ключ идемпотентности. Рекомендуется использовать строку вида UUID v7"},{"name":"type","in":"body","type":"string (payout_statement_recipient, sbp_payout_recipient)","required":true,"description":"Тип персональных данных — цель, для которой вы будете использовать данные. Возможные значения: sbp_payout_recipient — выплаты с проверкой получателя (только для выплат через СБП); payout_statement_recipient — выплаты с данными получателя для выписок из отчета о выплатах."},{"name":"metadata","in":"body","type":"object","required":false,"description":"Любые дополнительные данные, которые нужны вам для работы (например, ваш внутренний идентификатор заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в ответе от ЮKassa. Ограничения: не больше 16 ключей, имя ключа — не больше 32 символов, значение ключа — не больше 512 символов, тип данных — строка в формате UTF-8."},{"name":"last_name","in":"body","type":"string","required":true,"description":"Фамилия пользователя."},{"name":"first_name","in":"body","type":"string","required":true,"description":"Имя пользователя."},{"name":"middle_name","in":"body","type":"string","required":false,"description":"Отчество пользователя. Обязательный параметр, если указано в паспорте."},{"name":"birthdate","in":"body","type":"string","required":false,"description":"Дата рождения. Указывается в формате ISO 8601."}],"requestExample":"{\n  \"type\": \"sbp_payout_recipient\",\n  \"last_name\": \"Иванов\",\n  \"first_name\": \"Иван\"\n}","responseExample":"{\n  \"id\": \"pd-22e12f66-000f-5000-8000-18db351245c7\",\n  \"status\": \"waiting_for_operation\",\n  \"type\": \"sbp_payout_recipient\",\n  \"created_at\": \"string\"\n}","docsUrl":"https://yookassa.ru/developers/api#create_personal_data"},{"id":"GET /personal_data/{personal_data_id}","title":"Информация о персональных данных","httpMethod":"GET","path":"/personal_data/{personal_data_id}","description":"С помощью этого запроса можно получить информацию о текущем статусе объекта персональных данных по его уникальному идентификатору.","params":[{"name":"personal_data_id","in":"path","type":"string","required":true,"description":"Идентификатор персональных данных, сохраненных в ЮKassa."}],"requestExample":"","responseExample":"{\n  \"id\": \"pd-22e12f66-000f-5000-8000-18db351245c7\",\n  \"status\": \"waiting_for_operation\",\n  \"type\": \"sbp_payout_recipient\",\n  \"created_at\": \"string\"\n}","docsUrl":"https://yookassa.ru/developers/api#get_personal_data"},{"id":"POST /pos_links","title":"Активация кассовой ссылки","httpMethod":"POST","path":"/pos_links","description":"Используйте этот запрос, чтобы создать в ЮKassa объект кассовой ссылки и активировать кассовую ссылку для последующего приема платежей по платежным табличкам. В запросе необходимо передать кассовую ссылку и идентификатор торговой точки.","params":[{"name":"Idempotence-Key","in":"header","type":"string","required":true,"description":"Ключ идемпотентности. Рекомендуется использовать строку вида UUID v7"},{"name":"recipient","in":"body","type":"object","required":true,"description":"Идентификатор торговой точки. Например, конкретной кассы в вашем магазине. Вы получите идентификатор от менеджера ЮKassa при подключении платежей."},{"name":"recipient.gateway_id","in":"body","type":"string","required":true,"description":"Идентификатор субаккаунта. Используется для разделения потоков платежей в рамках одного аккаунта."},{"name":"pos_link_data","in":"body","type":"object","required":true,"description":"Данные кассовой ссылки — уникальной ссылки, зашифрованной в QR-коде и NFC-метке на платежной табличке."},{"name":"pos_link_data.link","in":"body","type":"string","required":true,"description":"Кассовая ссылка с платежной таблички. Чтобы получить ее, отсканируйте QR-код на табличке."}],"requestExample":"{\n  \"recipient\": {\n    \"gateway_id\": \"456\"\n  },\n  \"pos_link_data\": {\n    \"link\": \"https://qr.nspk.ru/AD100003N2S98C2U48D6N60M12345678\"\n  }\n}","responseExample":"{\n  \"id\": \"pl-1da5c87d-0984-50e8-a7f3-8de646dd9ec9\",\n  \"status\": \"active\",\n  \"type\": \"nspk\",\n  \"recipient\": {\n    \"gateway_id\": \"456\"\n  }\n}","docsUrl":"https://yookassa.ru/developers/api#create_pos_link"},{"id":"GET /pos_links/{pos_link_id}","title":"Информация о кассовой ссылке","httpMethod":"GET","path":"/pos_links/{pos_link_id}","description":"Используйте этот запрос, чтобы получить информацию о текущем состоянии кассовой ссылки по ее уникальному идентификатору.","params":[{"name":"pos_link_id","in":"path","type":"string","required":true,"description":"Идентификатор кассовой ссылки в ЮKassa."}],"requestExample":"","responseExample":"{\n  \"id\": \"pl-1da5c87d-0984-50e8-a7f3-8de646dd9ec9\",\n  \"status\": \"active\",\n  \"type\": \"nspk\",\n  \"recipient\": {\n    \"gateway_id\": \"456\"\n  }\n}","docsUrl":"https://yookassa.ru/developers/api#get_pos_link"},{"id":"POST /pos_links/{pos_link_id}/recipient","title":"Изменение торговой точки, привязанной к кассовой ссылке","httpMethod":"POST","path":"/pos_links/{pos_link_id}/recipient","description":"Используйте этот запрос, чтобы привязать к кассовой ссылке другую торговую точку. В запросе необходимо передать идентификатор торговой точки, которую вы хотите привязать к кассовой ссылке. После привязки кассовой ссылки перенесите платежную табличку на новую торговую точку (например, если привязали к ссылке новую кассу, переместите табличку туда).","params":[{"name":"pos_link_id","in":"path","type":"string","required":true,"description":"Идентификатор кассовой ссылки в ЮKassa."},{"name":"Idempotence-Key","in":"header","type":"string","required":true,"description":"Ключ идемпотентности. Рекомендуется использовать строку вида UUID v7"},{"name":"recipient","in":"body","type":"object","required":true,"description":"Идентификатор торговой точки, которую вы хотите привязать к кассовой ссылке."},{"name":"recipient.gateway_id","in":"body","type":"string","required":true,"description":"Идентификатор субаккаунта. Используется для разделения потоков платежей в рамках одного аккаунта."}],"requestExample":"{\n  \"recipient\": {\n    \"gateway_id\": \"456\"\n  }\n}","responseExample":"{\n  \"id\": \"pl-1da5c87d-0984-50e8-a7f3-8de646dd9ec9\",\n  \"status\": \"active\",\n  \"type\": \"nspk\",\n  \"recipient\": {\n    \"gateway_id\": \"456\"\n  }\n}","docsUrl":"https://yookassa.ru/developers/api#recipient_pos_link"},{"id":"POST /pos_links/{pos_link_id}/deactivate","title":"Деактивация кассовой ссылки","httpMethod":"POST","path":"/pos_links/{pos_link_id}/deactivate","description":"Используйте этот запрос, чтобы деактивировать кассовую ссылку и приостановить прием платежей по этой платежной табличке. В запросе передайте идентификатор кассовой ссылки, которую хотите деактивировать. При необходимости вы можете активировать ранее деактивированную кассовую ссылку.","params":[{"name":"pos_link_id","in":"path","type":"string","required":true,"description":"Идентификатор кассовой ссылки в ЮKassa."}],"requestExample":"","responseExample":"{\n  \"id\": \"pl-1da5c87d-0984-50e8-a7f3-8de646dd9ec9\",\n  \"status\": \"active\",\n  \"type\": \"nspk\",\n  \"recipient\": {\n    \"gateway_id\": \"456\"\n  }\n}","docsUrl":"https://yookassa.ru/developers/api#deactivate_pos_link"},{"id":"POST /pos_links/{pos_link_id}/activate","title":"Активация ранее деактивированной кассовой ссылки","httpMethod":"POST","path":"/pos_links/{pos_link_id}/activate","description":"Используйте этот запрос, чтобы активировать ранее деактивированную кассовую ссылку и возобновить прием платежей по этой платежной табличке. В запросе передайте идентификатор кассовой ссылки, которую вы ранее деактивировали.","params":[{"name":"pos_link_id","in":"path","type":"string","required":true,"description":"Идентификатор кассовой ссылки в ЮKassa."}],"requestExample":"","responseExample":"{\n  \"id\": \"pl-1da5c87d-0984-50e8-a7f3-8de646dd9ec9\",\n  \"status\": \"active\",\n  \"type\": \"nspk\",\n  \"recipient\": {\n    \"gateway_id\": \"456\"\n  }\n}","docsUrl":"https://yookassa.ru/developers/api#activate_pos_link"}],"codeExamples":[{"title":"Запрос с использованием OAuth-токена (партнерская программа)","language":"bash","code":"curl https://api.yookassa.ru/v3/payments/{payment_id} \\\n  -H \"Authorization: Bearer <OAuth-токен>\""},{"title":"Ответ с ошибкой","language":"json","code":"{\n  \"type\" : \"error\",\n  \"id\" : \"55a02ced-be5d-462d-a6fb-0ace18881671\",\n  \"code\" : \"invalid_request\",\n  \"description\" : \"Idempotence key is too long. Send the value in accordance with the documentation\",\n  \"parameter\" : \"Idempotence-Key\"\n}"}],"errors":[{"code":"400","description":"invalid_request — ошибка в параметрах или логике запроса, проблемы с ключом идемпотентности. Причина — в description и parameter. Исправь запрос и повтори с новым ключом идемпотентности."},{"code":"401","description":"invalid_credentials — нет заголовка Authorization, неверный идентификатор или секретный ключ, устаревший или отозванный OAuth-токен."},{"code":"403","description":"forbidden — не хватает прав: функцию нужно согласовать с менеджером ЮKassa или для OAuth не запрошены нужные права."},{"code":"404","description":"not_found — объект не найден: создан в другом магазине или в идентификаторе опечатка."},{"code":"405","description":"Неверный HTTP-метод, например GET вместо POST для отмены платежа. Поддерживаемый метод — в заголовке Allow."},{"code":"415","description":"Неверный тип контента: тело POST-запроса должно быть в JSON."},{"code":"429","description":"too_many_requests — слишком много запросов. Увеличь интервалы между запросами."},{"code":"500","description":"internal_server_error — результат неизвестен, в том числе если ЮKassa не смогла дать точный ответ за 30 секунд. Повтори запрос с тем же ключом идемпотентности или запроси объект через GET. Если ошибка держится больше получаса — в поддержку."}],"limits":"Идемпотентность действует 24 часа после первого запроса, затем повтор обрабатывается как новый запрос. Idempotence-Key — не длиннее 64 символов.\n\nЕсли за короткое время запросов слишком много, API возвращает HTTP 429. При статусе pending и ошибках 500 или 429 повторяй запрос с возрастающим интервалом.\n\nСписки отдают не больше 100 объектов за запрос (limit), дальше — по cursor. Платежи и возвраты доступны за последние 3 года.","gotchas":["capture по умолчанию false: без capture: true платеж останется в статусе waiting_for_capture и в момент expires_at отменится автоматически, деньги вернутся покупателю.","Для POST и DELETE обязателен заголовок Idempotence-Key — до 64 символов, рекомендуется UUID. Повтор с тем же ключом в течение 24 часов вернет результат первого запроса; для новой операции нужен новый ключ.","HTTP 500 не значит, что операция не прошла: результат неизвестен. Повтори запрос с теми же данными и тем же ключом идемпотентности или запроси объект через GET.","Возврат покупателя на return_url не означает успешную оплату — статус проверяй на сервере или по HTTP-уведомлению.","Сумма — строка с точкой и двумя знаками: \"1000.00\", вместе с кодом валюты.","Методы /webhooks работают только с OAuth-токеном в партнерской программе. Обычный магазин настраивает уведомления в личном кабинете.","Вернуть платеж можно в течение трех лет с момента создания. Комиссия ЮKassa за платеж не возвращается.","Для Чеков от ЮKassa частичная предоплата, аванс и кредит не поддерживаются."],"slug":"yookassa","version":1,"updatedAt":"2026-10-11T18:35:18.659Z","sources":[{"title":"Справочник API ЮKassa","url":"https://yookassa.ru/developers/api","kind":"research","addedAt":"2026-10-11T18:35:14.444Z"},{"title":"Спецификация OpenAPI","url":"https://yookassa.ru/developers/using-api/openapi-specification","kind":"research","addedAt":"2026-10-11T18:35:14.444Z"},{"title":"Формат взаимодействия","url":"https://yookassa.ru/developers/using-api/interaction-format","kind":"research","addedAt":"2026-10-11T18:35:14.444Z"},{"title":"Коды ответов HTTP","url":"https://yookassa.ru/developers/using-api/response-handling/http-codes","kind":"research","addedAt":"2026-10-11T18:35:14.444Z"},{"title":"Входящие уведомления","url":"https://yookassa.ru/developers/using-api/webhooks","kind":"research","addedAt":"2026-10-11T18:35:14.444Z"},{"title":"Платеж по сохраненному способу оплаты","url":"https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved","kind":"research","addedAt":"2026-10-11T18:35:14.444Z"},{"title":"Значения параметров для Чеков от ЮKassa","url":"https://yookassa.ru/developers/payment-acceptance/receipts/54fz/yoomoney/parameters-values","kind":"research","addedAt":"2026-10-11T18:35:14.444Z"},{"title":"Вставленный текст","url":"","kind":"import","addedAt":"2026-10-11T18:35:14.444Z"}],"logoUrl":null}