Платежі

Історія платежів

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 успішна відповідь досі не описана. Використовуйте список підтримуваних валют вибраного шлюзу.