CChainPay
تسجيل الدخول

البدء السريع: أول إيداع كريبتو لك في 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 في الاستعلام: الـ webhooks غير موقّعة.

3. طابِق عبر واجهة الحالة

curl https://api.chainpay.site/deposit-address/ADDRESS_ID/status
curl https://api.chainpay.site/deposit-address/ADDRESS_ID/transactions

اعتبر الـ webhooks تُسلَّم «مرة واحدة على الأقل» واستخدم هذه النقاط كمصدر للحقيقة.

أمثلة بلغتك

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'];

الخطوات التالية