Ir para a navegação

Transações e novas tentativas

Ver como Markdown

Uma retirada é uma operação comercial assíncrona. Uma resposta HTTP bem-sucedida significa que a solicitação foi tratada; não estabelece que os fundos chegaram à rede.

Persistir um identificador comercial

Gere e armazene client_request_id antes de enviar um saque. Reutilize-o para novas tentativas da mesma operação pretendida, inclusive após a reinicialização do processo. Mantenha os campos da transação consistentes; a implementação atual rejeita um identificador repetido com parâmetros de negócios conflitantes.

Não confie apenas em um cabeçalho Idempotency-Key. O SDK fornecido pode adicionar esse cabeçalho, mas o contrato de desduplicação de retirada atual é baseado no campo de corpo client_request_id.

Entenda os dados da solicitação

CampoSignificado
chain_id, asset_idIdentificadores no ambiente acordado
to_address, amountDestino e um valor decimal positivo representado como uma string
client_request_idIdentificador de solicitação comercial estável
dest_memo_type, dest_memoDetalhes do memorando de destino onde a rede os exige
client_authorizationAutorização de transação do cliente para saques iniciados pela chave API
end_user_idIdentificador de usuário empresarial opcional no fluxo corporativo API

Esta tabela destaca os campos principais, não um esquema de solicitação completo. Confirme a visualização, a confirmação de taxas e os requisitos específicos de custódia em relação à versão de integração. Evite valores binários de ponto flutuante e não copie exemplos de cadeias ou números de ativos entre ambientes.

Acompanhe o resultado

Exemplos de estadoInterpretação
pending_approval, pending_platform_reviewUma aprovação ou revisão comercial está pendente
approved, pending_signAprovação e assinatura são etapas separadas
broadcasting, pending_chainA transmissão ou confirmação da cadeia está em andamento
broadcast_unverified, recoveringO resultado ainda é incerto; não crie outra transferência
awaiting_reauthorizationUma nova autorização do cliente pode ser necessária para a mesma solicitação
confirmedO sistema registrou a confirmação da cadeia

A lista é ilustrativa e pode evoluir. Preserve estados desconhecidos para investigação em vez de mapeá-los para sucesso ou fracasso. Uma etiqueta falhada ou rejeitada por si só não é prova suficiente de que nada foi assinado ou transmitido.

Recuperar após um tempo limite

Consulte GET /api/v1/withdrawals/by-request usando o parâmetro de consulta original client_request_id. Continue sondando ou reconciliando a operação original enquanto seu resultado for incerto. Se for necessária a renovação da autorização, utilize o mesmo identificador e o procedimento de renovação acordado.

O cancelamento depende do estágio real de assinatura e das verificações do servidor. Somente inicie uma operação comercial de substituição depois que o original for estabelecido como não transferido e incapaz de ser transferido. Receba eventos através webhookse reter consultas API como um caminho de reconciliação.