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.| Estado | Descripción |
|---|---|
pendingFunding | SpherePay está esperando recibir fondos del cliente antes de procesar la transferencia. Esto aplica a depósitos cripto entrantes, wire y transferencias ACH. |
pendingReview | Un estado temporal y raro desencadenado cuando los datos de la transferencia necesitan confirmación adicional. Normalmente se resuelve en segundos; de lo contrario SpherePay se pondrá en contacto dentro de 24 horas. |
fundsReceived | SpherePay ha recibido los fondos del cliente y se está preparando para procesar la transferencia. |
processing | SpherePay está procesando activamente la transferencia. |
succeeded | La transferencia ha sido exitosa y los fondos han sido entregados al destino. |
returned | La transferencia fue devuelta por el banco de destino. Se iniciará un reembolso de vuelta al cliente. |
pendingRefundInformation | SpherePay está esperando que el cliente proporcione información adicional necesaria para completar el reembolso. |
failed | La transferencia ha fallado. Se iniciará un reembolso de vuelta al cliente. |
canceled | La transferencia fue cancelada por el cliente. Se iniciará un reembolso de vuelta al cliente. |
refunded | El reembolso ha sido entregado al cliente. |
unexpectedError | La transferencia encontró un error inesperado. Se iniciará un reembolso de vuelta al cliente. |
failedPrecondition | La transferencia falló porque el cliente proporcionó información inválida. Se iniciará un reembolso de vuelta al cliente. |
undeliverable (deprecado) | Este estado ya no se usa. |
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á.