# SpherePay: Spanish ## Spanish ### Comenzar #### Introducción - [SpherePay: Pagos con stablecoins para negocios globales](https://docs.spherepay.co/es/introduction.md): SpherePay es una plataforma API-first para on-ramp y off-ramp entre USD, EUR, BRL y USDC, USDT, EURC con cumplimiento KYC/KYB integrado. #### Comenzar - [Cómo Funciona SpherePay: Modelo de Integración](https://docs.spherepay.co/es/get-started/how-it-works.md): Aprende el modelo de integración en tres pasos de SpherePay: crea un cliente verificado, registra un instrumento de transferencia y ejecútala. - [Autenticarse con la API de SpherePay](https://docs.spherepay.co/es/get-started/authentication.md): Todas las solicitudes de la API de SpherePay utilizan autenticación con token Bearer. Aprende a generar tu clave API y pasarla correctamente en cada solicitud. - [Realiza tu Primera Llamada a la API de SpherePay](https://docs.spherepay.co/es/get-started/first-api-call.md): Recorre la creación de un cliente, el registro de una cuenta bancaria y billetera, y luego ejecuta tu primera transferencia on-ramp con la API de SpherePay. - [Descarga de la Especificación OpenAPI 3.0 de SpherePay](https://docs.spherepay.co/es/get-started/openapi-spec.md): Descarga la especificación OpenAPI 3.0 de SpherePay para generar clientes API, importar en Postman o Insomnia, o crear integraciones propias. ### Conceptos - [Conceptos y Datos de Referencia de SpherePay](https://docs.spherepay.co/es/concepts/overview.md): Modelos mentales y datos de referencia para construir en SpherePay: incorporación, transferencias, automatización, rieles y operaciones. #### Incorporación - [Clientes e Incorporación en SpherePay](https://docs.spherepay.co/es/concepts/onboarding/overview.md): Crea y verifica clientes antes de mover fondos. Aprende sobre KYC para individuos y KYB para empresas con la API de incorporación de SpherePay. - [KYC para Clientes Individuales](https://docs.spherepay.co/es/concepts/onboarding/individual-kyc.md): Incorpora clientes individuales con verificación de identidad KYC. Elige API o enlace alojado, con cumplimiento Sphere-Managed o Platform-Managed. - [KYB para Clientes Empresariales](https://docs.spherepay.co/es/concepts/onboarding/business-kyb.md): Incorpora clientes empresariales con verificación KYB. Envía documentos, registra UBOs y completa la verificación vía API o enlace alojado. - [Incorpora Clientes con un Enlace KYC Alojado](https://docs.spherepay.co/es/concepts/onboarding/kyc-via-link.md): Usa el enlace de incorporación alojado de SpherePay para verificar clientes sin construir una UI personalizada. Completa KYC o KYB en minutos. - [Perfil de Verificación y Estados del Cliente](https://docs.spherepay.co/es/concepts/onboarding/verification-profile.md): El perfil de verificación rastrea el estado KYC o KYB de un cliente. Aprende qué significa cada estado y qué activa las transiciones. - [Tipos de ID y NIF admitidos](https://docs.spherepay.co/es/concepts/onboarding/identification-types.md): Referencia de documentos de identidad y números de identificación fiscal por país aceptados para incorporar clientes individuales y empresariales. #### Transferencias - [API de Transferencias: Guía de On-Ramp y Off-Ramp](https://docs.spherepay.co/es/concepts/transfers/overview.md): Crea transferencias on-ramp y off-ramp con la API de SpherePay: flujo de integración, ejemplos para USD y BRL/PIX, y seguimiento de estado. - [Ciclo de Vida y Referencia de Estado de Transferencias](https://docs.spherepay.co/es/concepts/transfers/lifecycle.md): Entiende cómo las transferencias de SpherePay avanzan por cada estado — desde pendingFunding hasta succeeded, returned o failed — y cómo manejar cada estado. - [Registrar Cuentas Bancarias para Transferencias Fiat](https://docs.spherepay.co/es/concepts/transfers/bank-accounts.md): Vincula la cuenta bancaria fiat de un cliente a SpherePay para habilitar transferencias on-ramp y off-ramp vía rieles de pago ACH, Wire, SEPA o PIX. - [Registrar Billeteras Cripto para Stablecoins](https://docs.spherepay.co/es/concepts/transfers/wallets.md): Vincula la dirección de billetera blockchain de un cliente a SpherePay para habilitar transferencias on-ramp y off-ramp en stablecoins. - [Rieles de Pago y Stablecoins Soportados](https://docs.spherepay.co/es/concepts/transfers/supported-rails.md): Ve todos los rieles de origen y destino, divisas y redes de stablecoins soportadas para Transferencias, Onramper Accounts y Offloader Wallets de SpherePay. #### Automatización - [Onramper Accounts: Fiat a Stablecoin Automatizado](https://docs.spherepay.co/es/concepts/automation/onramper-accounts.md): Los Onramper Accounts le dan a cada cliente una cuenta bancaria virtual dedicada que convierte automáticamente los depósitos fiat en stablecoins on-chain. - [Offloader Wallets: Cripto a Fiat Automatizado](https://docs.spherepay.co/es/concepts/automation/offloader-wallets.md): Los Offloader Wallets le dan a cada cliente una dirección on-chain dedicada que convierte automáticamente las stablecoins entrantes en pagos fiat bancarios. #### Webhooks - [Descripción General de Webhooks](https://docs.spherepay.co/es/concepts/webhooks/overview.md): Recibe notificaciones en tiempo real cuando los clientes, las transferencias y otros recursos de SpherePay cambian de estado — en lugar de consultar por actualizaciones. - [Gestión de Endpoints de Webhook](https://docs.spherepay.co/es/concepts/webhooks/managing-endpoints.md): Registra endpoints de webhook, suscríbete a eventos y entiende los límites de endpoints, sus estados y el modelo de actualización de eliminar y recrear. - [Payloads de Eventos de Webhook](https://docs.spherepay.co/es/concepts/webhooks/event-payloads.md): La estructura de cada payload de webhook — los campos de la envoltura, cómo el campo sequence ordena los eventos y cómo applicationId delimita cada evento. - [Catálogo de Eventos de Webhook](https://docs.spherepay.co/es/concepts/webhooks/event-catalog.md): Cada tipo de evento de webhook al que puedes suscribirte — eventos de cliente y de transferencia, con sus desencadenantes y payloads de ejemplo. - [Verificación de Firmas de Webhook](https://docs.spherepay.co/es/concepts/webhooks/verifying-signatures.md): Autentica cada entrega de webhook validando su firma HMAC-SHA256 — con implementaciones de referencia en Python, JavaScript, Go, Java y C#. - [Explorar Eventos y Reenviar Entregas](https://docs.spherepay.co/es/concepts/webhooks/events-and-replays.md): Revisa cada evento que SpherePay ha registrado, inspecciona intentos de entrega y respuestas, y reenvía una entrega fallida bajo demanda. #### Datos de referencia - [Referencia de Códigos de País para la API de SpherePay](https://docs.spherepay.co/es/concepts/reference/supported-countries.md): SpherePay usa códigos ISO 3166-1 alpha-3 en las direcciones del cliente. Referencia de códigos comunes para crear clientes y cuentas bancarias. - [Países Prohibidos y Regiones Sancionadas](https://docs.spherepay.co/es/concepts/reference/prohibited-countries.md): Países y jurisdicciones donde no se pueden abrir cuentas de SpherePay, además de las restricciones regionales que aplican a regiones sancionadas. - [Códigos de Divisa Soportados en SpherePay](https://docs.spherepay.co/es/concepts/reference/supported-assets.md): Códigos de divisa fiat y stablecoin usados en la API de SpherePay: USD, EUR, BRL, USDC, USDT y EURC, con sus redes blockchain soportadas. - [Códigos de Canal de Pago en SpherePay](https://docs.spherepay.co/es/concepts/reference/channel-codes.md): Referencia de códigos de red y canal usados en transferencias de SpherePay, incluyendo ach, wire, sepa, pix e identificadores de blockchain. #### Operacional - [Límites de Tasa de API y Mejores Prácticas](https://docs.spherepay.co/es/concepts/operational/rate-limits.md): SpherePay aplica 100 RPS para lectura y escritura. Maneja errores de límite de tasa, implementa lógica de reintento y solicita aumentos temporales. ### Guías #### Introducción - [Guías de Implementación](https://docs.spherepay.co/es/implementation-guides/overview.md): Enrutamiento post-descubrimiento para SpherePay: elige el camino de implementación, patrón y documentación tras definir tu flujo de fondos. #### Tipos de flujo - [Flujos de Primera Parte](https://docs.spherepay.co/es/implementation-guides/first-party-flows.md): Caminos de implementación cuando la misma entidad legal posee ambos lados del movimiento: transferencias únicas, Onramper Accounts y Offloader Wallets. - [Flujos de Tercera Parte](https://docs.spherepay.co/es/implementation-guides/third-party-flows.md): Caminos de implementación post-descubrimiento cuando los fondos se mueven hacia o desde otra entidad legal, o cuando una plataforma sirve a clientes finales. ### Soluciones #### Introducción - [Soluciones de SpherePay: Guías por Caso de Uso](https://docs.spherepay.co/es/solutions/overview.md): Guías orientadas a resultados para casos de uso de SpherePay: nómina, aceptación de pagos, trading, financiamiento transfronterizo y tesorería. #### Movimiento de dinero - [Nómina en Stablecoins y Fiat para Equipos Globales](https://docs.spherepay.co/es/solutions/payroll.md): Paga a empleados W-2 y contratistas 1099 en stablecoins o fiat. Cubre modelos de nómina cripto-nativos y tradicionales con una única integración. - [Acepta Pagos Fiat y Liquida en Stablecoins](https://docs.spherepay.co/es/solutions/payment-acceptance.md): Acepta pagos fiat y liquídalos automáticamente como stablecoins on-chain, sin una llamada a la API por pago, sobre cuentas virtuales Onramper. - [Trading de Divisas Fiat con Liquidación en Stablecoins](https://docs.spherepay.co/es/solutions/trading.md): Opera entre pares de divisas fiat usando stablecoins como puente de liquidación: BRL ↔ USD, USD ↔ EUR y nuevos corredores en SpherePay. - [Financiamiento Comercial Transfronterizo](https://docs.spherepay.co/es/solutions/cross-border-trade-finance.md): Liquida facturas y cuentas por cobrar internacionales en distintas divisas usando stablecoins como puente, para importadores, exportadores y plataformas. - [Gestión de Tesorería con Conversión Fiat a Stablecoin](https://docs.spherepay.co/es/solutions/treasury-management.md): Convierte fondos empresariales entre fiat y stablecoins para operaciones de tesorería — rendimiento, liquidación más rápida o estrategia multi-divisa. ### Referencia de la API #### Incorporación ##### Clientes - [Crear un Cliente Individual o Empresarial](https://docs.spherepay.co/es/api-reference/customer/post.md): Create a new customer. - [Listar Clientes con Filtros y Paginación](https://docs.spherepay.co/es/api-reference/customer/get.md): List customers with optional server-side search, filters, and sort. - [Recuperar un Cliente con Estado de Verificación](https://docs.spherepay.co/es/api-reference/customer/get-id.md): Get information about a customer by their ID - [Actualizar Dirección, Teléfono o Correo del Cliente](https://docs.spherepay.co/es/api-reference/customer/patch-id.md): Update a customer by their ID. (This endpoint only allows updates of personal information for individual customers) ##### Links de Incorporación - [Crear Cliente vía Link](https://docs.spherepay.co/es/api-reference/customer/kyc-link.md): Create a customer via the hosted onboarding link flow. Returns a KYC link and its expiry. - [Regenerar el Link KYC de un Cliente](https://docs.spherepay.co/es/api-reference/customer/kyc.md): Regenerate a hosted KYC link for an existing customer. Only customers created via the onboarding link flow are supported. ##### Documentos y Verificación - [Subir Documentos de Identidad KYC y KYB](https://docs.spherepay.co/es/api-reference/document/post.md): Upload a document for a customer. - [Generar un Link de Verificación Facial para el Cliente](https://docs.spherepay.co/es/api-reference/enhanced-due-diligence/face-verification-link.md): Generate a face verification link for a customer. - [Generar un Link de Verificación Facial de UBO para KYB](https://docs.spherepay.co/es/api-reference/enhanced-due-diligence/ubo-face-verification-link.md): Generate a face verification link for a business representative. - [Enviar un Código OTP para Verificación del Cliente](https://docs.spherepay.co/es/api-reference/enhanced-due-diligence/send-verification-code.md): Send an OTP code to a customer's contact information. - [Verificar un Código OTP del Cliente para Correo o Teléfono](https://docs.spherepay.co/es/api-reference/enhanced-due-diligence/verify-verification-code.md): Verify an OTP code for customer's contact information. - [Registrar la Aceptación de Términos de Servicio del Cliente](https://docs.spherepay.co/es/api-reference/enhanced-due-diligence/tos.md): Create a TOS link for a customer. ##### Representantes Empresariales - [Registrar un UBO Empresarial para Verificación KYB](https://docs.spherepay.co/es/api-reference/business-representative/post.md): Create a new business representative for a customer. - [Listar Todos los Representantes Empresariales y UBOs](https://docs.spherepay.co/es/api-reference/business-representative/get.md): List all business representatives for a customer - [Recuperar un Representante Empresarial por ID](https://docs.spherepay.co/es/api-reference/business-representative/get-id.md): Retrieve a business representative by their ID - [Actualizar un Representante Empresarial Antes del KYB](https://docs.spherepay.co/es/api-reference/business-representative/patch-id.md): Update an existing business representative - [Eliminar un Representante Empresarial o UBO](https://docs.spherepay.co/es/api-reference/business-representative/delete-id.md): Delete a business representative by their ID #### Cuentas ##### Cuentas Bancarias - [Registrar Cuenta Bancaria del Cliente para Transferencias](https://docs.spherepay.co/es/api-reference/bank-account/post.md): Create a new bank account for a customer. Requires at least one of the customer's verification profiles to be approved. - [Listar Todas las Cuentas Bancarias del Cliente Registradas](https://docs.spherepay.co/es/api-reference/bank-account/get.md): List all bank accounts for a customer with pagination - [Recuperar una Cuenta Bancaria por ID](https://docs.spherepay.co/es/api-reference/bank-account/get-id.md): Get information about a bank account by its ID - [Actualizar Configuración de Rieles de la Cuenta Bancaria](https://docs.spherepay.co/es/api-reference/bank-account/patch-id.md): Update a bank account by its ID. Update either the networks on a non-SWIFT account, or the intermediary BIC on a USD SWIFT account that does not already have one. - [Eliminar una Cuenta Bancaria del Cliente Registrada](https://docs.spherepay.co/es/api-reference/bank-account/delete-id.md): Delete a bank account by its ID. ##### Billeteras - [Registrar Billetera Cripto del Cliente para Transferencias](https://docs.spherepay.co/es/api-reference/wallet/post.md): Create a new wallet and associate it with a customer. - [Listar Todas las Billeteras Cripto del Cliente Registradas](https://docs.spherepay.co/es/api-reference/wallet/get.md): List all wallets with pagination. Optionally filter by customer. - [Recuperar una Billetera Cripto del Cliente por ID](https://docs.spherepay.co/es/api-reference/wallet/get-id.md): Get information about a wallet by its ID - [Eliminar una Billetera Cripto del Cliente Registrada](https://docs.spherepay.co/es/api-reference/wallet/delete-id.md): Delete a wallet by its ID #### Movimiento de dinero ##### Transferencias - [Crear una Transferencia On-Ramp u Off-Ramp](https://docs.spherepay.co/es/api-reference/transfer/post.md): Create a new transfer. - [Listar Transferencias On-Ramp y Off-Ramp](https://docs.spherepay.co/es/api-reference/transfer/get.md): List all transfers - [Recuperar una Transferencia con Instrucciones de Depósito](https://docs.spherepay.co/es/api-reference/transfer/get-id.md): Retrieve a specific transfer - [Cancelar una Transferencia Pendiente Sin Fondos](https://docs.spherepay.co/es/api-reference/transfer/delete-id.md): Cancel a specific transfer. ##### Cotizaciones - [Crear una Cotización con Tasa Bloqueada](https://docs.spherepay.co/es/api-reference/quote/post.md): Create a locked exchange rate quote. The quote is valid for the specified duration and can be used once to create a transfer. - [Listar Cotizaciones con Tasa Bloqueada de tu Cuenta](https://docs.spherepay.co/es/api-reference/quote/get.md): List quotes for the application. Repeat a currency parameter to match any supplied value; source and destination filters combine. - [Recuperar una Cotización por ID](https://docs.spherepay.co/es/api-reference/quote/get-id.md): Retrieve a single quote by its ID. - [Actualizar Estado de Cotización](https://docs.spherepay.co/es/api-reference/quote/put-id.md): Mark an active quote as used or expired. Only active quotes can be updated. ##### Cuentas Virtuales - [Crear una Cuenta Bancaria Virtual para On-Ramp de Fiat](https://docs.spherepay.co/es/api-reference/virtual-account/post.md): Create a new virtual account that converts incoming fiat deposits to crypto. - [Listar Todas las Cuentas Bancarias Virtuales Onramper](https://docs.spherepay.co/es/api-reference/virtual-account/get.md): List all active virtual accounts for the authenticated application. - [Recuperar un Onramper Account por ID](https://docs.spherepay.co/es/api-reference/virtual-account/get-id.md): Retrieve a virtual account by its ID. - [Actualizar la Billetera de Destino de un Onramper Account](https://docs.spherepay.co/es/api-reference/virtual-account/patch.md): Update the destination, network, or fee configuration of a virtual account. - [Listar Transferencias de un Onramper Account](https://docs.spherepay.co/es/api-reference/virtual-account/list-transfers.md): List the transfer history for a specific virtual account. Deprecated: the main `GET /v2/transfer` endpoint already returns virtual account transfers and will support filtering to the same effect. - [Desactivar una Cuenta Bancaria Virtual Onramper](https://docs.spherepay.co/es/api-reference/virtual-account/deactivate.md): Deactivate a virtual account so it no longer accepts deposits. - [Reactivar un Onramper Account Desactivado](https://docs.spherepay.co/es/api-reference/virtual-account/reactivate.md): Reactivate a previously deactivated virtual account. ##### Offloader Wallets - [Crear un Offloader Wallet para Pagos Cripto](https://docs.spherepay.co/es/api-reference/offloader-wallet/post.md): Create a new offloader wallet. - [Listar Todos los Offloader Wallets de tu Cuenta](https://docs.spherepay.co/es/api-reference/offloader-wallet/get.md): List all offloader wallets - [Recuperar un Offloader Wallet por ID](https://docs.spherepay.co/es/api-reference/offloader-wallet/get-id.md): Get an offloader wallet by id - [Actualizar el Destino Bancario de un Offloader Wallet](https://docs.spherepay.co/es/api-reference/offloader-wallet/patch-id.md): Update an offloader wallet by id #### Webhooks ##### Endpoints de Webhook - [Registrar un Endpoint de Webhook para Entrega de Eventos](https://docs.spherepay.co/es/api-reference/webhook-endpoints/post.md): Register a new webhook endpoint to receive event deliveries for the specified subscribed events. - [Listar Todos los Endpoints de Webhook Registrados](https://docs.spherepay.co/es/api-reference/webhook-endpoints/get.md): List all webhook endpoints for the authenticated application, with optional filtering by status and subscribed event types. - [Recuperar un Endpoint de Webhook por ID](https://docs.spherepay.co/es/api-reference/webhook-endpoints/get-id.md): Retrieve a webhook endpoint by its ID. - [Eliminar un Endpoint de Webhook](https://docs.spherepay.co/es/api-reference/webhook-endpoints/delete-id.md): Delete a webhook endpoint by its ID. Future events will no longer be delivered to it. ##### Eventos - [Listar Eventos y su Estado de Entrega](https://docs.spherepay.co/es/api-reference/events/get.md): List events for the authenticated application, with optional filtering by webhook endpoint, event type, delivery status, and creation date range. - [Recuperar un Evento con su Historial Completo de Entregas](https://docs.spherepay.co/es/api-reference/events/get-id.md): Retrieve an event by its ID. - [Reenviar una Entrega de Evento Fallida](https://docs.spherepay.co/es/api-reference/events/replay.md): Redeliver an event to its webhook endpoint by the ID of a prior delivery attempt. ### Notas - [Notas de Versión y Changelog de la API de SpherePay](https://docs.spherepay.co/es/changelog.md): Últimas actualizaciones de la API de SpherePay: nuevas funciones, cambios disruptivos, deprecaciones, cumplimiento y nuevos rieles y activos. ## OpenAPI Specs - [spherepay](/openapi/spherepay.yaml) ## Optional - [FAQ](https://spherepay-knowledge-base.help.usepylon.com/)