Callback об изменении статуса транзакции Copy

Ваш endpoint для приема callback. Укажите URL в ЛК (Настройки → Callback URLs). Адрес один на все события: и на изменение статуса платежа, и на возвраты.

Поставщик отправляет заголовки X-MerchantId и X-Secret и JSON-тело. При успешной оплате — статус CONFIRMED, при неуспешной — CANCELED, при возврате всей суммы — CHARGEBACKED, при возврате части суммы — PARTIALLY_REFUNDED.

По возвратам в теле приходят дополнительные поля: refundId — идентификатор операции возврата, refundAmount — её сумма, refundStatus — исход операции (Succeeded или Declined), а для частичных возвратов ещё refundedAmount и refundableAmount: сколько по платежу уже возвращено и сколько вернуть ещё можно. Поле amount при этом всегда остаётся суммой исходного платежа и после возврата не меняется. Поля, которых у события нет, в теле отсутствуют целиком, а не приходят пустыми, — поэтому колбэки по обычным платежам выглядят как прежде.

Колбэк уходит на каждую завершённую операцию возврата, включая отклонённую провайдером: по одному платежу их будет столько, сколько было операций, и различать их нужно по refundId. Отклонённый возврат всей суммы колбэком не сопровождается.

Правила заполнения поля callback:
✅ Использовать только HTTPS (HTTP запрещён)
✅ Использовать только публичные IP-адреса или доменные имена
✅ Требуется корректный SSL-сертификат, выданный доверенным удостоверяющим центром
❌ Самоподписанные (self-signed) SSL-сертификаты не допускаются
❌ Запрещены приватные IP-диапазоны (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 127.0.0.0/8)
❌ Запрещены localhost и loopback адреса

curl --location 'https://your-api-server.com' \ --header 'X-MerchantId;' \ --header 'X-Secret;' \ --header 'Content-Type: application/json' \ --data '{ "id": "9f1c2b7e-4d3a-4b5c-8e7f-1a2b3c4d5e6f", "amount": 1000.00, "currency": "RUB", "status": "PARTIALLY_REFUNDED", "paymentMethod": 2, "payload": "order-10342", "refundId": "c2a1f4d8-55b2-4a0e-9c31-7d6f0b8e4a12", "refundAmount": 30.00, "refundedAmount": 30.00, "refundableAmount": 970.00, "refundStatus": "Succeeded" }'

Callback об изменении статуса транзакции Copy

Request

Responses