Платежи по API ЮKassa
С помощью ЮKassa вы можете принимать оплату, делать возвраты и решать другие задачи, связанные с электронными платежами в вебе и на мобильных устройствах. ЮKassa берёт на себя всё взаимодействие, связанное с перечислением оплаты от пользователя на ваш расчетный счет. Вам нужно лишь выбрать наиболее удобный сценарий интеграции и проинтегрироваться с ЮKassa по API.
В этом разделе описано подключение обычных платежей. Если вы используете решения для платформ — Безопасную сделку, Сплитование платежей или Партнерскую программу, то при проведении платежей есть нюансы. Подробнее в соответствующих разделах документации.
Как проходят платежи
При подключении платежей у вас появится магазин для платежей в ЮKassa. Магазинов может быть несколько, их количество зависит от ваших задач и тех возможностей ЮKassa, которые вы планируете использовать.
Чтобы провести платеж, вы размещаете платежную форму у себя на сайте или в мобильном приложении либо выставляете счет. В процессе оплаты вы отправляете ЮKassa запрос с идентификатором магазина и данными о платеже и дожидаетесь успешного выполнения запроса. Принятая от пользователя сумма поступит на ваш расчетный счет на следующий рабочий день после проведения платежа.
За проведение платежа ЮKassa взимает комиссию — определенный процент с каждой успешной операции (конкретные условия прописаны в вашем договоре). ЮKassa ежедневно формирует реестры успешных платежей и возвратов — для финансовой сверки. В реестре платежей для каждой платежа будет указана списанная комиссия. Подробнее о реестрах
Возможности API для проведения платежей
С помощью API ЮKassa вы можете:
- Принимать оплату с банковских карт, из кошелька ЮMoney, через SberPay, Mir Pay, СБП и другими способами. Есть решения для приема платежей от частных лиц и компаний.
- Проводить платежи в две стадии — холдировать («замораживать») оплату, а затем списывать ее в нужный для вас момент.
- Сохранять данные платежного средства и, используя их, проводить автоплатежи (рекуррентные платежи).
- Делать полные и частичные возвраты платежей.
- Отправлять чеки в налоговую при платежах и возвратах.
- Выставлять счета на оплату.
- Получать списки платежей, возвратов и чеков.
...и многое другое
Есть несколько разных сценариев интеграции — от готовых платежных форм, для тех, кому важно начать принимать платежи в максимально короткие сроки, до более гибких решений, для тех, кому важно использовать свой дизайн форм.
Для взаимодействия с ЮKassa по API можно использовать готовые серверные SDK.
Интеграцию можно проверить с помощью тестового режима. При его использовании всё проходит, как при настоящих платежах, но деньги никуда не переводятся.
Тестовый режим доступен сразу после регистрации в ЮKassa — вы можете протестировать платежи в любой момент, даже до заключения договора. Подробнее о тестовом режиме
Подключение платежей
Шаг 1. Зарегистрируйтесь в ЮKassa и подпишите необходимые документы. Если вы уже клиент ЮKassa, сообщите вашему менеджеру, что хотите использовать обычные платежи, и подпишите договор.
Шаг 2. Познакомьтесь с API: проведите свой первый платеж, используя Быстрый старт.
Шаг 3. Выберите наиболее подходящий вам сценарий интеграции в зависимости от нужных вам способов оплаты, возможностей API и ресурсов, которые у вас есть для подключения платежей.
Шаг 4. Подготовьтесь к интеграции:
- Ознакомьтесь с форматом взаимодействия с API ЮKassa.
- Получите идентификатор магазина и секретный ключ для аутентификации запросов.
- Настройте уведомления.
- Выберите подходящий серверный SDK.
Шаг 5. Используя инструкции, подключите те возможности API, которые нужны для решения ваших задач. Протестируйте интеграцию.
Шаг 6. Подготовьтесь к получению оплаты от реальных пользователей: проведите платеж на минимальную сумму.
Готово! Можно принимать платежи.
Что почитать еще