API

curl -X GET https://id.tokenpay.space/api/v1/users/me \
  -H "Authorization: Bearer tpid_sk_your_secret_key" \
  -H "Content-Type: application/json"

Authorization: Bearer tpid_sk_7f3a9b2ce4d18...

Authorization: Bearer eyJhbGciOiJSUzI1NiIs...

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1678886400

{
  "error": {
    "code": "invalid_token",
    "message": "The access token is invalid or expired",
    "status": 401
  }
}

https://id.tokenpay.space/oauth/authorize?
  client_id=tpid_pk_your_public_key&
  redirect_uri=https://yourapp.com/callback&
  response_type=code&
  scope=profile email&
  state=random_csrf_token

curl -X POST https://id.tokenpay.space/api/v1/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "authorization_code",
    "code": "abc123...",
    "client_id": "tpid_pk_...",
    "client_secret": "tpid_sk_...",
    "redirect_uri": "https://yourapp.com/callback"
  }'

{
  "access_token": "eyJhbGciOiJSUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "tpid_rt_8a7b6c5d...",
  "scope": "profile email",
  "user": {
    "id": "tpid_usr_a1b2c3d4",
    "email": "[email protected]",
    "name": "Иван",
    "email_verified": true
  }
}

{
  "id": "tpid_usr_a1b2c3d4",
  "email": "[email protected]",
  "name": "Иван Чернов",
  "email_verified": true,
  "two_factor_enabled": false,
  "telegram_linked": true,
  "created_at": "2025-01-15T10:30:00Z",
  "last_login": "2026-03-13T09:45:00Z"
}

{
  "sessions": [
    {
      "id": "ses_abc123",
      "device": "Chrome — Windows",
      "ip": "192.168.1.1",
      "location": "Saint Petersburg, RU",
      "last_active": "2026-03-13T12:00:00Z",
      "current": true
    }
  ]
}

{
  "valid": true,
  "user_id": "tpid_usr_a1b2c3d4",
  "email": "[email protected]",
  "scopes": ["profile", "email"],
  "expires_at": 1678886400
}

{
  "event": "user.login",
  "timestamp": "2026-03-13T12:00:00Z",
  "data": {
    "user_id": "tpid_usr_a1b2c3d4",
    "ip": "192.168.1.1",
    "device": "Chrome — Windows"
  }
}

<!-- Контейнер для кнопки -->
<div id="tokenpay-login"></div>

<!-- Подключение SDK -->
<script src="https://tokenpay.space/sdk/tokenpay-auth.js"></script>
<script>
  TokenPayAuth.init({
    clientId: 'tpid_pk_ваш_публичный_ключ',
    redirectUri: 'https://ваш-сайт.com/callback',
    scope: 'profile',
    locale: 'ru',       // 'ru' | 'en'
    theme: 'dark',       // 'dark' | 'light'
    size: 'large',       // 'small' | 'medium' | 'large'
    onSuccess: function(data) {
      console.log('Код авторизации:', data.code);
      // Отправьте data.code на ваш сервер для обмена на токен
    },
    onError: function(err) {
      console.error('Ошибка:', err);
    }
  });

  // Отрисовать кнопку
  TokenPayAuth.renderButton('#tokenpay-login');
</script>

curl -X POST https://tokenpay.space/api/v1/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "authorization_code",
    "code": "tpid_code_...",
    "client_id": "tpid_pk_...",
    "client_secret": "tpid_sk_...",
    "redirect_uri": "https://ваш-сайт.com/callback"
  }'

curl -X GET https://tokenpay.space/api/v1/oauth/userinfo \
  -H "Authorization: Bearer ACCESS_TOKEN"

{
  "id": "tpid_usr_a1b2c3d4e5f6",
  "email": "[email protected]",
  "name": "Иван",
  "email_verified": true,
  "created_at": "2026-01-15T12:00:00Z"
}

pip install tokenpay-id

from tokenpay_id import TokenPayID

client = TokenPayID(
    client_id="tpid_pk_your_public_key",
    client_secret="tpid_sk_your_secret_key"
)

# Verify a user's token
result = client.verify(access_token)
print(result.user_id)  # tpid_usr_...

# Get user profile
user = client.get_user(access_token)
print(user.email)  # [email protected]

# Webhook signature verification
is_valid = client.verify_webhook(
    payload=request.body,
    signature=request.headers["X-TPID-Signature"]
)

go get github.com/tokenpay/id-go

package main

import (
    tpid "github.com/tokenpay/id-go"
)

func main() {
    client := tpid.NewClient(tpid.Config{
        ClientID:     "tpid_pk_your_public_key",
        ClientSecret: "tpid_sk_your_secret_key",
    })

    // Verify token
    result, err := client.Verify(accessToken)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(result.UserID) // tpid_usr_...
}