Обзор выплат
API позволяет проводить выплаты удобно и безопасно.
Можно отправлять выплаты любым физическим лицам на банковские карты Visa и MasterCard.
Как получать данные карт для выплат
Вы можете узнать данные карты получателя одним из трех способов в зависимости от вашей модели безопасности и интеграции.
Наш виджет
Встройте на сайт наш виджет, чтобы получатель мог сам ввести номер карты, а виджет вернул вам токен для выплаты — для этого способа достаточно соблюдать требования PCI DSS, предъявляемые к работе с виджетом.
Самостоятельный сбор данных
Вы можете собирать номера карт на своей стороне и передавать их напрямую в запросе на выплату. Для этого способа нужно выполнять требования стандарта PCI DSS.
Выплата по существующему токену
Если у вас уже есть один из токенов, используйте его вместо номера карты:
- хешированный номер карты от нашего виджета,
- токен для рекуррентных платежей.
Как провести выплату
Процесс состоит из нескольких этапов.
- Проверьте остаток на вашем выплатном балансе. Если его не хватит для перевода — пополните счет.
- Запросите у получателя реквизиты, например, номер карты.
- Отправьте нам запрос на проведение перевода.
- Получите подтверждение от системы об успешной операции.
Техническая реализация через API
Все API-операции осуществляются в рамках платежной сессии.
Чтобы сделать выплату, выполните следующие шаги:
-
Создайте платежную сессию. Для этого отправьте запрос
transaction/initiate. В ответе придет идентификатор платежной сессии.Еще вы можете использовать запрос
transaction/init/transfer. Тогда сразу передайте все параметры выплаты и пропустите следующий шаг.
Все статьи о выплатах в этом разделе будут описывать только первый путь — через создание платежной сессии. -
Начните выплату запросом
transaction/start/transfer. -
Дождитесь вебхука для выплаты
approve_pending. Его получение значит, что Zetplat готов провести выплату и ждет подтверждения или отмены. -
Подтвердите или отмените выплату. Для подтверждения отправьте запрос
transaction/approve, для отмены — запросtransaction/cancel. -
Дождитесь результата выплаты. Zetplat отправит вам вебхук
checkout_resultsсо всеми данными. Результат выплаты — в полеtransaction_statusмассиваpayouts. Статусsuccessfulозначает успешную выплату.
Схема выплаты
