Вернуть платёж
Возврат — это списание с вашего баланса.
address (куда вернуть) можно опустить ТОЛЬКО если в платеже payer_address_is_refundable = true: тогда вернём на записанный адрес плательщика (payer_address). Если там false — адрес плательщика нам известен, но он не является адресом возврата (Bitcoin/UTXO: первый вход мог быть биржей или сдачей; XRP: общий адрес биржи с тегом назначения; оплата КАРТОЙ через крипто-он-рамп: отправитель — омнибусный горячий кошелёк провайдера, а не покупатель). Возврат туда уходит безвозвратно тому, кто денег не платил, поэтому запрос без address будет отклонён (refund.no_address): спросите адрес у покупателя и передайте его явно. Нужен uuid/order_id платежа. По умолчанию вернём всю полученную сумму; можно указать частичную amount.
Идемпотентно по (платёж, адрес, сумма); суммарно нельзя вернуть больше, чем оплачено. Возврат на записанный адрес плательщика подтверждается автоматически — кроме платежей картой через он-рамп, где такой возврат уходит в обычную очередь подтверждения.
Авторизации
pk_live_… для платёжных эндпоинтов, wk_live_… для выплат/возвратов.
hex(HMAC-SHA256(секрет, "\n<МЕТОД>\n<путь>\n<тело>"))
Текущее время Unix в секундах (в пределах допустимого расхождения).
Тело
Адрес назначения возврата. По умолчанию — payer_address платежа; обязателен только для Bitcoin/UTXO.
Частичная сумма. По умолчанию — вся полученная.
"10"
Сеть.
"tron"
Ваша ссылка на заказ платежа. Нужен uuid или order_id.
"order-1"
Необязательный ключ идемпотентности возврата: различает два разных возврата с одинаковыми (платёж, адрес, сумма); повтор с тем же значением дедуплицируется. Это не order_id.
Идентификатор платежа. Нужен uuid или order_id.