Перейти к содержимому
Cashwell

Создание спора по сделке

POST
/payment/{type}/{id}/dispute
curl --request POST \
  --url https://example.comhttps://svc.cashwell.io/payment/example/example/dispute \
  --header 'Content-Type: application/json' \
  --header 'X-Secure-Key: example' \
  --data '{ "uploadMetaKey": "mjuikrewfmnrgbhty4ui3okqwmefnbght4yu3irkefjghy4tu38i", "amount": 500.01 }'

Parameters

Заголовок раздела «Parameters»

Path Parameters

Заголовок раздела «Path Parameters»
id
required
string
type
required
string

Header Parameters

Заголовок раздела «Header Parameters»
X-Secure-Key
required
string

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

Request Bodyrequired

Заголовок раздела «Request Bodyrequired»
Media typeapplication/json
object
uploadMetaKey
required

Ключ uploadMetaKey, полученный при загрузке чека

string

Example 

mjuikrewfmnrgbhty4ui3okqwmefnbght4yu3irkefjghy4tu38i
amount

Фактически уплаченная сумма, если она отличается от суммы сделки. По умолчанию берётся сумма сделки

number

Example 

500.01

Responses

Заголовок раздела «Responses»

200

Заголовок раздела «200»

Создание спора по сделке

Media typeapplication/json
object
category
required

Категория callback payload

string
Allowed values: trade matching
id
required

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

string
merchantTransactionId
required

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

object
matchingTransactionId

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

object
amount
required

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

number
crypto
required

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

string format: int64
rate
required

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

number
fee
required

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

string format: int64
type
required

Тип сделки

string
Allowed values: pay-in pay-out
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
status
required

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

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

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

object
id
required

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

string
ownerName
required

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

string
firstName

Имя владельца отдельным полем — для банков, которые требуют разделения имени и фамилии

object
lastName

Фамилия владельца отдельным полем — для банков, которые требуют разделения имени и фамилии

object
bank
required

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

string
cardNumber
required

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

string
sbpNumber
required

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

string
link
required

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

string
qrCode
required

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

string
accountNumber
required

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

string
bankBic

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

object
currency
required

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

string
crossBorderCurrency

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

object
paymentPageUrl
required

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

string
dispute
required

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

object
disputeCreatedAt
required

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

object
disputeResolvedAt
required

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

object
disputeMerchantCheckUrl
required

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

object
disputeTraderCheckUrl
required

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

object
disputeTraderFiatAmount
required

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

object
disputeTraderDeclineReason
required

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

object
cancelReason
required

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

object
payerInfo
required

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

object
userAgent

User-Agent браузера или приложения плательщика

string
ip

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

string
userId

Идентификатор клиента в вашей системе

string
fingerprint

Отпечаток устройства или сессии плательщика по стандарту FingerprintJS

string
registeredAt

Дата регистрации клиента в вашей системе: timestamp в миллисекундах, строкой

string
payerBank

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

object
paymentLifetime
required

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

number
createdAt
required

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

string format: date-time
invoicesUrl
required

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

Array<string>
nullable
factFiatAmount

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

number
nullable
tradeIdsAll

ID всех сделок, связанных с matching

Array<string>
tradeIdsSuccess

ID успешных сделок, участвующих в закрытии matching

Array<string>
receiptValidation

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

object
summary
required

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

string
matchingId

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

object
matchingTradeType

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

object

Example 

{
  "category": "trade",
  "id": "9ee42dff-83ec-4a90-8dfb-1fc74d3afbe4",
  "merchantTransactionId": "MERCH-TRX-20240910-00042",
  "matchingTransactionId": "MATCHING-TRX-20240910-00042",
  "amount": 2500,
  "crypto": "124825278",
  "rate": 80.12,
  "fee": "125000",
  "type": "pay-in",
  "method": "account",
  "status": "pending",
  "requisite": {
    "id": "a3c9f2e1-7d44-4c9a-9c21-8bfa11223344",
    "ownerName": "Иван Иванов",
    "firstName": "Иван",
    "lastName": "Иванов",
    "bank": "SBER",
    "cardNumber": "4111111111111111",
    "sbpNumber": "79035554433",
    "link": "https://pay.example.com/transfer/12345",
    "qrCode": "https://cdn.example.com/qrcode/payment.png",
    "accountNumber": "RU02000000000000001234",
    "bankBic": "040702615",
    "currency": "RUB",
    "crossBorderCurrency": "RUB"
  },
  "paymentPageUrl": "https://pay.example.com/external/4b9a1a2c-9c10-4f6b-88aa-77bb66cc55dd",
  "dispute": {
    "disputeCreatedAt": "2024-09-10T10:15:00.000Z",
    "disputeResolvedAt": "2024-09-11T18:40:00.000Z",
    "disputeMerchantCheckUrl": "https://merchant.example.com/disputes/check/aa11bb22",
    "disputeTraderCheckUrl": "https://trader.example.com/disputes/check/cc33dd44",
    "disputeTraderFiatAmount": 1800,
    "disputeTraderDeclineReason": "Платёж не найден в выписке банка",
    "cancelReason": "Истекло время оплаты"
  },
  "payerInfo": {
    "name": "Алексей",
    "phone": "79001234567"
  },
  "payerBank": "ALFA",
  "paymentLifetime": 20,
  "createdAt": "2024-09-10T10:00:00.000Z",
  "invoicesUrl": "https://merchant.example.com/invoices/trade/c2f8a3e1",
  "factFiatAmount": 43650,
  "receiptValidation": {
    "summary": "Требуется ручное решение."
  }
}