Payin H2H

host-to-host API для приёма платежей + SDK на Go, Node.js, Python, PHP.

Payin H2H

Payin H2H (host-to-host) — это HTTP-контракт Merchant Payment API v1 для приёма платежей от клиентов мерчанта. Под капотом — POST /api/v1/merchant/pay/*, поверх — готовые SDK на четырёх языках, которые помогают подписывать запросы, проверять webhooks и прикреплять чеки.

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

CARD — банковские карты.
SBP — Система Быстрых Платежей.

Режимы

Синхронный (newPayment) — в одном HTTP-ответе возвращает реквизиты оплаты (JSON), ожидая их получения до 10 секунд. Если реквизиты не успели прийти — success: false с описанием в errorDescription.
Асинхронный (newPaymentAsync) — регистрирует заявку; реквизиты и статус приходят через webhooks.

Основные операции

Метод	HTTP endpoint	Назначение
`getAvailableAmounts`	`POST /available`	Получить список доступных сумм встречных предложений
`newPayment` / `newPaymentAsync`	`POST /new`, `POST /new-async`	Создать платёж
`confirm`	`POST /confirm`	Подтвердить (двухэтапные сценарии)
`cancel`	`POST /cancel`	Отменить платёж
`getStatus`	`POST /status`	Запросить статус
`attachReceipt`	`POST /receipt/attach`	Прикрепить чек

Webhooks

Два типа:

credentials webhook — присылает реквизиты оплаты (для асинхронного режима).
status webhook — финальный статус платежа.

Оба подписаны ed25519. Проверяйте подпись теми же утилитами, которыми подписываете исходящие запросы (Ключи для Payin).

Что читать

HTTP API

Полный HTTP-контракт: заголовки, тела запросов, статусы, webhooks.

Go 1.21+, generics, context.Context.

Node.js

TypeScript, ESM, встроенный crypto.

Python

Python 3.10+, библиотека cryptography, snake_case API.

PHP

PHP 8.1+, Composer, sodium_crypto_sign.

/topup_status

/topup_status — lifecycle статусов операции.

HTTP API

Host-to-host контракт Merchant Payment API v1.