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