Saltar a la navegación

Transacciones y reintentos

Ver como Markdown

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

CampoSignificado
chain_id, asset_idIdentificadores en el entorno acordado
to_address, amountDestino y una cantidad decimal positiva representada como una cadena
client_request_idIdentificador de solicitud comercial estable
dest_memo_type, dest_memoDetalles de la nota de destino donde la red los requiere
client_authorizationAutorización de transacción del cliente para retiros iniciados con clave API
end_user_idIdentificador de usuario empresarial opcional en el flujo empresarial API

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

Ejemplos de estadosInterpretación
pending_approval, pending_platform_reviewUna aprobación o revisión comercial está pendiente
approved, pending_signLa aprobación y la firma son etapas separadas.
broadcasting, pending_chainLa transmisión o la confirmación de la cadena están en curso.
broadcast_unverified, recoveringEl resultado aún es incierto; no crear otra transferencia
awaiting_reauthorizationEs posible que se requiera una nueva autorización de cliente para la misma solicitud.
confirmedEl sistema ha registrado la confirmación en cadena.

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.