API AvantPay

API AvantPay принимает онлайн-платежи от ваших покупателей: по СБП и банковской картой, в рублях.

Адрес API: https://api.avantpay.io/v3

Как проходит оплата

1. Вы создаёте платёж: POST https://api.avantpay.io/v3/payments с суммой, адресом возврата и email покупателя. В ответе — объект платежа со ссылкой на оплату confirmation.confirmation_url.
2. Покупатель переходит по ссылке и платит на странице AvantPay. Потом AvantPay возвращает его на ваш return_url.
3. AvantPay присылает уведомление на ваш сервер: payment.succeeded (оплачен) или payment.canceled (не оплачен).
4. Вы проверяете статус запросом GET https://api.avantpay.io/v3/payments/{payment_id} и выполняете заказ, только если status равен succeeded, а amount — сумме заказа.

Все четыре шага с готовыми запросами — в быстром старте.

Методы API

Метод	Что делает	В справочнике
POST /v3/payments	Создать платёж	Создать платёж
GET /v3/payments/{payment_id}	Получить платёж по его id	Получить платёж
GET /v3/payments	Список платежей с фильтрами	Список платежей

Все поля и ошибки — в справочнике API: одна страница, методы и объекты подряд.

Подтвердить (/capture) или отменить (/cancel) платёж через API нельзя: платёж списывается сразу, а неоплаченный отменяется сам. Чеки 54-ФЗ, сохранение карт и автоплатежи AvantPay не поддерживает. Вернуть деньги покупателю можно в личном кабинете.

Куда дальше

• Быстрый старт — первый платёж за четыре шага.
• Справочник API — все методы, поля и ошибки.
• Уведомления — как принять и проверить уведомление, готовые обработчики.
• Интеграция с помощью ИИ — дайте ассистенту ссылку https://avantpay.io/developers/llms-full.txt: это вся документация одним файлом.

Термины

Термин	Что это
ID магазина	Число, логин для запросов к API. Есть в личном кабинете.
Секретный ключ	Пароль для запросов к API. Создаётся в личном кабинете.
Платёж	Одна попытка оплаты: сумма, статус и ссылка на оплату.
Email покупателя	Адрес покупателя в metadata.email.
Ключ идемпотентности	Ваша уникальная строка в заголовке Idempotence-Key. Защищает от двойного платежа, если запрос пришлось повторить.
Номер заказа	Ваш номер заказа в metadata.order_id. Вернётся в объекте платежа и в уведомлениях.
Уведомление	POST-запрос от AvantPay на ваш сервер, когда платёж оплачен или отменён.
Личный кабинет	https://avantpay.io/lk/ — ключи, настройки уведомлений, способы оплаты, платежи и возвраты.

Вопросы — в поддержку: [email protected].