CChainPay
ログイン

クイックスタート：5 分で最初の暗号資産入金

ご自身で管理するウォレットアドレスと、webhook を受け取れる公開 URL が必要です。登録も 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 を受け取る

入金が承認数のしきい値（TRON では 19）に達すると、ChainPay は callbackUrl に status: "confirmed" を含む POST を送信します。その後、手数料を差し引いた資金が forwardAddress に送られます。クエリの token の値はご自身で検証してください。webhook には署名がありません。

3. ステータス API で照合する

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

webhook は「少なくとも 1 回」届くものとして扱い、これらのエンドポイントを正とみなしてください。

お使いの言語での例

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

次のステップ