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
1
Autenticarse
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 para instrucciones de configuración.2
Crear y verificar un cliente
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.
3
Registrar un instrumento de transferencia
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.
4
Ejecutar una transferencia
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.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.
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.
Paso 3 — Ejecutar una transferencia
Con un cliente verificado y los instrumentos apropiados en su lugar, llama aPOST /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 para detalles completos sobre tipos de transferencia, estados y rieles soportados.
Conceptos clave
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.