Documentation

npm install paychat-sdk

import PAYchatClient from 'paychat-sdk'; const client = new PAYchatClient('pk_your_api_key'); // Create payment const payment = await client.createPayment({ amount: 10, description: 'Limited Edition T-Shirt' }); console.log(payment.payment.payment_url);

X-API-Key: pk_your_api_key_here

curl https://paychat.me/api/partner/balance \ -H "X-API-Key: pk_abc123..."

{ "success": false, "error": { "code": "RATE_LIMIT_EXCEEDED", "message": "Too many requests. Please retry later." } }

curl -X POST https://paychat.me/api/partner/payments \ -H "X-API-Key: pk_your_key" \ -H "Content-Type: application/json" \ -d '{ "amount": 29.99, "description": "Limited Edition T-Shirt", "metadata": { "user_id": "user_123", "item": "tshirt_black_L" } }'

{ "success": true, "payment": { "id": "pay_abc123xyz", "link_id": "x7k2m9", "amount": 29.99, "currency": "USDT", "description": "Limited Edition T-Shirt", "status": "pending", "payment_url": "https://t.me/paychat_aibot?start=x7k2m9", "expires_at": "2025-01-08T12:00:00.000Z", "metadata": { "user_id": "user_123", "item": "tshirt_black_L" }, "created_at": "2025-01-07T12:00:00.000Z" } }

curl https://paychat.me/api/partner/payments/x7k2m9 \ -H "X-API-Key: pk_your_key"

{ "success": true, "payment": { "id": "x7k2m9", "amount": 29.99, "currency": "USDT", "description": "Limited Edition T-Shirt", "status": "completed", "payer": { "telegram_id": "987654321" }, "paid_at": "2025-01-07T12:30:00.000Z", "created_at": "2025-01-07T12:00:00.000Z" } }

curl -X POST https://paychat.me/api/partner/withdrawals \ -H "X-API-Key: pk_your_key" \ -H "Content-Type: application/json" \ -d '{ "telegram_id": "123456789", "amount": 10.00, "memo": "Referral bonus - Thanks!" }'

{ "success": true, "withdrawal": { "id": "wd_xyz789abc", "telegram_id": "123456789", "amount": 10.00, "status": "completed", "created_at": "2025-01-07T12:00:00.000Z" } }

{ "success": true, "balance": { "available": 1250.50, "currency": "USDT", "total_holdings": 5500.00, "referral_holdings": 2500.00 } }

