اگر فنی هستید و یا جزئی از تیمهای فنی اینجا مستندات نحوه اتصال و ارتباط و ساخت پرداخت با ارزدیجیتال در دسترس شماست تا در کمترین زمان ممکن درگاه خود را داشته باشد.
درخواستها و پاسخها ساده و قابلپیشبینی هستند.
احراز هویت با Bearer token و کنترل دسترسی سمت سرور انجام میشود.
نمونهها کوتاه هستند و بهراحتی وارد پروژه میشوند.
هر درخواست باید توکن معتبر داشته باشد.
Authorization: Bearer YOUR_TOKEN
از این endpoint برای ساخت پرداخت و دریافت `payment_url` استفاده میشود.
{
"amount": 100,
"currency": "BTC",
"network": "BTC",
"order_id": "order_123",
"callback_url": "https://yoursite.com/callback",
"description": "خرید محصول X"
}{
"payment_id": "PAY_ABC123XYZ",
"payment_url": "https://bitpal.pro/pay/PAY_ABC123XYZ",
"payment": {
"payment_id": "PAY_ABC123XYZ",
"address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
"status": "pending"
}
}بعد از تایید پرداخت، سیستم رویداد را به `callback_url` شما میفرستد. این درخواست را در سمت سرور اعتبارسنجی کنید.
{
"payment_id": "PAY_ABC123XYZ",
"order_id": "order_123",
"status": "confirmed",
"amount": "0.00150000",
"currency": "BTC",
"tx_hash": "0xabc123..."
}برای هر پرداخت آدرس جدا ساخته میشود.
ثبت حسابداری شفاف برای پیگیری داخلی.
برای سناریوهای حساس، کنترل و بررسی ریسک وجود دارد.
مدیریت نقدینگی و عملیات تسویه بهصورت ساختاریافته.
<?php
$response = Http::withHeaders([
'Authorization' => 'Bearer ' . $apiKey,
])->post('https://api.bitpal.pro/v1/payment/create', [
'amount' => 100,
'currency' => 'BTC',
'network' => 'BTC',
'order_id' => 'order_123',
'callback_url' => 'https://yoursite.com/callback',
]);const response = await fetch('https://api.bitpal.pro/v1/payment/create', {
method: 'POST',
headers: {
Authorization: `Bearer ${apiKey}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
amount: 100,
currency: 'BTC',
network: 'BTC',
order_id: 'order_123',
callback_url: 'https://yoursite.com/callback',
}),
});