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
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.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.
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.
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
| 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.