Create transaction P2P

POST/v2/transaction/create

Creates a new transaction with the specified parameters.

Headers

Name	Value
Content-Type	application/json
x-api-key	<token>

Body

Поле	Тип	Описание
type	string(required)	Тип платежа: card, sbp, cross, any
fiatAmount	number(required)	min 1500 Cумма платежа в фиате
extID	string(required)	Уникальный ID ордера в системе мерчанта
signature	string(required)	Хеш-подпись авторизации hash('sha256', "extID:fiatAmount:api_key")
client_info	object(required)	Информация о плательщике
client_info.ip	string(required)	IP-адрес плательщика
client_info.userAgent	string(required)	User-Agent браузера плательщика
client_info.userId	number(required)	Уникальный идентификатор плательщика в базе мерчанте
ttl	number	Время жизни ордера (по умолчанию: 900)
currency	string	Валюта по ISO 4217. По умолчанию: RUB
comment	string	Комментарий к платежу
failedRedirectURL	string	URL для редиректа при ошибке
successRedirectURL	string	URL для редиректа при успехе

Пример Body

{
  "type": "card",
  "fiatAmount": 1500,
  "extId": "TX9988776655",
  "signature": "5b7cf6e5d0a0a91ad7b759e0c27d2fcb11c3b1c4e9f4d0caaef7205e3d309ec3",
  "client_info": {
    "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_6_1 like Mac OS X) AppleWebKit/655.1.15 (KHTML, like Gecko) Version/16.4 Mobile/148 Safari/04.1",
    "ip": "123.123.123.123",
    "userId": "84784759879"
  },
  "ttl": 3600,
  "currency": "USD",
  "comment": "Test card payment",
  "failedRedirectURL": "https://example.com/failure",
  "successRedirectURL": "https://example.com/success"
}

Response

201

{
  "message": "Transaction created successfully",
  "data": {
    "id": 123,
    "bank": "vtb",
    "account_details": "[phone]",
    "amount_rubles": 8102,
    "amount_usdt": 79.0039080487168,
    "exchange_rate": 92.7967,
    "expiresAt": "2025-12-31T23:59:59.999Z",
    "paymentMethod": "cross",
    "extId": "example-ext-id"
  }
}

400

401

500