> ## 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.
# Cómo Funciona SpherePay: Modelo de Integración
> Aprende el modelo de integración en tres pasos de SpherePay: crea un cliente verificado, registra un instrumento de transferencia y ejecútala.
Comprender el modelo de integración de SpherePay antes de escribir cualquier código te ahorrará mucho tiempo. Cada integración — ya sea que estés construyendo on-ramp, off-ramp o integrando el widget de ramp — sigue la misma secuencia central: autenticarse, incorporar a un cliente (`customer`), registrar un instrumento de transferencia y ejecutar una transferencia (`transfer`). Esta página explica cada paso y los conceptos clave detrás de ellos.
## Secuencia de integración
Genera una clave API desde tu panel de SpherePay. Cada solicitud API debe incluir esta clave como token Bearer en el encabezado `Authorization`. Consulta [Autenticación](/es/get-started/authentication) para instrucciones de configuración.
Un cliente representa al usuario final o empresa en cuyo nombre estás moviendo dinero. Antes de que se pueda iniciar cualquier transferencia, el cliente debe pasar la verificación de identidad — KYC para individuos, KYB para empresas. No se puede crear ninguna transferencia sin un registro de cliente verificado.
Una vez que tu cliente esté verificado, vincula la cuenta o billetera que servirá como origen o destino de la transferencia. Para transferencias on-ramp, vinculas una cuenta bancaria como origen fiat y una billetera como destino cripto. Para off-ramp, la dirección se invierte.
Con un cliente verificado y al menos una cuenta bancaria y una billetera registradas, llama a `POST /v2/transfer`. SpherePay gestiona el enrutamiento, la conversión de divisas y la liquidación a partir de ese momento.
Cada paso es un requisito previo obligatorio para el siguiente. No puedes iniciar una transferencia sin un cliente verificado, y no puedes completar una transferencia sin un instrumento de origen y destino registrado.
## Paso 1 — Crear y verificar un cliente
Un cliente en SpherePay representa a un usuario final o empresa en cuyo nombre estás moviendo dinero. Antes de que un cliente pueda realizar transacciones, debe pasar la verificación de identidad:
* **Clientes individuales** pasan por un flujo KYC (Know Your Customer). Esto implica la presentación de documentos de identidad y una verificación de vivacidad facial.
* **Clientes empresariales** pasan por un flujo KYB (Know Your Business). Esto implica la presentación de documentos empresariales y la verificación de un director o representante autorizado.
La verificación se gestiona a través de Sumsub, ya sea directamente a través de la API de SpherePay o a través de un enlace KYC/KYB alojado que envías a tu cliente. Una vez que Sumsub aprueba la solicitud, SpherePay procesa el resultado y actualiza el estado del cliente.
Consulta [Clientes y Onboarding](/es/concepts/onboarding/overview) para guías de integración completas.
## Paso 2 — Registrar un instrumento de transferencia
Una vez que un cliente está verificado, registra el instrumento de transferencia que servirá como origen o destino de una transferencia:
* **Cuentas bancarias** (`bank_account`) — usadas como origen fiat para on-ramp o como destino fiat para off-ramp.
* **Billeteras** (`wallet`) — usadas como destino cripto para on-ramp o como origen cripto para off-ramp.
Un solo cliente puede tener múltiples cuentas bancarias y billeteras registradas. Especificas qué instrumentos usar al crear cada transferencia.
## Paso 3 — Ejecutar una transferencia
Con un cliente verificado y los instrumentos apropiados en su lugar, llama a `POST /v2/transfer` para iniciar el movimiento de fondos. Especificas el cliente, el instrumento de origen, el instrumento de destino y el monto. SpherePay se encarga de todo lo demás.
Consulta [Transferencias](/es/concepts/transfers/overview) para detalles completos sobre tipos de transferencia, estados y rieles soportados.
## Conceptos clave
| Concepto | Descripción |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Cliente** | Un individuo o empresa en cuyo nombre se ejecutan las transferencias. Debe estar verificado con KYC/KYB antes de que se pueda iniciar cualquier transferencia. |
| **Cuenta Bancaria** | Una cuenta bancaria fiat vinculada a un cliente, utilizada para enviar o recibir fondos fiat. |
| **Billetera** | Una dirección de billetera cripto vinculada a un cliente, utilizada para enviar o recibir stablecoins. |
| **Transferencia** | Un único evento de movimiento de dinero entre la cuenta bancaria y la billetera de un cliente, en cualquier dirección. |
## Qué gestiona SpherePay por ti
Una vez que envías una transferencia, SpherePay gestiona el ciclo de vida completo:
* Orquestación de verificación de identidad a través de Sumsub
* Screening de cumplimiento normativo y verificaciones de sanciones
* Conversión de fiat a cripto y de cripto a fiat
* Liquidación y pago a través de los rieles bancarios y blockchain subyacentes
SpherePay no mantiene un entorno sandbox separado. Las pruebas ocurren directamente contra sistemas de producción usando información de identidad real. Esto garantiza que tu integración esté validada contra la misma verificación de identidad y alianzas bancarias que usarán tus clientes.