مسیر کوتاه است: کلید میگیرید، پرداخت میسازید، وضعیت را از وبهوک و داشبورد میبینید.
چهار قدم اصلی برای شروع.
حساب مرچنت بسازید و وارد پنل شوید.
از «کلیدهای API» کلید بسازید و همان را در هدر X-API-KEY بفرستید.
درخواست USDT بسازید و کاربر را به payment_url بفرستید.
وضعیت را از وبهوک و پنل دنبال کنید.
سه کار اصلی برای اتصال
کلید جدید بسازید و همان مقدار را در هدر X-API-KEY بفرستید.
USDT روی ERC20، TRC20 یا BEP20. در BEP20 آدرس با 0x شروع میشود. مسیر: POST /api/v1/payment/create
اعلان تأیید به webhook_url میرود، نه به callback_url پرداخت؛ مشتری هم میتواند برای دریافت پیامک، شمارهاش را در صفحه پرداخت ثبت کند.
{
"amount": 100,
"currency": "USDT",
"network": "TRC20",
"order_id": "order_123",
"callback_url": "https://yoursite.com/callback",
"description": "خرید محصول X",
"customer_phone": "09123456789"
}{
"payment_id": "PAY_ABC123XYZ",
"payment_url": "https://bitpal.pro/pay/PAY_ABC123XYZ",
"payment": {
"payment_id": "PAY_ABC123XYZ",
"address": "TXyz1234567890abcdef1234567890abcd",
"status": "pending"
}
}خروجیهایی که در کار روزمره به آنها نیاز دارید.
هر مرچنت فقط دادههای خودش را میبیند.
ساختار خروجی عوض نمیشود؛ اتصال و تست سادهتر است.
تأیید پرداخت از وبهوک میآید، در داشبورد دیده میشود و در صورت ثبت شماره مشتری، پیامک هم ارسال میشود.
اگر برنامهنویس دارید، مستندات کافی است. اگر ندارید، از پنل و راهنماها جلو بروید.