Keamanan & Operasi

Pemecahan Masalah Integrasi SDK

Diagnosis masalah Trading Widget, Agent SDK, penandatanganan, webhook, timeout, dan lingkungan sebelum mengeskalasi permintaan dukungan.
View as Markdown

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

Urutan diagnostik yang direkomendasikan

  1. Konfirmasi lingkungan yang terdampak dan URL dasar.
  2. Catat rentang waktu UTC dan permintaan pertama yang gagal.
  3. Identifikasi modul: Trading Widget, Agent SDK, REST API, WebSocket, atau webhook.
  4. Tangkap ID permintaan, ID pengguna mitra, agentOrderNo, ID pesanan, atau ID event webhook.
  5. Periksa kode terbaru, kredensial, IP whitelist, atau perubahan deployment.
  6. Perbanyak dengan kasus uji aman terkecil.

Trading Widget masalah

GejalaPenyebab yang mungkinMemperbaiki
iframe meminta domain lokal mitrabaseUrl hilangPass baseUrl: ā€˜https://app.6mm.comā€™.
iframe tidak terlihat atau sangat pendekKontainer induk tidak memiliki tinggiAtur tinggi wadah atau tinggi pass.
token_provider_missingmode token mitra tidak memiliki penyediaTambahkan autentikasitokenProvider.
auth_exchange_failedToken embed yang tidak valid, kedaluwarsa, atau tidak cocokPeriksa respons token backend dan channelId.

Agent SDK masalah

GejalaPenyebab yang mungkinMemperbaiki
Tanda tangan ditolakRahasia yang salah, pergeseran jam, atau kolom bertanda yang diubah secara manualBiarkan SDK menghasilkan bidang penandatanganan dan menyinkronkan waktu server.
Risiko pergerakan dana duplikatNomor pesanan baru digunakan setelah timeoutQuery berdasarkan agentOrderNo asli terlebih dahulu.
PROCESSING diperlakukan sebagai kegagalanNegara bagian yang sedang diproses disalahpahamiTunggu webhook atau hubungi queryOrder.
Webhook diproses beberapa kaliPerilaku coba ulang tanpa idempotencyTambahkan kunci idempotensi dan pemeriksaan keadaan akhir.

Bukti yang harus ditangkap

IntegrasiBukti berguna
Trading WidgetPage URL, jalur versi SDK , konsol browser, permintaan jaringan yang gagal, payload onError , dan dimensi kontainer.
Agent SDKSDK bahasa/versi, URL dasar, timestamp UTC , ID permintaan, agentOrderNo, kode respons, dan log yang sudah disanitasi.
WebhookWaktu pengiriman, event atau kunci bisnis, hasil validasi tanda tangan, status pemrosesan, dan hash raw body yang telah disanitasi.
REST APIMetode, jalur, lingkungan, ID permintaan, kode respons, dan parameter yang telah disanitasi.

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

Sebelum meningkatkan eskalasi

  • Coba ulang hanya ketika operasi terdokumentasi aman untuk dicoba ulang.
  • Setelah timeout, query pengenal bisnis asli daripada membuat yang baru.
  • Konfirmasi lingkungan clock sistem dan kredensial untuk kesalahan tanda tangan.
  • Menjaga kegagalan pertama dan hasil percobaan ulang berikutnya.
  • Gunakan Support Request Template untuk mengirim laporan lengkap yang telah disunting.
Trading Widget Mulai Cepat

Verifikasi pemuatan skrip, ukuran kontainer, konfigurasi, dan callback.

Rahasia & Penandatanganan

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

Webhook & Idempotensi

Tinjau verifikasi callback dan penanganan event duplikat.