Skip to navigation

Transaksi dan Percobaan Ulang

View as Markdown

Penarikan adalah operasi bisnis yang tidak sinkron. Respons HTTP yang berhasil berarti permintaan telah ditangani; itu tidak menetapkan bahwa dana tiba secara on-chain.

Pertahankan satu pengenal bisnis

Hasilkan dan simpan client_request_id sebelum mengirim penarikan. Gunakan kembali untuk mencoba ulang operasi yang sama, termasuk setelah proses dimulai ulang. Jaga konsistensi bidang transaksi; implementasi saat ini menolak pengidentifikasi berulang dengan parameter bisnis yang bertentangan.

Jangan hanya mengandalkan header Idempotency-Key saja. SDK yang disediakan dapat menambahkan header tersebut, tetapi kontrak deduplikasi penarikan saat ini didasarkan pada kolom isi client_request_id.

Memahami data permintaan

BidangArti
chain_id, asset_idPengidentifikasi di lingkungan yang disepakati
to_address, amountTujuan dan jumlah desimal positif direpresentasikan sebagai string
client_request_idPengidentifikasi permintaan bisnis yang stabil
dest_memo_type, dest_memoDetail memo tujuan di mana jaringan memerlukannya
client_authorizationOtorisasi transaksi pelanggan untuk API-penarikan yang dimulai dengan kunci
end_user_idPengidentifikasi pengguna bisnis opsional di aliran API perusahaan

Tabel ini menyoroti bidang inti, bukan skema permintaan lengkap. Konfirmasikan pratinjau, konfirmasi biaya, dan persyaratan khusus penyimpanan kunci terhadap versi integrasi. Hindari jumlah floating-point biner dan jangan menyalin contoh rantai atau nomor aset antar lingkungan.

Ikuti hasilnya

Nyatakan contohnyaInterpretasi
pending_approval, pending_platform_reviewPersetujuan atau peninjauan bisnis masih luar biasa
approved, pending_signPersetujuan dan penandatanganan merupakan tahapan yang terpisah
broadcasting, pending_chainPenyiaran atau konfirmasi berantai sedang berlangsung
broadcast_unverified, recoveringHasilnya masih belum pasti; jangan membuat transfer lain
awaiting_reauthorizationOtorisasi pelanggan baru mungkin diperlukan untuk permintaan yang sama
confirmedSistem telah mencatat konfirmasi berantai

Daftar ini bersifat ilustratif dan dapat berkembang. Pertahankan keadaan yang tidak diketahui untuk diselidiki alih-alih memetakannya menuju keberhasilan atau kegagalan. Label yang gagal atau ditolak saja tidak cukup sebagai bukti bahwa tidak ada yang ditandatangani atau disiarkan.

Pulihkan setelah batas waktu

Kueri GET /api/v1/withdrawals/by-request menggunakan parameter kueri client_request_id asli. Tetap melakukan polling atau merekonsiliasi operasi awal selama hasilnya tidak pasti. Jika pembaruan otorisasi diperlukan, gunakan pengidentifikasi yang sama dan prosedur pembaruan yang disepakati.

Pembatalan tergantung pada tahap penandatanganan sebenarnya dan pemeriksaan server. Hanya memulai operasi bisnis pengganti setelah yang asli ditetapkan sebagai tidak ditransfer dan tidak dapat ditransfer. Terima acara melalui webhooks, dan pertahankan kueri API sebagai jalur rekonsiliasi.