Перед началом
- Заключите договор с выбранным провайдером.
- Подключите онлайн-кассу или фискализацию, если она нужна для Ваших расчётов.
- Уточните у бухгалтера ставку НДС, предмет и способ расчёта.
- Сначала используйте тестовую среду и только после полного сценария переключайтесь в боевую.
ЮKassa
- В личном кабинете ЮKassa получите shopId и секретный ключ для API.
- В Passite выберите «ЮKassa», нужную среду и укажите реквизиты.
- В ЮKassa добавьте webhook
https://passite.ru/payment-webhook.phpдля событийpayment.succeeded,payment.waiting_for_captureиpayment.canceled. - Нажмите «Сохранить», затем «Проверить подключение».
- Создайте тестовый платёж и полный возврат; проверьте статусы и чек.
Не отправляйте его в мессенджерах и не добавляйте в код сайта. Passite хранит секрет в зашифрованном виде вне публичной части.
Альфа-Банк
- Получите отдельные API-логин и API-пароль интернет-эквайринга; обычный логин интернет-банка не подходит.
- Выберите «Альфа-Банк», среду и укажите API-реквизиты.
- Сохраните настройки и выполните проверку подключения.
- Проведите тестовую оплату и полный возврат.
- Фискализацию согласуйте и проверьте в кабинете банка по своему договору: Passite не передаёт Alfa
orderBundle.
Электронные чеки ЮKassa
Поля чеков в Passite относятся к ЮKassa. При их включении у покупателя должен быть корректный email для получения ссылки на чек, а ставка НДС, предмет и способ расчёта должны соответствовать кассе и учёту продавца. Для каталога Passite передаёт позиции; если их невозможно безопасно согласовать с итогом, формируется одна позиция на сумму платежа.
Переключение провайдера
Реквизиты хранятся отдельно для каждого провайдера и среды. Старые платежи продолжают проверяться через провайдера, у которого они были созданы. Перед включением нового подключения обязательно выполните проверку.
Если через конкретный логин магазина уже проходили платежи, Passite не позволит заменить его другим или удалить секрет: старые статусы и возвраты должны оставаться проверяемыми. Можно обновить секретный ключ или API‑пароль того же магазина.
Возвраты и подписки
В истории доступен полный возврат подтверждённого платежа. YooKassa также поддерживает отдельное согласие клиента на сохранение способа оплаты и автопродление подписки Passite; отключить его можно в кабинете. Альфа-Банк используется для разовой оплаты подписки.