Ваш сервер выставляет счёт, получает ссылку и отправляет по ней человека. Он платит внутри WhitePort своим балансом, деньги приходят вам сразу за вычетом доли площадки. Вы узнаёте об оплате уведомлением или по запросу статуса.

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

По заведённому товару — цена и период возьмутся из него. Либо суммой напрямую, если каталог у вас свой.

В ответе — payUrl. Откройте её человеку. Повторный запрос с тем же externalId вернёт тот же счёт, а не заведёт второй.

Статус paid означает, что деньги у вас на балансе.

Один вопрос — пускать человека или нет. Складывать периоды не нужно, дата конца уже посчитана.

Возврат делаете вы, из своего баланса; долю площадки вернём мы. Поэтому выручка последних часов не выводится наружу — из неё и делаются возвраты.

Укажите адрес на https, и мы будем присылать туда события: invoice.paid, invoice.refunded, subscription.started, subscription.expiring, subscription.ended.

Каждое подписано: в заголовке X-WhitePort-Signature лежит HMAC-SHA256 от тела на отпечатке вашего ключа. Проверяйте подпись — иначе любой, кто узнает адрес, объявит счёт оплаченным.