Getting Started
Q: How do I register as a partner?
Select a plan on the Partner page in the mini app, and your API Key will be issued instantly.
Q: Is there an approval process?
No. It's completely self-service β you can start right away.
Q: Do I need a business registration?
No. Individual developers can sign up too.
Q: Is there a test/sandbox mode?
No separate test mode is available. We recommend testing with small amounts in production.
Plans & Credits
Q: What plans are available?
Three plans: Free, Basic ($80), and Pro ($140). All are one-time payments for lifetime access.
Q: What is monthly credit?
Each plan includes monthly API credits that auto-refill on the 1st:
β’
Free: $1.50/month
β’
Basic: $15/month
β’
Pro: $30/month
Q: What happens when I exceed my credit limit?
A small fee is applied to transactions:
β’
Free/Basic: 1% of transaction amount
β’
Pro: 0.5% of transaction amount
Q: How do I upgrade my plan?
Go to the Partner page in the mini app and pay the price difference. The upgrade takes effect immediately.
Payments
Q: What's the minimum payment amount?
0.000001 USDT (supports up to 6 decimal places)
Q: What's the maximum payment amount?
There's no limit.
Q: How long are payment links valid?
24 hours by default. You can customize this with the expires_in parameter when creating the link.
Q: What if the user doesn't have a PAYchat account?
An account is created automatically when they pay. No extra handling needed on your end.
Q: How do I know when a payment is complete?
A payment.completed webhook event is sent to your configured webhook URL.
Q: Can payments be refunded or cancelled?
Due to the nature of blockchain transactions, payments cannot be reversed after completion.
Withdrawals
Q: How do I send money to a user?
Call POST /api/partner/withdrawals with the user's telegram_id and the amount.
Q: What's the minimum withdrawal amount?
0.000001 USDT (supports up to 6 decimal places)
Q: Are withdrawals processed instantly?
Yes. The funds appear in the user's wallet immediately after the API call.
Q: Does the user receive a notification?
Yes. They automatically receive a Telegram message about the incoming funds.
Fees & Settlement
Q: What are the fees?
No fees within your monthly credit allowance. When credits are depleted, fees are 0.5β1% depending on your plan.
Q: What's the settlement period?
Real-time. Funds are added to your partner balance immediately when a payment completes.
Q: How do I check my partner balance?
Use the GET /api/partner/me API or check the Partner page in the mini app.
Q: How do I add funds to my partner balance?
Tap the "Charge" button in the mini app to deposit USDT.
Webhooks
Q: How do I set up my webhook URL?
Go to Partner page > Webhooks tab in the mini app and enter your URL.
Q: What happens if a webhook fails?
We automatically retry up to 5 times with increasing delays:
Immediately β 1 min β 5 min β 30 min β 2 hours
Q: How do I secure webhooks?
Every webhook includes an HMAC-SHA256 signature in the X-PAYchat-Signature header. Verify it using your Secret Key.
Q: How do I test webhooks?
Go to Partner page > Webhooks tab and click the "Test" button to send a sample payload.
Technical
Q: Which networks are supported?
TRON (TRC-20 USDT) and TON.
Q: Are there API rate limits?
Yes:
β’
Free/Basic: 100 requests/min
β’
Pro: 500 requests/min
Q: Is there an SDK?
Yes! Install our official Node.js SDK:
bash
npm install paychat-sdk
javascript
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'
});
// Send withdrawal
await client.createWithdrawal({
telegramId: '123456789',
amount: 5.00,
memo: 'Reward payout'
});
Q: How do I open the payment screen in a mini app?
Call window.Telegram.WebApp.openTelegramLink(payment_url)
Account Management
Q: I lost my API Key. What do I do?
Go to Partner page > API Keys tab and regenerate your keys. Your old key will be invalidated immediately.
Q: Can I view my Secret Key again?
Yes. Go to Partner page > API Keys tab and click the eye icon to reveal it.
Support
Questions β https://t.me/paychat_group
Start β https://t.me/paychat_aibot?start=partner