Tyxo Pay API

curl https://api.tyxo.app/v1/getMe \
  -H "Tyxo-Api-Token: ВАШ_ТОКЕН"

const response = await fetch('https://api.tyxo.app/v1/getMe', {
  headers: { 'Tyxo-Api-Token': process.env.TYXO_TOKEN },
});
const { ok, result, error } = await response.json();

import os, requests

response = requests.get(
    "https://api.tyxo.app/v1/getMe",
    headers={"Tyxo-Api-Token": os.environ["TYXO_TOKEN"]},
)
print(response.json())

{ "ok": true, "result": { ... } }

{ "ok": false, "error": { "code": 400, "name": "AMOUNT_INVALID" } }

{
  "app_id": "6c1f6c1e-6c4e-4c79-9d63-1f2a0b7d9c11",
  "name": "Мой магазин",
  "webhook_url": "https://shop.example/tyxo",
  "transfers_enabled": false
}

[
  { "asset": "TON", "available": "128.4512" },
  { "asset": "USDT", "available": "214.5" }
]

curl https://api.tyxo.app/v1/createInvoice \
  -H "Tyxo-Api-Token: ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  -d '{"asset":"USDT","amount":"25","description":"Заказ №42","payload":"order-42"}'

const response = await fetch('https://api.tyxo.app/v1/createInvoice', {
  method: 'POST',
  headers: { 'Tyxo-Api-Token': process.env.TYXO_TOKEN, 'Content-Type': 'application/json' },
  body: JSON.stringify({ asset: 'USDT', amount: '25', description: 'Заказ №42', payload: 'order-42' }),
});
const { result: invoice } = await response.json();
console.log(invoice.pay_url);

import os, requests

invoice = requests.post(
    "https://api.tyxo.app/v1/createInvoice",
    headers={"Tyxo-Api-Token": os.environ["TYXO_TOKEN"]},
    json={"asset": "USDT", "amount": "25", "description": "Заказ №42", "payload": "order-42"},
).json()["result"]
print(invoice["pay_url"])

{
  "transfer_id": "f3b0c2a4-1d2e-4c5b-9a8f-6e7d5c4b3a21",
  "user_id": "123456789",
  "asset": "USDT",
  "amount": "5",
  "spend_id": "cashback-2026-10-15-77"
}

{
  "invoice_id": "0b6f3e2a-8c1d-4f5e-9a7b-2c3d4e5f6a7b",
  "hash": "Vj3kQ9xZp2LmN7aB4cD8eF",
  "status": "active",
  "asset": "USDT",
  "amount": "25",
  "fee": "0.125",
  "description": "Заказ №42",
  "payload": "order-42",
  "pay_url": "https://t.me/tyxobot?start=i_Vj3kQ9xZp2LmN7aB4cD8eF",
  "created_at": "2026-10-15T12:00:00.000Z",
  "paid_at": null
}

{
  "update_id": 1042,
  "update_type": "invoice_paid",
  "request_date": "2026-10-15T12:03:41.512Z",
  "payload": { Invoice со статусом "paid" }
}

import { createHash, createHmac, timingSafeEqual } from 'node:crypto';

export function isSignedByTyxo(rawBody, signature, token) {
  const key = createHash('sha256').update(token).digest();
  const expected = createHmac('sha256', key).update(rawBody).digest('hex');
  return typeof signature === 'string'
    && signature.length === expected.length
    && timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
}

app.post('/tyxo', express.raw({ type: 'application/json' }), (request, response) => {
  if (!isSignedByTyxo(request.body, request.get('tyxo-api-signature'), process.env.TYXO_TOKEN)) {
    return response.sendStatus(401);
  }
  const update = JSON.parse(request.body);
  response.sendStatus(200);
});

import hashlib, hmac, os

def is_signed_by_tyxo(raw_body: bytes, signature: str, token: str) -> bool:
    key = hashlib.sha256(token.encode()).digest()
    expected = hmac.new(key, raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature or "")

@app.post("/tyxo")
def tyxo_webhook():
    if not is_signed_by_tyxo(request.get_data(), request.headers.get("Tyxo-Api-Signature"), os.environ["TYXO_TOKEN"]):
        return "", 401
    update = request.get_json()
    return "", 200