Lewati ke konten

Pantau Deposit dan Pembayaran USDT / USDC

Pantau transfer USDT dan USDC yang didukung untuk deposit, notifikasi pedagang, dan pembayaran keluar; notifikasi saja tidak membuktikan penyelesaian akhir.

Untuk pengembang dan AI Agent. Mulai dengan kunci API dan penerima HTTPS Anda; saring kontrak token dan jumlah di aplikasi Anda.

Pemantauan transfer dasar tersedia

Penyaringan jumlah dan token dilakukan di penerima Anda. Kondisi sisi server, konfirmasi beberapa tahap, dan peringatan IM akan segera tersedia.

Sebelum memulai

Pengembang dan AI Agent mengikuti alur integrasi yang sama. Atur BLOCKVECTRA_API_KEY dengan aman dan pasang curl serta jq. Pilih CHAIN dari cakupan di bawah; verifikasi kontrak token, penerima, dan jumlah bilangan bulat dalam unit terkecil. Push memerlukan penerima HTTPS milik Anda pada port 443. Sebelum membuat langganan, periksa daftar chain terautentikasi, rentang konfirmasi, dan status halted.

Lihat panduan pendaftaran terprogram →

Verifikasi deposit bursa

Polling log ERC-20 Transfer untuk alamat deposit. Atur TOKEN_CONTRACT dan RECIPIENT dari konfigurasi tepercaya; FROM_BLOCK dan TO_BLOCK adalah tinggi blok heksadesimal dalam cakupan node dan batas rentang yang dipublikasikan. Majukan kursor persisten hanya setelah memproses tiap rentang.

set -euo pipefail
: "${BLOCKVECTRA_API_KEY:?}" "${CHAIN:?}" "${TOKEN_CONTRACT:?}" "${RECIPIENT:?}"
: "${FROM_BLOCK:?}" "${TO_BLOCK:?}"
TOPIC_TO="0x000000000000000000000000${RECIPIENT#0x}"
jq -n --arg token "$TOKEN_CONTRACT" --arg to "$TOPIC_TO" \
  --arg from "$FROM_BLOCK" --arg end "$TO_BLOCK" \
  '{jsonrpc:"2.0",id:1,method:"eth_getLogs",params:[{address:$token,
    fromBlock:$from,toBlock:$end,topics:[
      "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",null,$to]}]}' |
  curl --fail-with-body -sS "https://api.blockvectra.com/v1/$CHAIN" \
    -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' --data-binary @-

Hasil yang perlu diverifikasi

Cocokkan kontrak, penerima, dan jumlah bilangan bulat; periksa receipt serta kebijakan konfirmasi sebelum mengkreditkan. Deduplicasi berdasarkan chain, transactionHash, dan logIndex; simpan blockHash untuk rekonsiliasi reorganisasi.

Baca panduan lengkap

Terima notifikasi pembayaran pedagang

Atur RECIPIENT dan RECEIVER_URL, lalu buat langganan alamat dasar dengan konfirmasi bawaan chain. Simpan secret dengan aman. Tunggu applied_version >= change_version dan catat applied_from_block sebelum mengharapkan aktivitas yang cocok.

Chain yang didukung

Pilih CHAIN untuk contoh ini dari chain yang saat ini dapat dijalankan di bawah

set -euo pipefail
umask 077
: "${BLOCKVECTRA_API_KEY:?}" "${CHAIN:?}" "${RECIPIENT:?}" "${RECEIVER_URL:?}"
PUSH_URL='https://api.blockvectra.com/v1/push'
curl --fail-with-body -sS "$PUSH_URL/chains" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" > push-chains.json
jq -e --arg chain "$CHAIN" 'any(.chains[]; .chain == $chain and .halted == false)' push-chains.json
jq -n --arg url "$RECEIVER_URL" --arg chain "$CHAIN" \
  '{url: $url, chains: {($chain): {}}}' > create.json
curl --fail-with-body -sS "$PUSH_URL/subscriptions" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -H 'Content-Type: application/json' -d @create.json > subscription.json
SUBSCRIPTION_ID=$(jq -er '.id' subscription.json)
jq -n --arg recipient "$RECIPIENT" '{addresses: [$recipient]}' > addresses.json
curl --fail-with-body -sS "$PUSH_URL/subscriptions/$SUBSCRIPTION_ID/addresses/add" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -H 'Content-Type: application/json' -d @addresses.json > address-change.json
curl --fail-with-body -sS "$PUSH_URL/subscriptions/$SUBSCRIPTION_ID" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

Hasil yang perlu diverifikasi

