Quickstart: ฝากคริปโตครั้งแรกใน 5 นาที
คุณต้องมีที่อยู่กระเป๋าที่คุณควบคุมเอง และ URL สาธารณะที่รับ webhook ได้ ไม่ต้องลงทะเบียนและไม่ต้องใช้ API key
1. สร้างที่อยู่ฝากเงิน
curl -X POST https://api.chainpay.site/deposit-address \
-H 'content-type: application/json' \
-d '{
"ticker": "trc20/usdt",
"callbackUrl": "https://your-service.example.com/webhook?token=your-secret",
"forwardAddress": "TYourOwnTronWallet...",
"externalReference": "order-123"
}'
คำตอบมี id และ address ให้แสดง address แก่ผู้จ่าย การส่งคำขอเดิมซ้ำจะได้ที่อยู่เดิม จึงลองใหม่ได้อย่างปลอดภัย
2. รับ webhook
เมื่อการฝากถึงเกณฑ์การยืนยัน (19 บน TRON) ChainPay จะส่ง POST ที่มี status: "confirmed" ไปยัง callbackUrl ของคุณ จากนั้นเงินจะถูกส่งไปที่ forwardAddress หลังหักค่าธรรมเนียม โปรดตรวจค่า token ใน query ด้วยตนเอง เพราะ webhook ไม่มีลายเซ็น
3. ตรวจสอบกับ status API
curl https://api.chainpay.site/deposit-address/ADDRESS_ID/status
curl https://api.chainpay.site/deposit-address/ADDRESS_ID/transactions
ให้ถือว่า webhook ส่ง «อย่างน้อยหนึ่งครั้ง» และใช้ endpoint เหล่านี้เป็นแหล่งข้อมูลที่เชื่อถือได้
ตัวอย่างในภาษาของคุณ
Node.js
const res = await fetch('https://api.chainpay.site/deposit-address', {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({
ticker: 'trc20/usdt',
callbackUrl: 'https://your-service.example.com/webhook?token=your-secret',
forwardAddress: 'TYourOwnTronWallet...',
externalReference: 'order-123',
}),
});
const { id, address } = await res.json();
Python
import requests
r = requests.post("https://api.chainpay.site/deposit-address", json={
"ticker": "trc20/usdt",
"callbackUrl": "https://your-service.example.com/webhook?token=your-secret",
"forwardAddress": "TYourOwnTronWallet...",
"externalReference": "order-123",
})
address = r.json()["address"]
PHP
$ch = curl_init('https://api.chainpay.site/deposit-address');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode([
'ticker' => 'trc20/usdt',
'callbackUrl' => 'https://your-service.example.com/webhook?token=your-secret',
'forwardAddress' => 'TYourOwnTronWallet...',
'externalReference' => 'order-123',
]),
]);
$address = json_decode(curl_exec($ch), true)['address'];