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.Seguimiento de actualizaciones de estado
SpherePay puede enviar actualizaciones de estado de transferencias a tus sistemas vía webhooks — suscríbete a los eventostransfer.* para recibir una notificación de cada transición listada arriba. Como alternativa, consulta GET /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á.