Build on gratitude infrastructure. Three API calls to integrate universal @handles, portable reputation, and cross-platform identity.
The gratitude layer of the internet—managed by TYSM, accessible via API.
We run the infrastructure. You integrate the features.
Works everywhere, right now
https://tysm.to/@aliceStart here. This is the foundation. Everything else is optional.
tysm: URI SchemeNative app integration (optional)
tysm:@alice?amount=10Add when you have a mobile app. Layer 1 still works, this enhances it.
For banks, platforms, and large partners
For banks, platforms, and large partners who want to embed TYSM at scale. TYSM runs and manages the infrastructure—you get dedicated capacity, custom SLAs, and custom branding.
Get your API key at tysm.to/app/developers and start building
https://tysm.to/@yourhandleWorks everywhere: websites, emails, QR codes, social media. Perfect for simple tipping and payment buttons.
tysm.getGratitudeScore()Query reputation data, display trust badges, build conditional logic. Perfect for platforms and integrations.
TLDR: Links are for distribution. The API is for reputation.
Type-safe, easy to use, production-ready
import { TYSM } from '@tysm/sdk';
// Initialize with your API key
const tysm = new TYSM('tysm_live_your_api_key');
// Get gratitude score
const score = await tysm.getGratitudeScore('@daniel');
console.log(`${score.score}/850 - ${score.tier}`);
// "742/850 - GOLD"
// Send gratitude with idempotency (prevents duplicate charges)
const transaction = await tysm.send({
recipient: '@alice',
amount: 1000, // $10.00 in cents
memo: 'Thanks for the coffee!',
idempotencyKey: 'order-123-abc' // Prevents accidental double-sends
});
// { id: 'txn_...', status: 'completed', amount: 1000 }
// Get user profile
const user = await tysm.getUser('@daniel');
console.log(`${user.name} - Verified: ${user.verified}`);
// "Daniel - Verified: true"
// Create payment link
const url = tysm.createPaymentLink('@alice', 500, 'Thanks!');
// "https://tysm.to/@alice?amount=5&memo=Thanks!"Works with any language - just add your API key
// Get gratitude score (requires API key)
const response = await fetch(
'https://tysm.to/api/v1/public/gratitude/@daniel/score',
{
headers: {
'Authorization': 'Bearer tysm_live_your_api_key'
}
}
);
const data = await response.json();
console.log(data);
/*
{
"handle": "daniel",
"score": 742,
"tier": "GOLD",
"totalReceived": 12500,
"totalSent": 8560,
"transactionCount": 156
}
*/Anyone can click and send - guest checkout, no signup required
<!-- Add to any website -->
<a href="https://tysm.to/@alice?amount=10&memo=Thanks">
💙 Send Gratitude
</a>
<!-- Works in email signatures -->
<a href="https://tysm.to/@yourhandle">
tysm.to/@yourhandle
</a>
<!-- QR code content -->
https://tysm.to/@restaurant/sarah?amount=5Prevent duplicate charges with built-in idempotency support on all transaction endpoints.
Use tysm_test_ keys to test without real money. Full feature parity.
Ed25519-signed webhooks with automatic retry and exponential backoff.
Get your API key in 30 seconds
Free: 1,000 req/hour • Pro: 10,000 req/hour • Enterprise: Custom limits
Progressive enhancement. Start simple, add complexity only when needed.
Layer 1 works everywhere with zero setup. Maximum compatibility.
Layer 2 enhances with native apps. Falls back gracefully.
Layer 3 for organizations that need dedicated capacity, custom SLAs, and custom branding.
Complete technical documentation for all three layers
Universal URLs that work everywhere
Native app integration with tysm: protocol
Dedicated infrastructure and custom SLAs for large partners
Sample code and SDK examples
Experience the protocol in action
TYSM is a proprietary protocol and managed infrastructure layer operated by TYSM, Inc. Developers integrate via API, SDKs, and the tysm:// URI—no self-hosting or federation required. We run the infrastructure, you build on top.
Three layers. One managed platform. Built and operated by TYSM, Inc.
Developer APIs • Universal compatibility • Built for integration