Transacciones y reintentos
Un retiro es una operación comercial asincrónica. Una respuesta HTTP exitosa significa que la solicitud fue manejada; no establece que los fondos llegaron a la cadena.
Conservar un identificador de empresa
Genera y almacena client_request_id antes de enviar un retiro. Reutilícelo para reintentar la misma operación prevista, incluso después de reiniciar el proceso. Mantenga consistentes los campos de la transacción; la implementación actual rechaza un identificador repetido con parámetros comerciales contradictorios.
No confíe únicamente en un encabezado Idempotency-Key. El SDK proporcionado puede agregar ese encabezado, pero el contrato de deduplicación de retiro actual se basa en el campo del cuerpo client_request_id.
Comprender los datos de la solicitud
Esta tabla resalta los campos principales, no un esquema de solicitud completo. Confirme la vista previa, la confirmación de tarifas y los requisitos específicos de custodia con la versión de integración. Evite cantidades binarias de punto flotante y no copie cadenas de ejemplo o números de activos entre entornos.
Sigue el resultado
La lista es ilustrativa y puede evolucionar. Preservar estados desconocidos para la investigación en lugar de asignarlos al éxito o al fracaso. Una etiqueta fallida o rechazada por sí sola no es prueba suficiente de que no se firmó ni se transmitió nada.
Recuperarse después de un tiempo de espera
Consulta GET /api/v1/withdrawals/by-request utilizando el parámetro de consulta original client_request_id. Continúe sondeando o conciliando la operación original mientras su resultado sea incierto. Si se requiere renovación de autorización, utilice el mismo identificador y el procedimiento de renovación acordado.
La cancelación depende de la etapa de firma real y de los controles del servidor. Solo inicie una operación comercial de reemplazo después de que se establezca que el original no se transfirió y no se puede transferir. Recibe eventos a través de webhooksy conservar las consultas API como ruta de conciliación.