Skip to main content
POST
Вернуть платёж

Авторизации

X-Public-Id
string
header
обязательно

pk_live_… для платёжных эндпоинтов, wk_live_… для выплат/возвратов.

X-Signature
string
header
обязательно

hex(HMAC-SHA256(секрет, "\n<МЕТОД>\n<путь>\n<тело>"))

X-Timestamp
string
header
обязательно

Текущее время Unix в секундах (в пределах допустимого расхождения).

Тело

application/json
address
string

Адрес назначения возврата. По умолчанию — payer_address платежа; обязателен только для Bitcoin/UTXO.

amount
string

Частичная сумма. По умолчанию — вся полученная.

Пример:

"10"

network
string

Сеть.

Пример:

"tron"

order_id
string

Ваша ссылка на заказ платежа. Нужен uuid или order_id.

Пример:

"order-1"

reference
string

Необязательный ключ идемпотентности возврата: различает два разных возврата с одинаковыми (платёж, адрес, сумма); повтор с тем же значением дедуплицируется. Это не order_id.

uuid
string

Идентификатор платежа. Нужен uuid или order_id.

Ответ

200 - application/json

Success

result
object
state
integer
Пример:

0