CChainPay
Anmelden

Quickstart: Ihre erste Krypto-Einzahlung in 5 Minuten

Sie brauchen eine Wallet-Adresse, die Sie kontrollieren, und eine öffentliche URL für den Webhook. Keine Registrierung, kein API-Key.

1. Einzahlungsadresse erstellen

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"
  }'

Die Antwort enthält id und address. Zeigen Sie address dem Zahler. Derselbe Request liefert dieselbe Adresse, Wiederholungen sind daher sicher.

2. Webhook empfangen

Erreicht die Einzahlung die Bestätigungsschwelle (19 auf TRON), sendet ChainPay einen POST mit status: "confirmed" an Ihre callbackUrl. Danach wird das Guthaben abzüglich Gebühr an Ihre forwardAddress weitergeleitet. Prüfen Sie den token im Query-String selbst: Webhooks sind nicht signiert.

3. Mit der Status-API abgleichen

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

Behandeln Sie Webhooks als „mindestens einmal“ und nutzen Sie diese Endpunkte als Quelle der Wahrheit.

Beispiele in Ihrer Sprache

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

Nächste Schritte