Введение

Базовый адрес, формат запросов и деньги в копейках

API устроено просто: вы создаёте платёж запросом с сервера, отправляете покупателя на платёжную страницу TabPay, а результат получаете вебхуком. Никакой работы с картами и СБП на вашей стороне - всё происходит у нас.

Базовый адрес: https://tabpay.org/api. Запросы и ответы - в формате JSON, кодировка UTF-8.

Деньги - в копейках

Все суммы в API - целые числа в копейках: 19900 - это 199,00 ₽. Дробных рублей нет нигде, так исключаются ошибки округления. Если храните цены в рублях - умножайте на 100 при отправке.

Способы оплаты

Покупателю доступны СБП (QR-код на десктопе, приложение банка на телефоне) и банковские карты РФ с 3-D Secure. Способы включаются магазину при подключении; при создании платежа можно зафиксировать конкретный способ или оставить выбор покупателю.

Тестирование

Для проверки интеграции без реальных денег есть тестовый режим: магазин-песочница создаётся без модерации, платежи не уходят в банк, а исход задаётся кнопками на платёжной странице. Финальную проверку боевого магазина делайте платежом на небольшую сумму: создайте платёж, оплатите его своей картой или по СБП и убедитесь, что вебхук дошёл и подпись сходится.

Что дальше

Быстрый старт - первый платёж за три шага;
Аутентификация - где взять API-ключ и как его передавать;
Вебхуки - как надёжно узнавать результат оплаты.