¿Pagando empleados, proveedores, vendedores de marketplace u otros terceros? Usa Flujos de Tercera Parte en su lugar.
Salida de definición
Al final del descubrimiento, tú y SpherePay deben acordar sobre:- Tipo de cliente — individual o empresarial
- Entidad legal que posee tanto el origen como el destino
- Primer movimiento — on-ramp, off-ramp, o ambos
- Patrón — transferencia única, Onramper Account u Offloader Wallet
- Divisa fiat y riel
- Stablecoin y red
- Transferencias únicas vs instrucciones reutilizables
- Solo movimiento/conversión vs tenencia de saldo fiat
- Volumen mensual esperado, tamaño de transacción promedio y máximo
- Requisitos de perfil de verificación y habilitación de corredor
- Campos de conciliación que necesita tu equipo de finanzas
Elige tu patrón
Transferencia única
Control explícito de API por on-ramp u off-ramp. Mejor cuando cada movimiento se inicia individualmente.
Onramper Account
Instrucciones de depósito fiat reutilizables que convierten automáticamente a stablecoin en la billetera del cliente.
Offloader Wallet
Dirección de depósito de stablecoin reutilizable que convierte automáticamente a fiat en la cuenta bancaria del cliente.
| Patrón | Señales del descubrimiento | Objetos principales |
|---|---|---|
| Transferencia única | Control de API por movimiento; conversiones ad-hoc; seguimiento de estado por transferencia | Cliente, billetera, cuenta bancaria, transferencia |
| Onramper Account | Depósitos fiat reutilizables; conversión automática a stablecoin; sin llamada de transferencia por depósito | Cliente, billetera, Onramper Account |
| Offloader Wallet | Depósitos de stablecoin reutilizables; conversión automática a fiat; sin llamada de transferencia por depósito | Cliente, cuenta bancaria, Offloader Wallet |
Cómo funciona el flujo
- On-ramp
- Off-ramp
Cuenta bancaria del cliente o cuenta de fondeo reutilizable → SpherePay → Billetera del cliente
Patrón: Transferencia única
Usar cuando: El cliente inicia cada on-ramp u off-ramp individualmente y necesita control explícito por transferencia. Señales del descubrimiento:- Cada movimiento se inicia en un momento específico — no activado por una dirección de depósito permanente
- El integrador posee el reintento, la idempotencia y la UX de estado por transferencia
- El cliente puede necesitar cotizar o ejecutar transferencias una a la vez
Crear o recuperar el cliente
Registra la entidad legal vía POST /v2/customer.
Completar KYC o KYB
Termina el KYC individual o el KYB empresarial hasta que el perfil de verificación alcance
approved.Registrar instrumentos
Vincula la billetera y la cuenta bancaria del cliente en el mismo registro de cliente.
Bloquear una tasa (opcional)
Si el cliente necesita una tasa garantizada, crea una cotización con tasa bloqueada vía POST /v2/quote (válida por 30, 60 o 300 segundos, canjeable una vez) y referencia su
quoteId al crear la transferencia.Crear cada transferencia
Llama a POST /v2/transfer con cliente, origen y destino.
Rastrear y conciliar
Consulta GET /v2/transfer/ hasta un estado terminal — consulta el ciclo de vida de la transferencia.
Confirma que los instrumentos de origen y destino pertenecen al mismo cliente incorporado. Algunos corredores requieren habilitación específica del proveedor más allá del KYC/KYB estándar — confirma el acceso con SpherePay antes de construir.
Patrón: Onramper Account
Usar cuando: El cliente necesita instrucciones de depósito fiat reutilizables que convierten automáticamente a stablecoin en una billetera que posee. Señales del descubrimiento:- El cliente enviará fiat a las mismas instrucciones de depósito repetidamente
- No debe dispararse una llamada
POST /v2/transferen cada depósito - El destino es una billetera de stablecoin propiedad de la misma entidad legal
Crear o recuperar el cliente
Registra la entidad legal vía POST /v2/customer.
Registrar la billetera de destino
El cliente ya debe poseer la dirección on-chain. Registra vía POST /v2/wallet.
Crear un Onramper Account
Llama a POST /v2/virtual-account. Consulta Onramper Accounts.
Compartir instrucciones de depósito
Proporciona
depositInstructions de la respuesta. SpherePay convierte el fiat entrante y entrega stablecoin automáticamente.Rastrear depósitos y conversiones
Consulta GET /v2/transfer filtrado por cliente (usa
type=microdeposit para depósitos de verificación) para listar las transferencias procesadas a través de la cuenta. Cada depósito fiat aparece como una transferencia una vez detectado — concilia contra tus depósitos esperados. No hay una llamada de API por depósito en la que anclar el estado, así que diseña tu cadencia de polling y claves de conciliación antes del lanzamiento.Patrón: Offloader Wallet
Usar cuando: El cliente necesita una dirección on-chain reutilizable que convierte automáticamente stablecoin entrante a fiat en una cuenta bancaria que posee. Señales del descubrimiento:- El cliente enviará stablecoin a la misma dirección repetidamente
- No debe dispararse una llamada
POST /v2/transferen cada depósito - El destino fiat es una cuenta bancaria propiedad de la misma entidad legal
Crear o recuperar el cliente
Registra la entidad legal vía POST /v2/customer.
Registrar la cuenta bancaria de destino
Vincula la cuenta existente del cliente vía POST /v2/bank-account.
Crear un Offloader Wallet
Llama a POST /v2/offloader-wallet. Consulta Offloader Wallets.
Compartir la dirección offloader
Proporciona la dirección on-chain de la respuesta. SpherePay convierte la stablecoin y paga el fiat automáticamente.
Rastrear depósitos y pagos
Consulta GET /v2/transfer filtrado por cliente para rastrear depósitos de stablecoin y los pagos fiat resultantes hasta un estado terminal — consulta el ciclo de vida de la transferencia.
Qué enviar a Sphere antes del inicio
- Tipo de cliente: individual o empresarial
- Entidad legal que posee origen y destino
- Primer flujo: on-ramp, off-ramp, o ambos
- Patrón seleccionado: transferencia única, Onramper Account u Offloader Wallet
- Divisa fiat y riel
- Stablecoin y red
- Volumen mensual esperado
- Tamaño de transacción promedio y máximo
- Transferencias únicas vs instrucciones reutilizables
- Solo movimiento/conversión vs tenencia de saldo fiat
- Requisitos de conciliación
Validar antes de que comience la ingeniería
| Bloqueo | Qué suele significar |
|---|---|
| Perfil de verificación no aprobado | El perfil KYC/KYB requerido está incompleto, pendiente, faltante o rechazado |
| Proveedor/corredor no habilitado | El cliente puede estar aprobado en general pero no habilitado para el corredor o riel específico |
| Riel, divisa o red no soportados | Combinación no disponible para tu producto — Rieles soportados |
| Discrepancia de propiedad | El instrumento de origen o destino no pertenece al cliente incorporado |
| Confusión con billeteras | POST /v2/wallet registra una dirección existente — SpherePay no genera ni custodia claves privadas |
| Confusión con Onramper Account | Automatiza la conversión de fiat a stablecoin vía instrucciones de depósito — confirma requisitos de solo movimiento vs tenencia de saldo |
| Actualizaciones de Offloader Wallet | Cambiar el tipo de divisa/destino de origen o el tipo de riel requiere una nueva billetera; otros campos pueden ser PATCHeables |
Lista de verificación pre-inicio
- La misma entidad legal posee origen y destino
- Patrón seleccionado y confirmado con SpherePay
- Cliente creado o recuperado; perfil de verificación
approvedpara el corredor objetivo - Proveedor/corredor habilitado si es requerido
- Billetera y/o cuenta bancaria registrada en el cliente correcto
- Riel, divisa y red confirmados
- Mapeo de conciliación y estado definido
- Entradas de inicio enviadas a SpherePay
Antes del lanzamiento
SpherePay no tiene un sandbox separado — las pruebas de integración se ejecutan contra producción con datos de identidad reales. Ejecuta una transferencia en vivo de bajo monto en cada corredor antes del lanzamiento. La primera transferencia a un nuevo beneficiario puede activar un RFI de cumplimiento del socio bancario. Establece esta expectativa con tu cliente desde el inicio, y asegúrate de que tu propietario de RFI designado esté listo para responder. Para preguntas de liquidación de usuarios finales, comparte los artículos de la Base de Conocimiento de SpherePay When will the funds land in my account? y My funds are missing or have not landed in my account para que los usuarios se autoatiendan en lugar de abrir tickets de soporte contigo.Profundizar
Gestión de tesorería
Resultado de tesorería de primera parte — ejemplos de on-ramp/off-ramp de ida y vuelta.
Transferencias
Ciclo de vida de transferencia única, restricciones BRL/PIX y referencia de estados.
Flujos de Tercera Parte
Cuando origen y destino no son la misma entidad legal.
Incorporación
Requisitos de KYC, KYB y perfil de verificación.
Base de Conocimiento y FAQ
Artículos de soporte para usuarios finales — tiempos de liquidación, fondos faltantes, mínimos y guías del panel — para compartir con tus usuarios.