¿Eres nuevo en SpherePay? Comienza con Cómo funciona y Conceptos. ¿Conoces tu resultado de negocio pero no tu tipo de flujo? Lee esta página primero, luego Soluciones.
Cómo usar esta sección
Confirmar entradas de definición
Trabaja en Antes de elegir una guía con tu representante de SpherePay — partes, rieles, volumen y modelo de transferencia.
Enrutarte a una guía y patrón
Usa Enrutamiento por resultado del descubrimiento para elegir Flujos de Primera Parte o Flujos de Tercera Parte y el patrón dentro de esa guía.
Validar antes de ingeniería
Completa la salida de definición de la guía, la lista de inicio y las verificaciones de bloqueo antes de escribir código de integración.
Profundizar donde sea necesario
Sigue los enlaces hacia Conceptos, Soluciones y Referencia API para definiciones de objetos, ejemplos de negocio y payloads.
Para qué son estas guías
| Sección | Úsala para… |
|---|---|
| Guías de Implementación (esta sección) | Enrutarte a un camino de construcción, validar la definición y saber qué enviar a Sphere antes del inicio |
| Conceptos | Aprender qué significa cada objeto — clientes, transferencias, automatización, rieles |
| Soluciones | Ver cómo los primitivos se combinan para un resultado de negocio — tesorería, nómina, trading |
| Referencia API | Implementar detalles de solicitud/respuesta para un endpoint específico |
Antes de elegir una guía
Confirma estas entradas con tu representante de SpherePay durante o inmediatamente después del descubrimiento:- Quién posee los fondos en cada paso
- Cliente de registro — quién debe ser incorporado y verificado por SpherePay
- Remitente y beneficiario — pueden diferir del cliente de registro
- Rol de la plataforma — si tu plataforma está en el flujo de fondos
- Usuarios finales — empresas, consumidores, o ambos
- Divisa fiat y riel — consulta Rieles soportados
- Stablecoin y red — consulta Activos soportados
- Modelo de transferencia — transferencias API únicas vs instrucciones reutilizables de depósito/retiro
- Modelo de saldo — solo movimiento/conversión vs tenencia de saldo fiat
- Volumen — volumen mensual esperado, tamaño de transacción promedio y máximo
Enrutamiento por resultado del descubrimiento
| Después del descubrimiento, sabes que… | Empieza aquí | Patrón |
|---|---|---|
| La misma entidad legal posee tanto el origen como el destino | Flujos de Primera Parte | — |
| Cada on-ramp/off-ramp se inicia explícitamente vía API | Flujos de Primera Parte | Transferencia única |
| Instrucciones de depósito fiat reutilizables en la propia billetera del cliente | Flujos de Primera Parte | Onramper Account |
| Retiro de stablecoin a fiat reutilizable a la propia cuenta bancaria del cliente | Flujos de Primera Parte | Offloader Wallet |
| Una empresa paga a un proveedor, vendedor, contratista u otro tercero | Flujos de Tercera Parte | Empresa paga proveedor |
| Una plataforma habilita a sus clientes empresariales a mover fondos | Flujos de Tercera Parte | Plataforma sirve clientes empresariales |
| Un banco o fintech integra ramps para muchos usuarios finales | Flujos de Tercera Parte | Banco o fintech sirve consumidores |
Elige una guía
Flujos de Primera Parte
La misma entidad legal posee origen y destino — transferencias únicas, Onramper Accounts y Offloader Wallets.
Flujos de Tercera Parte
Partes diferentes o flujos mediados por plataforma — pagos a proveedores, B2B de plataforma y caminos de integración para consumidores.
¿Primera parte o tercera parte?
Si la tabla de enrutamiento anterior no coincide claramente, usa esta bifurcación:| Tipo de flujo | Enruta cuando | Ejemplo |
|---|---|---|
| Primera parte | La misma entidad legal posee el origen y el destino | Cuenta bancaria de empresa → billetera de la misma empresa |
| Tercera parte | Remitente, beneficiario o cliente de registro son entidades diferentes, o una plataforma sirve a usuarios finales | Billetera de empresa → cuenta bancaria de proveedor |
Mapear a Soluciones
Las Guías de Implementación definen cómo construir. Las Soluciones definen qué resultado de negocio estás implementando. Usa ambos:Gestión de tesorería
On-ramp/off-ramp de tesorería de primera parte — combina con Flujos de Primera Parte.
Aceptación de pagos
Aceptación fiat de plataforma — a menudo Flujos de Tercera Parte o patrón Onramper.
Nómina
Desembolsos de tercera parte — combina con Flujos de Tercera Parte.
Financiamiento comercial transfronterizo
Liquidación de proveedores y facturas — combina con Flujos de Tercera Parte.