O campo instructions
Quando você cria uma transferência, a resposta inclui um campo instructions que descreve quais fundos o cliente precisa enviar e para onde. Para transferências de off-ramp, o sub-campo depositInstructions contém os detalhes que seu cliente precisa para iniciar a transação on-chain — o endereço de destino, rede, moeda e valor.
Transferências que são financiadas são executadas no próximo ciclo de execução de transferências.
Status de transferência
A tabela abaixo lista todos os status possíveis que uma transferência pode atingir, na ordem em que tipicamente ocorrem.| Status | Descrição |
|---|---|
pendingFunding | O SpherePay está aguardando o recebimento de fundos do cliente antes de processar a transferência. Aplica-se a depósitos cripto recebidos, wires e transferências ACH. |
pendingReview | Um estado temporário raro acionado quando os dados da transferência precisam de confirmação adicional. Normalmente se resolve em segundos; caso contrário, o SpherePay entrará em contato em até 24 horas. |
fundsReceived | O SpherePay recebeu os fundos do cliente e está se preparando para processar a transferência. |
processing | O SpherePay está processando ativamente a transferência. |
succeeded | A transferência foi concluída com sucesso e os fundos foram entregues ao destino. |
returned | A transferência foi devolvida pelo banco de destino. Um reembolso será iniciado de volta ao cliente. |
pendingRefundInformation | O SpherePay está aguardando que o cliente forneça informações adicionais necessárias para concluir o reembolso. |
failed | A transferência falhou. Um reembolso será iniciado de volta ao cliente. |
canceled | A transferência foi cancelada pelo cliente. Um reembolso será iniciado de volta ao cliente. |
refunded | O reembolso foi entregue ao cliente. |
unexpectedError | A transferência encontrou um erro inesperado. Um reembolso será iniciado de volta ao cliente. |
failedPrecondition | A transferência falhou porque o cliente forneceu informações inválidas. Um reembolso será iniciado de volta ao cliente. |
undeliverable (depreciado) | Este status não é mais usado. |
Consultando atualizações de status
O SpherePay não envia atualizações de status de transferência via webhook por padrão. ConsulteGET /v2/transfer/{id} em um intervalo razoável para acompanhar o progresso.
Consulte até a transferência atingir um estado terminal:
succeeded, refunded, failed, canceled, returned, unexpectedError ou failedPrecondition. Uma vez que uma transferência entra em um estado terminal, seu status não mudará.