Transazioni e tentativi
Un prelievo è un’operazione commerciale asincrona. Una risposta HTTP riuscita significa che la richiesta è stata gestita; non stabilisce che i fondi siano arrivati on-chain.
Mantieni un identificatore aziendale
Genera e archivia client_request_id prima di inviare un prelievo. Riutilizzarlo per nuovi tentativi della stessa operazione prevista, anche dopo il riavvio del processo. Mantieni coerenti i campi della transazione; l’attuale implementazione rifiuta un identificatore ripetuto con parametri aziendali contrastanti.
Non fare affidamento solo su un’intestazione Idempotency-Key. Il SDK fornito può aggiungere quell’intestazione, ma l’attuale contratto di deduplicazione del ritiro è basato sul campo del corpo client_request_id.
Comprendere i dati della richiesta
Questa tabella evidenzia i campi principali, non uno schema di richiesta completo. Conferma l’anteprima, la conferma delle commissioni e i requisiti specifici della custodia rispetto alla versione di integrazione. Evitare importi binari in virgola mobile e non copiare catene di esempio o numeri di asset tra ambienti.
Segui il risultato
L’elenco è illustrativo e può evolvere. Conserva gli stati sconosciuti per le indagini invece di mapparli in base al successo o al fallimento. Un’etichetta fallita o rifiutata da sola non è una prova sufficiente che nulla sia stato firmato o trasmesso.
Recupera dopo un timeout
Interroga GET /api/v1/withdrawals/by-request utilizzando il parametro di query originale client_request_id. Continua a eseguire il polling o a riconciliare l’operazione originale mentre il suo risultato è incerto. Se è necessario il rinnovo dell’autorizzazione, utilizzare lo stesso identificativo e la procedura di rinnovo concordata.
La cancellazione dipende dall’effettiva fase di firma e dai controlli del server. Avviare un’operazione commerciale sostitutiva solo dopo che l’originale è stato stabilito come non trasferito e non trasferibile. Ricevi eventi tramite webhookse conservare le query API come percorso di riconciliazione.