transfer) en SpherePay es el movimiento de fondos entre cuentas financieras — una billetera y una cuenta bancaria. Cada transferencia tiene un origen y un destino. Después de crear una transferencia, SpherePay la mueve a través de una serie de estados a medida que los fondos se reciben, procesan y entregan. Entender estos estados te permite crear visualizaciones de estado precisas y manejar casos extremos como fallos y reembolsos.
El campo instructions
Cuando creas una transferencia, la respuesta incluye un campo instructions que describe qué fondos necesita enviar el cliente y a dónde. Para transferencias off-ramp, el subcampo depositInstructions contiene los detalles que tu cliente necesita para iniciar la transacción on-chain — la dirección de destino, la red, la divisa y el monto.
Las transferencias que están fondas se ejecutan en el siguiente ciclo de ejecución de transferencias.
Estados de transferencia
La tabla a continuación lista cada posible estado que puede alcanzar una transferencia, en el orden en que típicamente ocurren.Consultar actualizaciones de estado
SpherePay no envía actualizaciones de estado de transferencias vía webhook por defecto. ConsultaGET /v2/transfer/{id} en un intervalo razonable para rastrear el progreso.
Consulta hasta que la transferencia alcance un estado terminal:
succeeded, refunded, failed, canceled, returned, unexpectedError o failedPrecondition. Una vez que una transferencia entra en un estado terminal, su estado no cambiará.