Платежи

История платежей

GET /payments возвращает первую страницу. Для периода и пагинации используйте POST /payments:

{
  "from": "2026-07-01T00:00:00Z",
  "to": "2026-07-31T23:59:59Z",
  "page": 1,
  "pageSize": 100
}

Официальный SDK

JavaScript

const payments = await client.payments.filter({
  body: {
    from: '2026-08-01T00:00:00Z',
    to: '2026-08-31T23:59:59Z',
    page: 1,
    pageSize: 100,
  },
});

Python

from datetime import datetime, timezone

from ltesocks_sdk.models import FilterPaymentsBody

payments = client.payments.filter(
    body=FilterPaymentsBody(
        from_=datetime(2026, 8, 1, tzinfo=timezone.utc),
        to=datetime(2026, 8, 31, 23, 59, 59, tzinfo=timezone.utc),
        page=1,
        page_size=100,
    )
)

PHP

<?php

use LTESocks\Dto\FilterPortLogRequest;

$payments = $client->payments()->filter(new FilterPortLogRequest([
    'from' => new DateTime('2026-08-01T00:00:00Z'),
    'to' => new DateTime('2026-08-31T23:59:59Z'),
    'page' => 1,
    'pageSize' => 100,
]));

Запись истории может содержать дату, статус success или failed, связанный порт, сумму со знаком в центах, баланс на момент события и описание. Храните деньги целыми числами и не переводите центы через арифметику с плавающей точкой.

Платёжные шлюзы и checkout

Вызовите GET /payments/gateways и выберите шлюз из data. Передавайте полученный id как gateway_id. Для криптовалютного шлюза выбирайте поддерживаемую currency из его currencies.

Запишите ID выбранного шлюза в GATEWAY_ID. Пример создаёт запрос на 100 USD (10000 центов); добавляйте currency, только если выбранный криптовалютный шлюз её поддерживает.

curl 'https://api.ltesocks.io/v2/payments/gateways' \
  -H "Authorization: Bearer ${LTESOCKS_API_TOKEN}"

curl -X POST 'https://api.ltesocks.io/v2/payments/request' \
  -H "Authorization: Bearer ${LTESOCKS_API_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data "{\"amount\":10000,\"gateway_id\":\"${GATEWAY_ID}\"}"

Ответ содержит data.checkout_url. Направьте клиента по этому адресу для оплаты; создание checkout-запроса ещё не означает завершение платежа. Контракт не гарантирует идемпотентность повторного создания платёжного запроса: при неопределённом результате проверьте состояние транзакции перед новым запросом.

Проверьте транзакцию

Запишите идентификатор транзакции из вашего платёжного процесса в TRANSACTION_ID:

curl "https://api.ltesocks.io/v2/payments/$TRANSACTION_ID" \
  -H "Authorization: Bearer ${LTESOCKS_API_TOKEN}"

curl "https://api.ltesocks.io/v2/payments/$TRANSACTION_ID/timeline" \
  -H "Authorization: Bearer ${LTESOCKS_API_TOKEN}"

GET /payments/{transaction_id} возвращает данные транзакции, а /timeline — историю её событий. Проверьте документированный ответ перед тем, как считать оплату завершённой. См. шлюзы, checkout-запросы и данные транзакции.

Для GET /payments/currencies успешный ответ по-прежнему не описан. Используйте список поддерживаемых валют выбранного шлюза.