Transações e novas tentativas
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
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
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.