SDK Pemecahan Masalah Integrasi

Mulailah dengan lingkungan, stempel waktu, dan pengidentifikasi bisnis untuk operasi yang gagal. Pemeriksaan terstruktur biasanya memisahkan masalah konfigurasi dari masalah autentikasi, jaringan, dan pemrosesan asinkron.

Urutan diagnostik yang direkomendasikan

Konfirmasikan lingkungan dan pangkalan yang terkena dampak URL.
Catat rentang waktu UTC dan permintaan pertama yang gagal.
Identifikasi modul: Trading Widget, Agent SDK, REST API, WebSocket, atau webhook.
Catat ID permintaan, ID pengguna mitra, agentOrderNo, ID pesanan, atau webhook ID peristiwa.
Periksa kode terbaru, kredensial, IP daftar putih, atau perubahan penerapan.
Reproduksi dengan test case terkecil yang aman.

Gejala	Kemungkinan penyebabnya	Memperbaiki
iframe meminta domain lokal mitra	baseUrl tidak ada	Lulus baseUrl: ‘https://app.6mm.com’.
iframe tidak terlihat atau sangat pendek	Wadah induk tidak memiliki ketinggian	Tetapkan tinggi wadah atau tinggi lintasan.
token_provider_missing	mode token mitra tidak memiliki penyedia	Tambahkan autentikasi.tokenProvider.
auth_exchange_failed	Token penyematan tidak valid, kedaluwarsa, atau tidak cocok	Periksa respons token backend dan channelId.

Agent SDK masalah

Gejala	Kemungkinan penyebabnya	Memperbaiki
Tanda tangan ditolak	Rahasia salah, jam melayang, atau bidang yang ditandatangani diubah secara manual	Biarkan SDK menghasilkan bidang penandatanganan dan menyinkronkan waktu server.
Risiko perpindahan dana duplikat	Nomor pesanan baru digunakan setelah batas waktu habis	Kueri berdasarkan agentOrderNo asli terlebih dahulu.
PROCESSING dianggap gagal	Status yang tertunda disalahpahami	Tunggu webhook atau hubungi queryOrder.
Webhook diproses beberapa kali	Coba lagi perilaku tanpa idempotensi	Tambahkan kunci idempotensi dan pemeriksaan keadaan akhir.

Bukti untuk ditangkap

Integrasi	Bukti yang berguna
Trading Widget	Jalur versi halaman URL, SDK, konsol browser, permintaan jaringan yang gagal, `onError` payload, dan dimensi kontainer.
Agent SDK	SDK bahasa/versi, basis URL, UTC stempel waktu, ID permintaan, `agentOrderNo`, kode respons, dan log yang dibersihkan.
Webhook	Waktu pengiriman, peristiwa atau kunci bisnis, hasil validasi tanda tangan, status pemrosesan, dan hash tubuh mentah yang dibersihkan.
REST API	Metode, jalur, lingkungan, ID permintaan, kode respons, dan parameter yang dibersihkan.

Jangan pernah menyertakan kata sandi, token akses, API rahasia, tanda tangan lengkap, kunci pribadi, atau data pribadi yang tidak disunting dalam diagnostik.

Sebelum meningkat

Coba lagi hanya ketika operasi didokumentasikan aman untuk dicoba lagi.
Setelah waktu habis, tanyakan pengidentifikasi bisnis asli alih-alih membuat yang baru.
Konfirmasikan jam sistem dan lingkungan kredensial untuk kesalahan tanda tangan.
Pertahankan kegagalan pertama dan hasil percobaan ulang selanjutnya.
Gunakan Templat Permintaan Dukungan untuk mengirimkan laporan yang lengkap dan telah disunting.

Dokumen terkait

Trading Widget Mulai Cepat

Verifikasi pemuatan skrip, ukuran kontainer, konfigurasi, dan panggilan balik.

Rahasia & Penandatanganan

Periksa Agent SDK kredensial, jam, dan bidang yang ditandatangani.

Webhooks & Idempotensi

Tinjau verifikasi panggilan balik dan penanganan peristiwa duplikat.

Java diagnostik v0.3.0

Gejala	Periksa dan pemulihan
Permintaan pendanaan memiliki hasil yang tidak diketahui	Simpan `agentOrderNo` yang asli; panggil `queryWalletTransfer` dengan lingkungan aslinya. Jangan gunakan `queryOrder`.
Simulasi UI menunjukkan dana tak terduga	Periksa frontend `tradingMode` secara terpisah dari backend `environment`; akun `isSimulatedUser` tidak merutekan permintaan.
Kesalahan kueri `6905`	Mundur menggunakan kuota mitra bersama, lalu coba lagi kursor yang sama dan filter melalui SDK.
Kesalahan kueri `6904`	Kurangi kueri bersamaan dan persempit jangka waktu; hubungi dukungan jika terus-menerus.
Kursor tidak valid atau kedaluwarsa	Mulai ulang jendela riwayat tetap yang sama dan hapus duplikat catatan yang disimpan.
Metode Java baru tidak ada	Periksa artefak Maven yang terselesaikan terhadap tag publik `v0.3.0`; hapus dependensi yang bertentangan sesuai dengan kebijakan artefak Anda.

Referensi kueri dan kesalahan · Panduan peningkatan

Webhook menerima masalah

Gejala	Periksa dan penanganannya
Tidak ada percobaan ulang setelah kembali gagal JSON	Periksa apakah titik akhir masih mengembalikan HTTP 200. Pengiriman hanya menggunakan status HTTP, bukan indikator keberhasilan di isi.
Percobaan ulang dilanjutkan setelah 401 atau 409	Respons non-2xx mengikuti kebijakan percobaan ulang yang ada; menyelidiki tanda tangan, konten pemberitahuan, atau konfigurasi pedagang.
Kunci idempotensi kosong untuk peringatan likuidasi	`WebhookVerifier.idempotencyKey` saat ini hanya mengekstrak identitas peristiwa dana. Setelah pemeriksaan tanda tangan dan kepemilikan, validasi `notificationId` dan buat kunci peringatan dalam kode pedagang. Jangan pernah menggunakan kunci kosong.
Pemberitahuan duplikat setelah pemrosesan berhasil	Pertahankan deduplikasi dalam cakupan pedagang dan `environment`. Kembalikan 2xx untuk duplikat yang identik; rekam konflik dan kembalikan non-2xx untuk ID yang sama dengan isi yang berbeda.
Peringatan tidak diproses	Terima `liquidation.warning` dan `LIQUIDATION_WARNING` historis; jangan mengelompokkan ID notifikasi yang berbeda berdasarkan pengguna, episode, atau jenis acara dan membuangnya.
Notifikasi yang diterima akan kehilangan tugasnya yang tertunda	Simpan tugas dengan andal sebelum mengembalikan 2xx; memulai tugas asinkron dalam memori tidaklah cukup.

Bidang acara dan kompatibilitas · HTTP tanggapan dan pengakuan yang dapat diandalkan