Vai alla navigazione

Transazioni e tentativi

Visualizza come Markdown

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

CampoSenso
chain_id, asset_idIdentificatori nell’ambiente concordato
to_address, amountDestinazione e un importo decimale positivo rappresentato come una stringa
client_request_idIdentificatore di richiesta aziendale stabile
dest_memo_type, dest_memoDettagli del promemoria di destinazione laddove la rete li richiede
client_authorizationAutorizzazione della transazione del cliente per i prelievi avviati dalla chiave API.
end_user_idIdentificatore utente aziendale facoltativo nel flusso aziendale API.

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

Esempi stataliInterpretazione
pending_approval, pending_platform_reviewUn’approvazione o una revisione aziendale è in sospeso
approved, pending_signL’approvazione e la firma sono fasi separate
broadcasting, pending_chainLa trasmissione o la conferma della catena è in corso
broadcast_unverified, recoveringL’esito è ancora incerto; non creare un altro trasferimento
awaiting_reauthorizationPer la stessa richiesta potrebbe essere necessaria una nuova autorizzazione del cliente
confirmedIl sistema ha registrato la conferma della catena

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.