Просмотр списка заявок на ввод

Метод запроса

GET

Урл запроса

/v2/merchant/transactions

Параметры запроса

На вход принимаются следующие параметры

Название	Формат	Описание
id	int	Фильтр по идентификатору транзакции
extId	string	Фильтр по идентификатору транзакции клиента
type	string(1-255)	Фильтр по типу операции. Может быть DEPOSIT или WITHDRAWAL
status	string(1-255)	Фильтр по статусу. Могут быть одно или несколько значений через запятую - PENDING, DENIED, SUCCESSFUL
requisite	string(1-255)	Фильтр по реквизиту. Может быть номер карты или номер телефона.
createdAtFrom	string(1-255)	Фильтр по диапазону (начало) по дате создания. Укажите 2024-01-01 для фильтрации транзакций созданных с указанной даты (в часовой зоне мерчанта)
createdAtTo	string(1-255)	Фильтр по диапазону (конец) по дате создания, аналогичен start_created_at
payedAtFrom	string(1-255)	Фильтр по диапазону (начало) по дате оплаты. Укажите 2024-01-01 для фильтрации транзакций оплаченных с указанной даты (в часовой зоне мерчанта)
payedAtTo	string(1-255)	Фильтр по диапазону (конец) по дате оплаты, аналогичен start_payed_at
pageNumber	int	Пагинация. Фильтр по номеру страницы
pageSize	int	Пагинация. Количество записей на странице
sortBy	string(1-255)	Сортировка. Поле, по которому нужно отсортировать. id сверху

Пример запроса

CURL

curl --request GET \
  --url https://{{domain}}/v2/merchants/transactions \
  --header 'Authorization: Bearer {{your_api_token}}' \
  --header 'X-Signature: {{sign}}' \
  -d 'status=SUCCESSFUL'

PHP + GuzzleHttp

$httpClient = new \GuzzleHttp\Client();
$response = $httpClient->get('https://{{domain}}/v2/merchants/transactions', [
    'query' => [
        'status' => 'SUCCESSFULL'
    ],
    'headers' => [
        'Authorization' => 'Bearer ' . $token,
        'X-Signature' => $sign,
    ]
]);

Параметры ответа

Название	Формат	Описание
items[].id	int	Номер транзакции
items[].extId	string(1-255)	Идентификатор транзакции в вашей системе
items[].amount	int	Сумма транзакции
items[].amountInUsdt	string(1-255)	Сумма в USDT, с учетом зафиксированного курса по валюте
items[].currency	string(1-255)	Валюта
items[].currencyRate	string(1-255)	Курс валюты
items[].requisite	string(1-255)	Номер карты или номер телефона
items[].cardNumber	string(1-255)	Номер карты (deprecated). Используйте поле requisite
items[].phoneNumber	string(1-255)	Номер телефона (deprecated). Используйте поле requisite
items[].type	string(1-255)	Тип транзакции, DEPOSIT или WITHDRAWAL
items[].status	string(1-255)	Статус транзакции
items[].createdAt	string(1-255)	Дата создания транзакции
items[].updatedAt	string(1-255)	Дата последнего обновления транзакции
items[].expiresAt	string(1-255)	Срок действия транзакции
items[].commissionInUsdt	string(1-255)	Комиссия системы за обслуживание, в USDT
items[].totalAmountInUsdt	string(1-255)	Общая сумма для зачисления на баланс мерчанта, в USDT
items[].paymentMethod	string(1-255)	Метод проведения транзакции
pageNumber	int	Номер страницы
pageSize	int	Количество записей на странице

Пример ответа

{
  "items": [
     {
      "id": 1557,
      "extId": "testExtId",
      "amount": 4000,
      "amountInUsdt": 43.11,
      "currency": "RUB",
      "currencyRate": 92.79,
      "requisite": "1111111111111111",
      "cardNumber": "1111111111111111",
      "phoneNumber": "[phone]",
      "type": "DEPOSIT",
      "status": "DENIED",
      "createdAt": "2024-08-30T01:18:16",
      "updatedAt": "2024-08-30T01:19:03",
      "expiresAt": "2024-08-30T01:18:57",
      "commissionInUsdt": 4.31,
      "totalAmountInUsdt": 38.8,
      "paymentMethod": "Card"
    }
  ],
  "pageNumber": 1,
  "pageSize": 20
}