> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spherepay.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Ciclo de Vida y Referencia de Estado de Transferencias

> Entiende cómo las transferencias de SpherePay avanzan por cada estado — desde pendingFunding hasta succeeded, returned o failed — y cómo manejar cada estado.

Una transferencia (`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.

<Tip>
  Usa `depositInstructions` para construir y entregar los detalles de la transacción directamente a tus clientes para transferencias off-ramp. Presenta la dirección, la red y el monto claramente para que puedan enviar el monto exacto a la dirección correcta.
</Tip>

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. Consulta `GET /v2/transfer/{id}` en un intervalo razonable para rastrear el progreso.

```bash theme={"dark"}
curl https://api.spherepay.co/v2/transfer/{{transfer_id}} \
  -H "Authorization: Bearer {{api_key}}"
```

<Note>
  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á.
</Note>

Consulta la [referencia API de Obtener una Transferencia](/es/api-reference/transfer/get-id) para el esquema de respuesta completo.