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 o pedido foi tratado; 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, incluindo após o reinício do processo. Mantenha os campos da transação consistentes; a implementação atual rejeita um identificador repetido com parâmetros de negócio conflituantes.

Não confie apenas num cabeçalho Idempotency-Key. O SDK fornecido pode adicionar este cabeçalho, mas o contrato de desduplicação de levantamento 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 pedido 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 levantamentos iniciados pela chave API
end_user_idIdentificador de utilizador empresarial opcional no fluxo empresarial API

Esta tabela destaca os campos principais, e não um esquema de pedido completo. Confirme a visualização, a confirmação das 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_signA aprovação e a assinatura são etapas separadas
broadcasting, pending_chainA transmissão ou confirmação da cadeia está em curso
broadcast_unverified, recoveringO resultado é ainda incerto; não crie outra transferência
awaiting_reauthorizationPode ser necessária uma nova autorização do cliente para a mesma solicitação
confirmedO sistema registou a confirmação da cadeia

A lista é ilustrativa e pode evoluir. Preserve os estados desconhecidos para investigação em vez de os mapear para o 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 utilizando o parâmetro de consulta original client_request_id. Continue a sondar ou a reconciliar a operação original enquanto o 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 da fase real de subscrição e das verificações do servidor. Só inicie uma operação comercial de substituição depois de o original ter sido estabelecido como não transferido e incapaz de ser transferido. Receba eventos através webhookse reter as consultas API como um caminho de reconciliação.