Создание pay-out сделки

POST

/payment/pay-out

• Production server

Parameters

Header Parameters

X-Secure-Key

required

string

API ключ, который привязан к вашему кабинету

Request Body ^required

object

amount

required

Сумма операции в фиатной валюте. Значение будет использовано для расчёта эквивалента в криптовалюте по текущему курсу. Допускается дробное число. Обычная выплата: от 100 до 1 000 000. Выплата мэтчинга (isMatching: true): не больше двух знаков после запятой, границы — лимиты выплаты мерчанта, вне их — 403 MATCHING_AMOUNT_OUT_OF_LIMITS.

number

Example

10000

currency

Фиатная валюта операции

string

Allowed values: UAH KZT USD RUB TJS UZS ARS

Example

RUB

payerInfo

Данные о платильщике

object

userAgent

required

Строка, содержащая информацию о браузере и устройстве плательщика

string

Example

Mozilla/5.0 (Linux; Android 13; SM-G991B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Mobile Safari/537.36

ip

required

IP-адрес плательщика

string

Example

203.0.113.45

userId

required

Уникальный идентификатор пользователя в системе

string

Example

usr_847392

fingerprint

Хэш для уникальной идентификации устройства или сессии пользователя. Формируется в соответствии со стандартом FingerprintJS

string

Example

9d1f2c8a7b6e5d4c3a2f1e0d9c8b7a6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1

registeredAt

Временная метка, указывающая дату регистрации плательщика

string

Example

1714567890123

Example

{
  "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1",
  "ip": "127.0.0.1",
  "userId": "0000001",
  "fingerprint": "fbb77b9f4265b18538e66cac5a37c6410dc2cdd7f0cddfde6eda25aa10df669b",
  "registeredAt": "1767908042023"
}

requisite

required

Платёжные реквизиты, необходимые для выполнения выплаты

object

cardNumber

Реквизиты банковской карты для осуществления выплаты

string

Example

2200241433210494

ostCardNumber

Реквизиты банковской карты для выплаты через OST C2C

string

Example

2200241433210494

ownerName

required

Имя владельца платёжного средства

string

Example

Peeter Parker

sbpNumber

Номер, используемый для перевода через СБП

string

Example

79123215109

qrCode

QR-код или строка для QR-оплаты, которую должен использовать трейдер при выплате

string

Example

https://bank.example/qr/abc123

bank

required

Наименование банка для выполнения перевода

string

Example

RAIFFEISEN

callbackUrl

required

URL для получения уведомлений об изменении статуса операции

string

Example

https://example.com/callback

merchantTransactionId

required

Идентификатор транзакции во внутренней системе мерчанта. Может быть использован для последующего поиска операции.

string

Example

100500

timeoutInMin

Время в минутах (целое число), после которого выплата будет отменена автоматически, если ее не взяли в работу

integer

Example

60

isMatching

Если true, вместо обычной pay-out сделки создается matching-заявка

boolean

Responses

201

Создание pay-out сделки

One of:

object

object

category

required

Категория callback payload

string

Allowed values: trade matching

Example

trade

id

required

Уникальный идентификатор сделки

string

Example

9ee42dff-83ec-4a90-8dfb-1fc74d3afbe4

merchantTransactionId

required

Идентификатор транзакции мерчанта (внешний)

string

Example

MERCH-TRX-20240910-00042

matchingTransactionId

Идентификатор matching-транзакции, если callback относится к matching-linked pay-out.

string

nullable

Example

MATCHING-TRX-20240910-00042

amount

required

Сумма в фиатной валюте

number

Example

2500

crypto

required

Сумма в криптовалюте (для мерчанта)

string format: int64

Example

124825278

rate

required

Курс обмена фиат → крипто (для мерчанта)

number

Example

80.12

fee

required

Комиссия мерчанта

string format: int64

Example

125000

type

required

Тип сделки

string

Allowed values: pay-in pay-out

Example

pay-in

method

required

Метод реквизитов/оплаты

string

Allowed values: account ca_sbp ca_c2c sbp sbp_invoice qr ftd_qr qr_vietnam c2c ost_c2c c2c_invoice link foreign_sbp foreign_c2c alfa_tjs_sbp abh_sbp abh_c2c mobile_commercial mobile_commerce_tjs

Example

c2c

status

required

Текущий статус сделки

string

Allowed values: pending active checking checking_manually manual_review dispute success_changed success canceled

Example

active

requisite

required

Реквизиты для проведения сделки

object

id

required

Идентификатор реквизита

string

Example

a3c9f2e1-7d44-4c9a-9c21-8bfa11223344

ownerName

required

Имя владельца платёжного метода

string

Example

Иван Иванов

firstName

Owner first name, when the bank requires split owner name fields.

object

Example

Иван

lastName

Owner last name, when the bank requires split owner name fields.

object

Example

Иванов

bank

required

Идентификатор банка для сделки

string

Example

SBER

cardNumber

required

Номер карты платёжного метода

string

Example

548673******9012

sbpNumber

required

Номер телефона для СБП

string

Example

79035554433

link

required

Ссылка на платёжный метод

string

Example

https://pay.example.com/transfer/12345

qrCode

required

QR-код для отображения

string

Example

https://cdn.example.com/qrcode/payment.png

accountNumber

required

Номер банковского счёта

string

Example

RU02000000000000001234

bankBic

BIC банка для банковского счёта

object

Example

040702615

currency

required

Фиатная валюта платёжного метода

string

Example

RUB

crossBorderCurrency

Трансграничная валюта платёжного метода

object

Example

RUB

paymentPageUrl

required

Ссылка на внешнюю платёжную страницу, где клиент видит реквизиты, сумму и таймер

string

Example

https://pay.example.com/external/4b9a1a2c-9c10-4f6b-88aa-77bb66cc55dd

dispute

required

Информация о споре/отмене (если есть)

object

disputeCreatedAt

required

Дата и время создания спора

object

Example

2024-09-10T10:15:00.000Z

disputeResolvedAt

required

Дата и время разрешения спора

object

Example

2024-09-11T18:40:00.000Z

disputeMerchantCheckUrl

required

Ссылка для мерчанта на проверку чека по спору

object

Example

https://merchant.example.com/disputes/check/aa11bb22

disputeTraderCheckUrl

required

Ссылка для трейдера на проверку чека по спору

object

Example

https://trader.example.com/disputes/check/cc33dd44

disputeTraderFiatAmount

required

Фиатная сумма, заявленная трейдером в споре

object

Example

1800

disputeTraderDeclineReason

required

Причина отказа трейдера (если применимо)

object

Example

Платёж не найден в выписке банка

cancelReason

required

Причина отмены сделки (если применимо)

object

Example

Истекло время оплаты

payerInfo

required

Информация о плательщике (как хранится в системе)

object

userAgent

required

Строка, содержащая информацию о браузере и устройстве плательщика

string

Example

Mozilla/5.0 (Linux; Android 13; SM-G991B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Mobile Safari/537.36

ip

required

IP-адрес плательщика

string

Example

203.0.113.45

userId

required

Уникальный идентификатор пользователя в системе

string

Example

usr_847392

fingerprint

Хэш для уникальной идентификации устройства или сессии пользователя. Формируется в соответствии со стандартом FingerprintJS

string

Example

9d1f2c8a7b6e5d4c3a2f1e0d9c8b7a6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1

registeredAt

Временная метка, указывающая дату регистрации плательщика

string

Example

1714567890123

Example

{
  "name": "Алексей",
  "phone": "79001234567"
}

payerBank

Банк плательщика, если он был передан при создании pay-in.

string

nullable

Example

ALFA

paymentLifetime

required

Окно транзакции в минутах

number

Example

20

createdAt

required

Дата и время создания сделки

string format: date-time

Example

2024-09-10T10:00:00.000Z

invoicesUrl

required

Ссылка на инвойсы

Array<string>

nullable

Example

https://merchant.example.com/invoices/trade/c2f8a3e1

factFiatAmount

Фактическая выплаченная сумма для matching callback

number

nullable

Example

43650

fills

Части выплаты мэтчинга (category = matching): чеки и взятые fallback с непрозрачным fillId — без id сделок игроков и трейдеров (D11, D25).

Array<object>

object

fillId

required

Идентификатор части (matching-trades.id, UUID v4)

string

Example

5b1c7a8e-3f0a-4c55-9d8e-0a1b2c3d4e5f

amount

required

Сумма части, ₽

number

Example

5000

status

required

string

Allowed values: in_progress success reversed

Example

success

settledAt

required

Момент успеха части

string format: date-time

nullable

Example

2026-09-28T10:20:00.000Z

source

required

string

Allowed values: pay_in fallback

Example

pay_in

reversedAt

required

Момент аннулирования части: у status=reversed — время сторно / отмены по претензии, у остальных частей null (D27)

string format: date-time

nullable

receiptValidation

Краткий публичный результат проверки загруженного чека.

object

summary

required

Краткий публичный результат проверки чека.

string

Example

Требуется ручное решение.

matchingId

ID matching, если сделка привязана к matching.

string

nullable

matchingTradeType

Тип связи сделки с matching.

string

nullable

Allowed values: pay_in fallback_pay_out

object

object

category

required

Категория callback payload

string

Allowed values: trade matching

Example

trade

id

required

Уникальный идентификатор сделки

string

Example

9ee42dff-83ec-4a90-8dfb-1fc74d3afbe4

merchantTransactionId

required

Идентификатор транзакции мерчанта (внешний)

string

Example

MERCH-TRX-20240910-00042

amount

required

Сумма в фиатной валюте

number

Example

2500

crypto

required

Сумма в USDT для мерчанта (минимальные единицы, строкой). Считается при выдаче реквизита: в pending — null, у отмены до выдачи реквизита (requisiteIssuedAt = null) — “0”, что значит «ещё не посчитано», а не «ноль».

string format: int64

nullable

Example

59459459

rate

required

Курс фиат → USDT для мерчанта. null, пока реквизит не выдан (pending и отмена до выдачи реквизита).

number

nullable

Example

92.5

fee

required

Комиссия мерчанта (минимальные единицы USDT, строкой). Считается при выдаче реквизита: пока реквизит не выдан (pending и отмена до выдачи реквизита, requisiteIssuedAt = null) — “0”, что значит «ещё не посчитано», а не «комиссии нет».

string format: int64

Example

1189189

type

required

Тип сделки

string

Allowed values: pay-in pay-out

Example

pay-in

method

required

Метод реквизитов/оплаты

string

Allowed values: account ca_sbp ca_c2c sbp sbp_invoice qr ftd_qr qr_vietnam c2c ost_c2c c2c_invoice link foreign_sbp foreign_c2c alfa_tjs_sbp abh_sbp abh_c2c mobile_commercial mobile_commerce_tjs

Example

c2c

status

required

Текущий статус сделки

string

Allowed values: pending active checking checking_manually manual_review dispute success_changed success canceled

Example

active

requisite

required

Реквизиты для проведения сделки

object

id

required

Идентификатор реквизита

string

Example

a3c9f2e1-7d44-4c9a-9c21-8bfa11223344

ownerName

required

Имя владельца платёжного метода

string

Example

Иван Иванов

firstName

Owner first name, when the bank requires split owner name fields.

object

Example

Иван

lastName

Owner last name, when the bank requires split owner name fields.

object

Example

Иванов

bank

required

Идентификатор банка для сделки

string

Example

SBER

cardNumber

required

Номер карты платёжного метода

string

Example

548673******9012

sbpNumber

required

Номер телефона для СБП

string

Example

79035554433

link

required

Ссылка на платёжный метод

string

Example

https://pay.example.com/transfer/12345

qrCode

required

QR-код для отображения

string

Example

https://cdn.example.com/qrcode/payment.png

accountNumber

required

Номер банковского счёта

string

Example

RU02000000000000001234

bankBic

BIC банка для банковского счёта

object

Example

040702615

currency

required

Фиатная валюта платёжного метода

string

Example

RUB

crossBorderCurrency

Трансграничная валюта платёжного метода

object

Example

RUB

paymentPageUrl

required

Ссылка на внешнюю платёжную страницу, где клиент видит реквизиты, сумму и таймер

string

Example

https://pay.example.com/external/4b9a1a2c-9c10-4f6b-88aa-77bb66cc55dd

dispute

required

Информация о споре/отмене (если есть)

object

disputeCreatedAt

required

Дата и время создания спора

object

Example

2024-09-10T10:15:00.000Z

disputeResolvedAt

required

Дата и время разрешения спора

object

Example

2024-09-11T18:40:00.000Z

disputeMerchantCheckUrl

required

Ссылка для мерчанта на проверку чека по спору

object

Example

https://merchant.example.com/disputes/check/aa11bb22

disputeTraderCheckUrl

required

Ссылка для трейдера на проверку чека по спору

object

Example

https://trader.example.com/disputes/check/cc33dd44

disputeTraderFiatAmount

required

Фиатная сумма, заявленная трейдером в споре

object

Example

1800

disputeTraderDeclineReason

required

Причина отказа трейдера (если применимо)

object

Example

Платёж не найден в выписке банка

cancelReason

required

Причина отмены сделки (если применимо)

object

Example

Истекло время оплаты

payerInfo

required

Информация о плательщике (как хранится в системе)

object

userAgent

required

Строка, содержащая информацию о браузере и устройстве плательщика

string

Example

Mozilla/5.0 (Linux; Android 13; SM-G991B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Mobile Safari/537.36

ip

required

IP-адрес плательщика

string

Example

203.0.113.45

userId

required

Уникальный идентификатор пользователя в системе

string

Example

usr_847392

fingerprint

Хэш для уникальной идентификации устройства или сессии пользователя. Формируется в соответствии со стандартом FingerprintJS

string

Example

9d1f2c8a7b6e5d4c3a2f1e0d9c8b7a6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1

registeredAt

Временная метка, указывающая дату регистрации плательщика

string

Example

1714567890123

Example

{
  "name": "Алексей",
  "phone": "79001234567"
}

payerBank

Банк плательщика, если он был передан при создании pay-in.

string

nullable

Example

ALFA

paymentLifetime

required

Окно оплаты, мин. В pending — null: окно начнётся с выдачи реквизита (requisiteIssuedAt).

number

nullable

Example

15

createdAt

required

Дата и время создания сделки

string format: date-time

Example

2024-09-10T10:00:00.000Z

invoicesUrl

required

Ссылка на инвойсы

Array<string>

nullable

Example

https://merchant.example.com/invoices/trade/c2f8a3e1

factFiatAmount

Фактическая выплаченная сумма для matching callback

number

nullable

Example

43650

receiptValidation

Краткий публичный результат проверки загруженного чека.

object

summary

required

Краткий публичный результат проверки чека.

string

Example

Требуется ручное решение.

initialAmount

required

Сумма, которую запросил игрок, ₽

number

Example

5000

amountChanged

required

Итоговая сумма отличается от запрошенной (игрок выбрал вариант)

boolean

cancelDetail

required

Деталь отмены при cancelReason=NONE (этап выбора суммы)

string

nullable

Allowed values: amount_offer_declined amount_offer_expired no_matching_capacity matching_fallback_superseded matching_fallback_sla

amountOptions

required

Этап выбора суммы; вне его и в callback-ах — null

object

requestedAmount

required

Сумма, которую запросил игрок, ₽

number

Example

5000

ownAmountAvailable

required

Своя сумма доступна («Оплатить X», мягкая сессия)

boolean

offers

required

До 3 вариантов, по возрастанию amount

Array<object>

object

offerId

required

Идентификатор варианта: первые 12 hex sha256(tradeId|amount|secret), стабилен в сессии

string

Example

3fa85f64a1b2

amount

required

Сумма варианта, ₽

number

Example

5500

diff

required

Amount − requestedAmount, со знаком

number

Example

500

recommended

required

Рекомендованный вариант (быстрее подтвердится)

boolean

Example

true

insistAvailable

required

Доступно «Оставить мою сумму» (обязательная сессия, раунд 1)

boolean

Example

true

round

required

Раунд выбора

number

Allowed values: 1 2

Example

1

choiceExpiresAt

required

До какого момента принимается выбор (= конец этапа − 30 с), ISO

string

Example

2026-09-28T10:10:00.000Z

sessionStatus

Статус сессии выбора (решение второго ревью 24.09); отсутствует → страница считает open

string

Allowed values: open accepted declined expired

Example

open

requisiteIssuedAt

required

Момент выдачи реквизита; окно оплаты считается от него

string format: date-time

nullable

Example

2026-09-28T10:05:00.000Z

creditReversedAt

required

Сторно зачисления (P3 T19): когда платформа списала с вашего баланса зачисление по этому депозиту — чек признан фейком, и вы подтвердили, что игрок не использовал средства. После сторно status депозита — canceled, приходит callback canceled (повторного success не бывает). null — сторно не было.

string format: date-time

nullable

creditReversedCrypto

required

Сколько списано с баланса при сторно зачисления, минимальные единицы USDT (строкой): ровно зачисленное по депозиту (crypto − fee), запись журнала баланса MATCHING_PAY_IN_CREDIT_REVERSED. null — сторно не было.

string format: int64

nullable

eventSeq

Только в callback-ах (в ответах API поля нет): номер события по сделке — 1, 2, …, растёт с каждым событием. Тело callback-а — состояние на момент этого события; повторная доставка того же события приходит с тем же eventSeq и тем же телом. Обрабатывайте идемпотентно по паре (id, eventSeq) и не применяйте событие с eventSeq меньше уже обработанного.

number

Example

2

object

object

id

required

Идентификатор выплаты (matching.id)

string

Example

9ee42dff-83ec-4a90-8dfb-1fc74d3afbe4

merchantTransactionId

required

Идентификатор выплаты у мерчанта (ключ идемпотентности)

string

Example

payout-100500

status

required

string

Allowed values: active success success_changed canceled

Example

active

type

required

string

Allowed values: pay-out

Example

pay-out

method

required

string

Allowed values: sbp_invoice c2c_invoice

Example

sbp_invoice

currency

required

string

Allowed values: UAH KZT USD RUB TJS UZS ARS

Example

RUB

amount

required

Сумма выплаты, ₽

number

Example

15500

factFiatAmount

required

Фактически оплачено получателю, ₽

number

Example

10000

crypto

required

Списано при создании (тело), минимальные единицы USDT (строка)

string

Example

167567567

fee

required

Списано при создании (ставка мэтчинга), минимальные единицы USDT (строка)

string

Example

1675675

rate

required

Курс при создании (≠ 0)

number

Example

92.5

requisite

required

Реквизит получателя, как в запросе

object

id

required

Идентификатор реквизита

string

Example

a3c9f2e1-7d44-4c9a-9c21-8bfa11223344

ownerName

required

Имя владельца платёжного метода

string

Example

Иван Иванов

firstName

Owner first name, when the bank requires split owner name fields.

object

Example

Иван

lastName

Owner last name, when the bank requires split owner name fields.

object

Example

Иванов

bank

required

Идентификатор банка для сделки

string

Example

SBER

cardNumber

required

Номер карты платёжного метода

string

Example

548673******9012

sbpNumber

required

Номер телефона для СБП

string

Example

79035554433

link

required

Ссылка на платёжный метод

string

Example

https://pay.example.com/transfer/12345

qrCode

required

QR-код для отображения

string

Example

https://cdn.example.com/qrcode/payment.png

accountNumber

required

Номер банковского счёта

string

Example

RU02000000000000001234

bankBic

BIC банка для банковского счёта

object

Example

040702615

currency

required

Фиатная валюта платёжного метода

string

Example

RUB

crossBorderCurrency

Трансграничная валюта платёжного метода

object

Example

RUB

isMatching

required

number

Example

true

slaDeadlineAt

required

Дедлайн SLA выплаты

string

Example

2026-09-28T12:00:00.000Z

closingStartedAt

required

Начало закрытия (SLA, «Закрыть сейчас», «Закрыть на оплаченном»); null до closing

string format: date-time

nullable

closeReason

required

string

nullable

Allowed values: filled sla_recalculated admin_recalculated externally_reduced merchant_recalculated adjusted_after_close

cancelReason

required

string

nullable

Allowed values: sla_expired_no_fill admin merchant externally_reduced

adjustedAt

required

Последняя корректировка после финала (closeReason=adjusted_after_close)

string format: date-time

nullable

refundedCrypto

required

Возвращено на баланс по выплате, минимальные единицы USDT (строка), нетто: неиспользованный остаток и корректировки после финала за вычетом повторных списаний

string

Example

0

eventSeq

required

Номер события callback-а (= eventRank outbox); 0 до первого callback-а. Дедуп — по (id, eventSeq)

number

0

fills

required

Array<object>

object

fillId

required

Идентификатор части (matching-trades.id, UUID v4)

string

Example

5b1c7a8e-3f0a-4c55-9d8e-0a1b2c3d4e5f

amount

required

Сумма части, ₽

number

Example

5000

status

required

string

Allowed values: in_progress success reversed

Example

success

settledAt

required

Момент успеха части

string format: date-time

nullable

Example

2026-09-28T10:20:00.000Z

source

required

string

Allowed values: pay_in fallback

Example

pay_in

reversedAt

required

Момент аннулирования части: у status=reversed — время сторно / отмены по претензии, у остальных частей null (D27)

string format: date-time

nullable

createdAt

required

string

Example

2026-09-28T10:00:00.000Z

updatedAt

required

string

Example

2026-09-28T10:20:00.000Z

callbackUrl

required

string

nullable

Example

https://merchant.example.com/callback

400

Валидация тела (amount, requisite, merchantTransactionId, callbackUrl, timeoutInMin); выплата мэтчинга: MISSED_PARAMS — в реквизите нет ни sbpNumber, ни cardNumber; MATCHING_METHOD_NOT_ALLOWED — ostCardNumber или qrCode

401

INVALID_API_KEY — нет или неверный X-Secure-Key

403

Выплата мэтчинга (13.2): MATCHING_DISABLED | MATCHING_PAYOUT_DISABLED | MATCHING_CURRENCY_NOT_SUPPORTED | MATCHING_AMOUNT_OUT_OF_LIMITS | MATCHING_TIMEOUT_OUT_OF_LIMITS | MATCHING_OPEN_VOLUME_LIMIT_REACHED | MATCHING_BALANCE_LIMIT_EXCEEDED; USER_HAS_NO_PERMISSIONS — JWT кабинета с ролью только для чтения (MERCHANT_SUPPORT) не выполняет изменения

409

Конфликт мэтчинга: единое тело {statusCode, message, trade}, trade — текущее состояние той же сделки / выплаты (MatchingConflictResponseDto)

object

statusCode

required

number

Allowed values: 409

Example

409

message

required

string

Allowed values: MATCHING_DUPLICATE_MERCHANT_TRANSACTION_ID MATCHING_REQUISITE_ALREADY_OPEN MATCHING_PAYOUT_NOT_CANCELABLE MATCHING_AMOUNT_OPTION_UNAVAILABLE MATCHING_AMOUNT_SELECTION_CLOSED MATCHING_KEEP_AMOUNT_UNAVAILABLE MATCHING_CHECK_UNDER_REVIEW MATCHING_LATE_PAYMENT_CAPACITY_TAKEN MATCHING_LEGACY_TRADE MATCHING_RESERVE_RELEASED MATCHING_CASE_ALREADY_RESOLVED MATCHING_CASE_ASSIGNED_TO_OTHER MATCHING_REOPEN_CALLBACK_PENDING MATCHING_EXCLUSION_OTHER_CLAIM MATCHING_EXCLUSION_FALLBACK_UNAVAILABLE MATCHING_CLAIM_ALREADY_OPEN MATCHING_USE_DISPUTES_SECTION MATCHING_CALLBACK_NOT_FINAL MATCHING_FALLBACK_RELEASE_UNAVAILABLE

Example

MATCHING_AMOUNT_OPTION_UNAVAILABLE

trade

required

One of:

object

object

category

required

Категория callback payload

string

Allowed values: trade matching

Example

trade

id

required

Уникальный идентификатор сделки

string

Example

9ee42dff-83ec-4a90-8dfb-1fc74d3afbe4

merchantTransactionId

required

Идентификатор транзакции мерчанта (внешний)

string

Example

MERCH-TRX-20240910-00042

matchingTransactionId

Идентификатор matching-транзакции, если callback относится к matching-linked pay-out.

string

nullable

Example

MATCHING-TRX-20240910-00042

amount

required

Сумма в фиатной валюте

number

Example

2500

crypto

required

Сумма в криптовалюте (для мерчанта)

string format: int64

Example

124825278

rate

required

Курс обмена фиат → крипто (для мерчанта)

number

Example

80.12

fee

required

Комиссия мерчанта

string format: int64

Example

125000

type

required

Тип сделки

string

Allowed values: pay-in pay-out

Example

pay-in

method

required

Метод реквизитов/оплаты

string

Allowed values: account ca_sbp ca_c2c sbp sbp_invoice qr ftd_qr qr_vietnam c2c ost_c2c c2c_invoice link foreign_sbp foreign_c2c alfa_tjs_sbp abh_sbp abh_c2c mobile_commercial mobile_commerce_tjs

Example

c2c

status

required

Текущий статус сделки

string

Allowed values: pending active checking checking_manually manual_review dispute success_changed success canceled

Example

active

requisite

required

Реквизиты для проведения сделки

object

id

required

Идентификатор реквизита

string

Example

a3c9f2e1-7d44-4c9a-9c21-8bfa11223344

ownerName

required

Имя владельца платёжного метода

string

Example

Иван Иванов

firstName

Owner first name, when the bank requires split owner name fields.

object

Example

Иван

lastName

Owner last name, when the bank requires split owner name fields.

object

Example

Иванов

bank

required

Идентификатор банка для сделки

string

Example

SBER

cardNumber

required

Номер карты платёжного метода

string

Example

548673******9012

sbpNumber

required

Номер телефона для СБП

string

Example

79035554433

link

required

Ссылка на платёжный метод

string

Example

https://pay.example.com/transfer/12345

qrCode

required

QR-код для отображения

string

Example

https://cdn.example.com/qrcode/payment.png

accountNumber

required

Номер банковского счёта

string

Example

RU02000000000000001234

bankBic

BIC банка для банковского счёта

object

Example

040702615

currency

required

Фиатная валюта платёжного метода

string

Example

RUB

crossBorderCurrency

Трансграничная валюта платёжного метода

object

Example

RUB

paymentPageUrl

required

Ссылка на внешнюю платёжную страницу, где клиент видит реквизиты, сумму и таймер

string

Example

https://pay.example.com/external/4b9a1a2c-9c10-4f6b-88aa-77bb66cc55dd

dispute

required

Информация о споре/отмене (если есть)

object

disputeCreatedAt

required

Дата и время создания спора

object

Example

2024-09-10T10:15:00.000Z

disputeResolvedAt

required

Дата и время разрешения спора

object

Example

2024-09-11T18:40:00.000Z

disputeMerchantCheckUrl

required

Ссылка для мерчанта на проверку чека по спору

object

Example

https://merchant.example.com/disputes/check/aa11bb22

disputeTraderCheckUrl

required

Ссылка для трейдера на проверку чека по спору

object

Example

https://trader.example.com/disputes/check/cc33dd44

disputeTraderFiatAmount

required

Фиатная сумма, заявленная трейдером в споре

object

Example

1800

disputeTraderDeclineReason

required

Причина отказа трейдера (если применимо)

object

Example

Платёж не найден в выписке банка

cancelReason

required

Причина отмены сделки (если применимо)

object

Example

Истекло время оплаты

payerInfo

required

Информация о плательщике (как хранится в системе)

object

userAgent

required

Строка, содержащая информацию о браузере и устройстве плательщика

string

Example

Mozilla/5.0 (Linux; Android 13; SM-G991B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Mobile Safari/537.36

ip

required

IP-адрес плательщика

string

Example

203.0.113.45

userId

required

Уникальный идентификатор пользователя в системе

string

Example

usr_847392

fingerprint

Хэш для уникальной идентификации устройства или сессии пользователя. Формируется в соответствии со стандартом FingerprintJS

string

Example

9d1f2c8a7b6e5d4c3a2f1e0d9c8b7a6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1

registeredAt

Временная метка, указывающая дату регистрации плательщика

string

Example

1714567890123

Example

{
  "name": "Алексей",
  "phone": "79001234567"
}

payerBank

Банк плательщика, если он был передан при создании pay-in.

string

nullable

Example

ALFA

paymentLifetime

required

Окно транзакции в минутах

number

Example

20

createdAt

required

Дата и время создания сделки

string format: date-time

Example

2024-09-10T10:00:00.000Z

invoicesUrl

required

Ссылка на инвойсы

Array<string>

nullable

Example

https://merchant.example.com/invoices/trade/c2f8a3e1

factFiatAmount

Фактическая выплаченная сумма для matching callback

number

nullable

Example

43650

fills

Части выплаты мэтчинга (category = matching): чеки и взятые fallback с непрозрачным fillId — без id сделок игроков и трейдеров (D11, D25).

Array<object>

object

fillId

required

Идентификатор части (matching-trades.id, UUID v4)

string

Example

5b1c7a8e-3f0a-4c55-9d8e-0a1b2c3d4e5f

amount

required

Сумма части, ₽

number

Example

5000

status

required

string

Allowed values: in_progress success reversed

Example

success

settledAt

required

Момент успеха части

string format: date-time

nullable

Example

2026-09-28T10:20:00.000Z

source

required

string

Allowed values: pay_in fallback

Example

pay_in

reversedAt

required

Момент аннулирования части: у status=reversed — время сторно / отмены по претензии, у остальных частей null (D27)

string format: date-time

nullable

receiptValidation

Краткий публичный результат проверки загруженного чека.

object

summary

required

Краткий публичный результат проверки чека.

string

Example

Требуется ручное решение.

matchingId

ID matching, если сделка привязана к matching.

string

nullable

matchingTradeType

Тип связи сделки с matching.

string

nullable

Allowed values: pay_in fallback_pay_out

object

object

category

required

Категория callback payload

string

Allowed values: trade matching

Example

trade

id

required

Уникальный идентификатор сделки

string

Example

9ee42dff-83ec-4a90-8dfb-1fc74d3afbe4

merchantTransactionId

required

Идентификатор транзакции мерчанта (внешний)

string

Example

MERCH-TRX-20240910-00042

amount

required

Сумма в фиатной валюте

number

Example

2500

crypto

required

Сумма в USDT для мерчанта (минимальные единицы, строкой). Считается при выдаче реквизита: в pending — null, у отмены до выдачи реквизита (requisiteIssuedAt = null) — “0”, что значит «ещё не посчитано», а не «ноль».

string format: int64

nullable

Example

59459459

rate

required

Курс фиат → USDT для мерчанта. null, пока реквизит не выдан (pending и отмена до выдачи реквизита).

number

nullable

Example

92.5

fee

required

Комиссия мерчанта (минимальные единицы USDT, строкой). Считается при выдаче реквизита: пока реквизит не выдан (pending и отмена до выдачи реквизита, requisiteIssuedAt = null) — “0”, что значит «ещё не посчитано», а не «комиссии нет».

string format: int64

Example

1189189

type

required

Тип сделки

string

Allowed values: pay-in pay-out

Example

pay-in

method

required

Метод реквизитов/оплаты

string

Allowed values: account ca_sbp ca_c2c sbp sbp_invoice qr ftd_qr qr_vietnam c2c ost_c2c c2c_invoice link foreign_sbp foreign_c2c alfa_tjs_sbp abh_sbp abh_c2c mobile_commercial mobile_commerce_tjs

Example

c2c

status

required

Текущий статус сделки

string

Allowed values: pending active checking checking_manually manual_review dispute success_changed success canceled

Example

active

requisite

required

Реквизиты для проведения сделки

object

id

required

Идентификатор реквизита

string

Example

a3c9f2e1-7d44-4c9a-9c21-8bfa11223344

ownerName

required

Имя владельца платёжного метода

string

Example

Иван Иванов

firstName

Owner first name, when the bank requires split owner name fields.

object

Example

Иван

lastName

Owner last name, when the bank requires split owner name fields.

object

Example

Иванов

bank

required

Идентификатор банка для сделки

string

Example

SBER

cardNumber

required

Номер карты платёжного метода

string

Example

548673******9012

sbpNumber

required

Номер телефона для СБП

string

Example

79035554433

link

required

Ссылка на платёжный метод

string

Example

https://pay.example.com/transfer/12345

qrCode

required

QR-код для отображения

string

Example

https://cdn.example.com/qrcode/payment.png

accountNumber

required

Номер банковского счёта

string

Example

RU02000000000000001234

bankBic

BIC банка для банковского счёта

object

Example

040702615

currency

required

Фиатная валюта платёжного метода

string

Example

RUB

crossBorderCurrency

Трансграничная валюта платёжного метода

object

Example

RUB

paymentPageUrl

required

Ссылка на внешнюю платёжную страницу, где клиент видит реквизиты, сумму и таймер

string

Example

https://pay.example.com/external/4b9a1a2c-9c10-4f6b-88aa-77bb66cc55dd

dispute

required

Информация о споре/отмене (если есть)

object

disputeCreatedAt

required

Дата и время создания спора

object

Example

2024-09-10T10:15:00.000Z

disputeResolvedAt

required

Дата и время разрешения спора

object

Example

2024-09-11T18:40:00.000Z

disputeMerchantCheckUrl

required

Ссылка для мерчанта на проверку чека по спору

object

Example

https://merchant.example.com/disputes/check/aa11bb22

disputeTraderCheckUrl

required

Ссылка для трейдера на проверку чека по спору

object

Example

https://trader.example.com/disputes/check/cc33dd44

disputeTraderFiatAmount

required

Фиатная сумма, заявленная трейдером в споре

object

Example

1800

disputeTraderDeclineReason

required

Причина отказа трейдера (если применимо)

object

Example

Платёж не найден в выписке банка

cancelReason

required

Причина отмены сделки (если применимо)

object

Example

Истекло время оплаты

payerInfo

required

Информация о плательщике (как хранится в системе)

object

userAgent

required

Строка, содержащая информацию о браузере и устройстве плательщика

string

Example

Mozilla/5.0 (Linux; Android 13; SM-G991B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Mobile Safari/537.36

ip

required

IP-адрес плательщика

string

Example

203.0.113.45

userId

required

Уникальный идентификатор пользователя в системе

string

Example

usr_847392

fingerprint

Хэш для уникальной идентификации устройства или сессии пользователя. Формируется в соответствии со стандартом FingerprintJS

string

Example

9d1f2c8a7b6e5d4c3a2f1e0d9c8b7a6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1

registeredAt

Временная метка, указывающая дату регистрации плательщика

string

Example

1714567890123

Example

{
  "name": "Алексей",
  "phone": "79001234567"
}

payerBank

Банк плательщика, если он был передан при создании pay-in.

string

nullable

Example

ALFA

paymentLifetime

required

Окно оплаты, мин. В pending — null: окно начнётся с выдачи реквизита (requisiteIssuedAt).

number

nullable

Example

15

createdAt

required

Дата и время создания сделки

string format: date-time

Example

2024-09-10T10:00:00.000Z

invoicesUrl

required

Ссылка на инвойсы

Array<string>

nullable

Example

https://merchant.example.com/invoices/trade/c2f8a3e1

factFiatAmount

Фактическая выплаченная сумма для matching callback

number

nullable

Example

43650

receiptValidation

Краткий публичный результат проверки загруженного чека.

object

summary

required

Краткий публичный результат проверки чека.

string

Example

Требуется ручное решение.

initialAmount

required

Сумма, которую запросил игрок, ₽

number

Example

5000

amountChanged

required

Итоговая сумма отличается от запрошенной (игрок выбрал вариант)

boolean

cancelDetail

required

Деталь отмены при cancelReason=NONE (этап выбора суммы)

string

nullable

Allowed values: amount_offer_declined amount_offer_expired no_matching_capacity matching_fallback_superseded matching_fallback_sla

amountOptions

required

Этап выбора суммы; вне его и в callback-ах — null

object

requestedAmount

required

Сумма, которую запросил игрок, ₽

number

Example

5000

ownAmountAvailable

required

Своя сумма доступна («Оплатить X», мягкая сессия)

boolean

offers

required

До 3 вариантов, по возрастанию amount

Array<object>

object

offerId

required

Идентификатор варианта: первые 12 hex sha256(tradeId|amount|secret), стабилен в сессии

string

Example

3fa85f64a1b2

amount

required

Сумма варианта, ₽

number

Example

5500

diff

required

Amount − requestedAmount, со знаком

number

Example

500

recommended

required

Рекомендованный вариант (быстрее подтвердится)

boolean

Example

true

insistAvailable

required

Доступно «Оставить мою сумму» (обязательная сессия, раунд 1)

boolean

Example

true

round

required

Раунд выбора

number

Allowed values: 1 2

Example

1

choiceExpiresAt

required

До какого момента принимается выбор (= конец этапа − 30 с), ISO

string

Example

2026-09-28T10:10:00.000Z

sessionStatus

Статус сессии выбора (решение второго ревью 24.09); отсутствует → страница считает open

string

Allowed values: open accepted declined expired

Example

open

requisiteIssuedAt

required

Момент выдачи реквизита; окно оплаты считается от него

string format: date-time

nullable

Example

2026-09-28T10:05:00.000Z

creditReversedAt

required

Сторно зачисления (P3 T19): когда платформа списала с вашего баланса зачисление по этому депозиту — чек признан фейком, и вы подтвердили, что игрок не использовал средства. После сторно status депозита — canceled, приходит callback canceled (повторного success не бывает). null — сторно не было.

string format: date-time

nullable

creditReversedCrypto

required

Сколько списано с баланса при сторно зачисления, минимальные единицы USDT (строкой): ровно зачисленное по депозиту (crypto − fee), запись журнала баланса MATCHING_PAY_IN_CREDIT_REVERSED. null — сторно не было.

string format: int64

nullable

eventSeq

Только в callback-ах (в ответах API поля нет): номер события по сделке — 1, 2, …, растёт с каждым событием. Тело callback-а — состояние на момент этого события; повторная доставка того же события приходит с тем же eventSeq и тем же телом. Обрабатывайте идемпотентно по паре (id, eventSeq) и не применяйте событие с eventSeq меньше уже обработанного.

number

Example

2

object

object

id

required

Идентификатор выплаты (matching.id)

string

Example

9ee42dff-83ec-4a90-8dfb-1fc74d3afbe4

merchantTransactionId

required

Идентификатор выплаты у мерчанта (ключ идемпотентности)

string

Example

payout-100500

status

required

string

Allowed values: active success success_changed canceled

Example

active

type

required

string

Allowed values: pay-out

Example

pay-out

method

required

string

Allowed values: sbp_invoice c2c_invoice

Example

sbp_invoice

currency

required

string

Allowed values: UAH KZT USD RUB TJS UZS ARS

Example

RUB

amount

required

Сумма выплаты, ₽

number

Example

15500

factFiatAmount

required

Фактически оплачено получателю, ₽

number

Example

10000

crypto

required

Списано при создании (тело), минимальные единицы USDT (строка)

string

Example

167567567

fee

required

Списано при создании (ставка мэтчинга), минимальные единицы USDT (строка)

string

Example

1675675

rate

required

Курс при создании (≠ 0)

number

Example

92.5

requisite

required

Реквизит получателя, как в запросе

object

id

required

Идентификатор реквизита

string

Example

a3c9f2e1-7d44-4c9a-9c21-8bfa11223344

ownerName

required

Имя владельца платёжного метода

string

Example

Иван Иванов

firstName

Owner first name, when the bank requires split owner name fields.

object

Example

Иван

lastName

Owner last name, when the bank requires split owner name fields.

object

Example

Иванов

bank

required

Идентификатор банка для сделки

string

Example

SBER

cardNumber

required

Номер карты платёжного метода

string

Example

548673******9012

sbpNumber

required

Номер телефона для СБП

string

Example

79035554433

link

required

Ссылка на платёжный метод

string

Example

https://pay.example.com/transfer/12345

qrCode

required

QR-код для отображения

string

Example

https://cdn.example.com/qrcode/payment.png

accountNumber

required

Номер банковского счёта

string

Example

RU02000000000000001234

bankBic

BIC банка для банковского счёта

object

Example

040702615

currency

required

Фиатная валюта платёжного метода

string

Example

RUB

crossBorderCurrency

Трансграничная валюта платёжного метода

object

Example

RUB

isMatching

required

number

Example

true

slaDeadlineAt

required

Дедлайн SLA выплаты

string

Example

2026-09-28T12:00:00.000Z

closingStartedAt

required

Начало закрытия (SLA, «Закрыть сейчас», «Закрыть на оплаченном»); null до closing

string format: date-time

nullable

closeReason

required

string

nullable

Allowed values: filled sla_recalculated admin_recalculated externally_reduced merchant_recalculated adjusted_after_close

cancelReason

required

string

nullable

Allowed values: sla_expired_no_fill admin merchant externally_reduced

adjustedAt

required

Последняя корректировка после финала (closeReason=adjusted_after_close)

string format: date-time

nullable

refundedCrypto

required

Возвращено на баланс по выплате, минимальные единицы USDT (строка), нетто: неиспользованный остаток и корректировки после финала за вычетом повторных списаний

string

Example

0

eventSeq

required

Номер события callback-а (= eventRank outbox); 0 до первого callback-а. Дедуп — по (id, eventSeq)

number

0

fills

required

Array<object>

object

fillId

required

Идентификатор части (matching-trades.id, UUID v4)

string

Example

5b1c7a8e-3f0a-4c55-9d8e-0a1b2c3d4e5f

amount

required

Сумма части, ₽

number

Example

5000

status

required

string

Allowed values: in_progress success reversed

Example

success

settledAt

required

Момент успеха части

string format: date-time

nullable

Example

2026-09-28T10:20:00.000Z

source

required

string

Allowed values: pay_in fallback

Example

pay_in

reversedAt

required

Момент аннулирования части: у status=reversed — время сторно / отмены по претензии, у остальных частей null (D27)

string format: date-time

nullable

createdAt

required

string

Example

2026-09-28T10:00:00.000Z

updatedAt

required

string

Example

2026-09-28T10:20:00.000Z

callbackUrl

required

string

nullable

Example

https://merchant.example.com/callback

caseId

MATCHING_LATE_PAYMENT_CAPACITY_TAKEN, MATCHING_CLAIM_ALREADY_OPEN

string

assignedToId

MATCHING_CASE_ASSIGNED_TO_OTHER

string

nullable

resolvedByType

MATCHING_CASE_ALREADY_RESOLVED

string

Allowed values: admin super_admin moderator system

resolvedById

MATCHING_CASE_ALREADY_RESOLVED

string

nullable

resolvedByName

MATCHING_CASE_ALREADY_RESOLVED

string

nullable