از ساخت حساب تا دریافت اولین پرداخت USDT؛ در چند مرحله ساده درگاه خود را راهاندازی کنید و وضعیت تراکنشها را از طریق داشبورد و Webhook پیگیری کنید.
چهار قدم اصلی برای شروع.
حساب مرچنت بسازید و وارد پنل شوید.
از «کلیدهای API» کلید بسازید و همان را در هدر X-API-KEY بفرستید.
درخواست USDT بسازید و کاربر را به payment_url بفرستید.
وضعیت را از وبهوک و پنل دنبال کنید.
مستندات کوتاه، پاسخهای قابل پیشبینی و نمونه درخواست آماده برای تست.
کلید جدید بسازید و همان مقدار را در هدر X-API-KEY بفرستید.
USDT روی ERC20، TRC20 یا BEP20؛ حداقل مبلغ پرداخت در ERC20 برابر ۵۰۰ USDT است و در BEP20 آدرس با 0x شروع میشود. مسیر: POST /api/v1/payment/create
اعلان تأیید به webhook_url میرود، نه به callback_url پرداخت؛ مشتری هم میتواند برای دریافت پیامک، شمارهاش را در صفحه پرداخت ثبت کند.
نمونه اتصال
curl -X POST https://bitpal.pro/api/v1/payment/create \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 100,
"currency": "USDT",
"network": "TRC20",
"order_id": "order_123",
"callback_url": "https://yoursite.com/callback"
}'
$ch = curl_init('https://bitpal.pro/api/v1/payment/create');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'X-API-KEY: ' . getenv('BITPAL_API_KEY'),
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'amount' => 100,
'currency' => 'USDT',
'network' => 'TRC20',
'order_id' => 'order_123',
]),
CURLOPT_RETURNTRANSFER => true,
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
use Illuminate\Support\Facades\Http;
$response = Http::withHeaders([
'X-API-KEY' => config('services.bitpal.api_key'),
])->post('https://bitpal.pro/api/v1/payment/create', [
'amount' => 100,
'currency' => 'USDT',
'network' => 'TRC20',
'order_id' => 'order_123',
]);
$paymentUrl = $response->json('payment_url');
const response = await fetch('https://bitpal.pro/api/v1/payment/create', {
method: 'POST',
headers: {
'X-API-KEY': process.env.BITPAL_API_KEY,
'Content-Type': 'application/json'
},
body: JSON.stringify({
amount: 100,
currency: 'USDT',
network: 'TRC20',
order_id: 'order_123'
})
});
const payment = await response.json();
import os
import requests
response = requests.post(
'https://bitpal.pro/api/v1/payment/create',
headers={'X-API-KEY': os.environ['BITPAL_API_KEY']},
json={
'amount': 100,
'currency': 'USDT',
'network': 'TRC20',
'order_id': 'order_123',
},
)
payment = response.json()
{
"payment_id": "PAY_ABC123XYZ",
"payment_url": "https://bitpal.pro/pay/PAY_ABC123XYZ",
"payment": {
"payment_id": "PAY_ABC123XYZ",
"address": "TXyz1234567890abcdef1234567890abcd",
"status": "pending"
}
}
وضعیت پرداخت و اطلاعات تراکنش را از مسیرهای مشخص دریافت کنید تا سیستم شما بداند پرداخت در چه مرحلهای قرار دارد.
هر مرچنت فقط به دادهها و تراکنشهای حساب خود دسترسی دارد.
اطلاعات پرداخت با ساختار مشخص در اختیار سیستم شما قرار میگیرد.
با Webhook از تغییر وضعیت پرداخت مطلع شوید و وضعیت را در داشبورد نیز مشاهده کنید.
اگر برنامهنویس دارید، مستندات کافی است. اگر ندارید، از پنل و راهنماها جلو بروید.