Peristiwa cocok pertama selesai setelah verifikasi tanda tangan body asli, pemeriksaan token/penerima/jumlah bilangan bulat, deduplikasi persisten berdasarkan id, dan respons 2xx penerima. HTTP 201 langganan bukan notifikasi pembayaran yang telah diterima.

Baca panduan lengkap

Lacak pembayaran keluar

Atur TX_HASH ke transaksi yang sudah dikirim sistem pembayaran. Baca receipt lewat JSON-RPC, bandingkan receipt.blockNumber dengan head saat ini, dan cocokkan log transfer token yang diharapkan.

set -euo pipefail
: "${BLOCKVECTRA_API_KEY:?}" "${CHAIN:?}" "${TX_HASH:?}"
jq -n --arg hash "$TX_HASH" \
  '{jsonrpc:"2.0",id:1,method:"eth_getTransactionReceipt",params:[$hash]}' |
  curl --fail-with-body -sS "https://api.blockvectra.com/v1/$CHAIN" \
    -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' --data-binary @-

Hasil yang perlu diverifikasi

receipt null atau transaksi pending bukan pembayaran diterima. Periksa receipt.status, kontrak token, penerima, jumlah bilangan bulat, serta kebijakan konfirmasi. receipt sukses saja tidak membuktikan transfer yang diharapkan.

Baca panduan lengkap

Batas konfirmasi dan cakupan

N konfirmasi bukan finalitas chain. Push dasar tidak memiliki filter jumlah atau token di server; filter di penerima. Transfer koin native internal kontrak tidak tercakup. Pending bukan pembayaran diterima. Rekonsiliasi blok yang diganti pada chain.reorg dan proses pengganti kanonis secara idempoten. Beberapa chain tidak mencakup transaksi sistem; lihat halaman chain terkait.

Pulihkan celah dan rekonsiliasi riwayat

Replay hanya mengirim ulang kecocokan yang tersimpan; tidak memulihkan riwayat sebelum langganan atau alamat aktif. Gunakan polling RPC berbatas untuk interval sebelumnya atau celah. Simpan kursor per chain dan rekonsiliasi reorganisasi dengan panduan lengkap.

Baca panduan lengkap

Opsional, kueri transfer ERC-20 terindeks pada chain berikut. FROM_BLOCK dan TO_BLOCK adalah tinggi blok desimal dalam cakupan indeks. Periksa kebaruan dan cakupan; ikuti next_cursor hingga tidak ada. Verifikasi kontrak, penerima, dan jumlah bilangan bulat; data indeks bukan bukti finalitas.

: "${BLOCKVECTRA_API_KEY:?}" "${CHAIN:?}" "${RECIPIENT:?}" "${FROM_BLOCK:?}" "${TO_BLOCK:?}"
curl --fail-with-body -sS --get \
  "https://api.blockvectra.com/v1/data/$CHAIN/addresses/$RECIPIENT/transfers" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  --data-urlencode 'standard=erc20' --data-urlencode 'direction=in' \
  --data-urlencode "from_block=$FROM_BLOCK" --data-urlencode "to_block=$TO_BLOCK"
Baca panduan lengkap

Harga & Aturan Penagihan

Bobot metode eth_getLogs: 30 CU ($3.00 per 1,000,000 permintaan).

Permintaan yang ditolak oleh layanan (seperti rentang blok berlebih atau batas laju) tidak ditagih. Lihat panduan aturan penagihan atau tabel harga lengkap.

Push webhook

Bobot CU dari GET /v1/plans. Percobaan ulang otomatis gratis.

Alamat gratis per akun per hari UTC: 1000

Kuota alamat gratis per akun per hari UTC dibagikan oleh semua grup langganan, terlepas dari paketnya. Untuk setiap grup, hitung jumlah alamat maksimum selama online pada hari tersebut; alokasikan kuota menurut ID grup secara menaik. Alamat yang sama dalam dua grup dihitung dua kali; jumlah chain dalam grup tidak melipatgandakan jumlah alamatnya. Grup yang offline atau dihapus sepanjang hari tidak menambah hitungan. Untuk setiap grup, jumlah yang tersisa setelah dikurangi bagiannya dari kuota dikalikan dengan bobot CU `push.address_day` dalam `method_weights`. Kuota yang dikonfigurasi saat ini berasal dari kebijakan harga yang sama dengan biaya alamat-hari; ini bukan batas kapasitas akun atau kuota terpisah per grup.

MetodeUnit penagihanCU
push.address_dayHari alamat yang ditagih33
push.historyPermintaan riwayat berhasil25
push.logPeristiwa data terkirim150
push.native_transferPeristiwa data terkirim150
push.token_transferPeristiwa data terkirim150

Mulai Memantau