{ "success": true, "deposit": { "address": "TXxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "network": "TRON (TRC20)", "currency": "USDT", "memo": "partner_abc123", "note": "Include the memo when sending to identify your deposit" } }

curl "https://paychat.me/api/partner/transactions?type=payment&limit=10" \ -H "X-API-Key: pk_your_key"

{ "success": true, "transactions": [ { "id": 1, "type": "payment", "telegram_id": "123456789", "amount": 29.99, "status": "completed", "created_at": "2025-01-07T12:00:00.000Z" }, { "id": 2, "type": "withdraw", "telegram_id": "987654321", "amount": 10.00, "status": "completed", "created_at": "2025-01-07T11:30:00.000Z" } ], "pagination": { "total": 156, "limit": 10, "offset": 0 } }

curl -X PUT https://paychat.me/api/partner/webhook \ -H "X-API-Key: pk_your_key" \ -H "Content-Type: application/json" \ -d '{"webhook_url": "https://your-server.com/webhooks/paychat"}'

curl -X POST https://paychat.me/api/partner/webhook-test \ -H "X-API-Key: pk_your_key"

{ "event": "payment.completed", "data": { "payment_id": "x7k2m9", "amount": 29.99, "payer": { "telegram_id": "987654321" } }, "created_at": "2025-01-07T12:00:00.000Z" }

{ "event": "withdraw.completed", "data": { "withdrawal_id": "wd_xyz789", "telegram_id": "123456789", "amount": 10.00, "memo": "Referral bonus" }, "created_at": "2025-01-07T12:00:00.000Z" }

X-PAYchat-Signature: t=1704628800,v1=abc123def456...

const crypto = require('crypto'); function verifyWebhook(payload, signatureHeader, secretKey) { // Parse the signature header const [tPart, v1Part] = signatureHeader.split(','); const timestamp = tPart.replace('t=', ''); const signature = v1Part.replace('v1=', ''); // Recreate the signed message const message = `${timestamp}.${JSON.stringify(payload)}`; // Calculate expected signature const expected = crypto .createHmac('sha256', secretKey) .update(message) .digest('hex'); // Compare signatures return signature === expected; } // In your webhook handler app.post('/webhooks/paychat', (req, res) => { const isValid = verifyWebhook( req.body, req.headers['x-paychat-signature'], process.env.PAYCHAT_SECRET_KEY ); if (!isValid) { return res.status(401).send('Invalid signature'); } // Process the webhook... res.status(200).send('OK'); });

{ "success": false, "error": { "code": "ERROR_CODE", "message": "Human readable description" } }

{ "success": false, "error": { "code": "INVALID_API_KEY", "message": "API Key is required" } }

{ "success": false, "error": { "code": "INSUFFICIENT_BALANCE", "message": "Insufficient balance" } }

npm install paychat-sdk

import PAYchatClient from 'paychat-sdk'; const client = new PAYchatClient('pk_your_api_key'); // Create payment const payment = await client.createPayment({ amount: 29.99, description: 'Limited Edition Hoodie', metadata: { user_id: '123' } }); // Send withdrawal const withdrawal = await client.createWithdrawal({ telegramId: '123456789', amount: 5.00, memo: 'Referral bonus' }); // Check balance const balance = await client.getBalance(); // Verify webhook const isValid = PAYchatClient.verifyWebhook(payload, signature, 'sk_your_secret_key');

const axios = require('axios'); const paychat = axios.create({ baseURL: 'https://paychat.me/api/partner', headers: { 'X-API-Key': process.env.PAYCHAT_API_KEY, 'Content-Type': 'application/json' } });

async function createPayment(amount, description, metadata = {}) { try { const { data } = await paychat.post('/payments', { amount, description, metadata, idempotency_key: `pay_${Date.now()}_${Math.random()}` }); console.log('Payment URL:', data.payment.payment_url); return data.payment; } catch (error) { console.error('Error:', error.response?.data?.error?.message); throw error; } } // Usage const payment = await createPayment(29.99, 'Limited Edition Hoodie', { user_id: '123' });

async function sendReward(telegramId, amount, memo) { try { const { data } = await paychat.post('/withdrawals', { telegram_id: telegramId, amount, memo }); console.log(`Sent $${amount} to ${telegramId}`); return data.withdrawal; } catch (error) { if (error.response?.data?.error?.code === 'INSUFFICIENT_BALANCE') { console.error('Not enough balance! Please deposit more funds.'); } throw error; } } // Usage await sendReward('123456789', 5.00, 'Thanks for your referral!');

const express = require('express'); const crypto = require('crypto'); const app = express(); app.use(express.json()); app.post('/webhooks/paychat', (req, res) => { // Verify signature const signature = req.headers['x-paychat-signature']; if (!verifySignature(req.body, signature)) { return res.status(401).send('Invalid signature'); } // Handle events const event = req.headers['x-paychat-event']; switch (event) { case 'payment.completed': handlePayment(req.body.data); break; case 'withdraw.completed': handleWithdrawal(req.body.data); break; } res.status(200).send('OK'); }); function handlePayment(data) { console.log(`💰 Payment received!`); console.log(` Amount: $${data.amount}`); console.log(` From: ${data.payer.telegram_id}`); // Update your database, send confirmation email, etc. } function handleWithdrawal(data) { console.log(`✅ Withdrawal completed!`); console.log(` Amount: $${data.amount}`); console.log(` To: ${data.telegram_id}`); } function verifySignature(payload, header) { const [t, v1] = header.split(','); const timestamp = t.replace('t=', ''); const signature = v1.replace('v1=', ''); const message = `${timestamp}.${JSON.stringify(payload)}`; const expected = crypto .createHmac('sha256', process.env.PAYCHAT_SECRET_KEY) .update(message) .digest('hex'); return signature === expected; } app.listen(3000);

curl -X POST https://paychat.me/api/partner/regenerate-key \ -H "X-API-Key: pk_your_current_key"