Payments

Payment history

GET /payments returns the first page. Use POST /payments for a time range and pagination:

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

Official 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,
]));

Each history record can include date, success or failed status, related port, signed amount in cents, balance at the time of the event, and a description. Keep monetary values as integers; do not convert cents through floating-point arithmetic.

Payment gateways and checkout

Call GET /payments/gateways and select a gateway from data. Use its returned id as gateway_id. For crypto gateways, select a supported currency from the gateway’s currencies.

Set GATEWAY_ID to the selected ID. This example requests 100 USD (10000 cents); include currency only when the selected crypto gateway supports it.

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}\"}"

The response contains data.checkout_url. Send the customer to that URL to complete checkout; creating a checkout request does not establish that payment has completed. The contract does not promise idempotent payment-request retries: after an uncertain result, check transaction state before creating another request.

Inspect a transaction

Use the transaction identifier from your payment flow for 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} returns transaction details; /timeline returns its event history. Inspect the documented response before treating the payment as complete. See gateways, checkout requests, and transaction details.

GET /payments/currencies still has no documented successful response. Use the selected gateway’s supported currencies.