Skip to content
OhlaPay

Выбрать вариант суммы pay-in

POST
/payment/pay-in/{id}/amount-options/accept

Ровно одно из {offerId} | {ownAmount:true}. Итоговую сумму нужно показать игроку до оплаты; автопринятие альтернативы запрещено.

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
string

Header Parameters

Section titled “Header Parameters ”
X-Secure-Key
required
string

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

Request Body required

Section titled “Request Body required ”
object
offerId

Выбранный вариант (offerId из amountOptions.offers)

string
Example
3fa85f64a1b2
ownAmount

«Оплатить свою сумму» (только при ownAmountAvailable=true)

number
Example
true

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Выбор варианта суммы pay-in

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

400

Section titled “400 ”

Нет ни offerId, ни ownAmount, или оба сразу

403

Section titled “403 ”

USER_HAS_NO_PERMISSIONS — JWT кабинета с ролью только для чтения (MERCHANT_SUPPORT) не выполняет изменения

404

Section titled “404 ”

TRADE_NOT_FOUND

409

Section titled “409 ”

MATCHING_AMOUNT_OPTION_UNAVAILABLE (trade.amountOptions — свежий блок) | MATCHING_AMOUNT_SELECTION_CLOSED. Конфликт мэтчинга: единое тело {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
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
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