Cómo funciona la integración de la API de Upay: una guía completa para empresas

Tu negocio está perdiendo dinero si no aceptas pagos con criptomonedas. La global pasarela de pago criptográfico Se prevé que este mercado, valorado en 2.39 millones de dólares en 2026, alcance los 4.74 millones de dólares en 2030.

Sin embargo, el problema no radica en la demanda, sino en la configuración. La mayoría de las empresas no saben por dónde empezar. Ahí es donde entra en juego la integración de la API de Upay.

Upay ofrece a las empresas una forma sencilla y amigable para los desarrolladores de aceptar pagos con criptomonedas, emitir tarjetas de marca y enviar pagos a nivel mundial sin necesidad de construir una infraestructura de pago desde cero.

Puntos Clave

• La integración de la API de Upay permite a las empresas aceptar pagos con criptomonedas, emitir tarjetas de marca y enviar pagos sin necesidad de construir una infraestructura de pago desde cero.
• El proceso de integración consta de varios pasos: registrarse, leer la documentación, configurar el entorno de pruebas, generar claves API, realizar la primera solicitud, configurar los webhooks y ponerlo en marcha.
• Cada solicitud a la API de Upay requiere una lista blanca de IP, cuatro encabezados personalizados y una firma criptográfica válida por 60 segundos.
• El entorno de pruebas está disponible para todos los socios y permite realizar pruebas de forma segura antes del lanzamiento.
  

Lea también: Las mejores tarjetas de criptomonedas compatibles con Apple Pay y Google Pay.

¿Qué es Upay?

Fundada en 2023, Upay es una plataforma global de pagos con criptomonedas diseñada para transferir dinero, no solo para almacenarlo. Mientras que muchos proveedores se centran exclusivamente en monederos o exchanges, Upay combina infraestructura de pagos, emisión de tarjetas, aceptación de criptomonedas y capacidades de desembolso en un único ecosistema diseñado tanto para consumidores como para empresas.

La empresa opera dos plataformas distintas. Su oferta para el consumidor, disponible a través de Upay.bestProporciona a los usuarios una billetera de criptomonedas y tarjetas de pago vinculadas a criptomonedas para gastar activos digitales en todo el mundo. 

Por el lado comercial, business.upay.com Ofrece una infraestructura de nivel empresarial que permite a las empresas aceptar pagos con criptomonedas, lanzar tarjetas Visa de marca propia a través de su solución de marca blanca, gestionar monederos y automatizar pagos masivos mediante una API unificada.

Lo que distingue a Upay es su enfoque centrado en los pagos. En lugar de ofrecer servicios de criptomonedas independientes, proporciona una infraestructura financiera integral que ayuda a las empresas a conectar la tecnología blockchain con las finanzas tradicionales.

Mediante una única integración, las empresas pueden aceptar criptomonedas, convertir fondos y emitir tarjetagestionar el cumplimiento normativo y liquidar pagos a nivel mundial.

La seguridad y el cumplimiento normativo son fundamentales para la plataforma. Upay cuenta con licencia de Dubái y trabaja con SlowMist como socio de seguridad, StraitsX como socio de liquidación, Sumsub como socio de verificación de identidad (KYC) y Tencent Cloud para la infraestructura.

Se trata de una plataforma que prioriza el cumplimiento normativo y está diseñada para empresas que necesitan soluciones de pago seguras, escalables y reguladas para sus operaciones globales.

¿Qué es una API y por qué es importante para los pagos?

Fuente: business.upay.com

Una API (Interfaz de Programación de Aplicaciones) es un puente entre dos sistemas de software. Permite que tu sitio web o aplicación se comunique con otra plataforma e intercambie información automáticamente.

Imagínalo como un sistema de pedidos en un restaurante: le dices al camarero lo que quieres. El camarero va a la cocina, donde se prepara la comida y se la devuelven. Tú nunca ves la cocina. 

An API Funciona de la misma manera. Tu sitio web envía una solicitud, el sistema de Upay la procesa y devuelve una respuesta. Tu cliente nunca ve nada del proceso interno.

Sin una API, aceptar criptomonedas requeriría ejecutar su propio sistema. blockchain nodo, supervisión manual de las transacciones entrantes, gestión de conversiones de divisas y creación de su propia capa de seguridad.

Eso supone meses de ingeniería. Sin embargo, con la integración de la API de Upay, te conectas una sola vez y la plataforma se encarga del resto.

Lea también: Símbolo de la criptomoneda: Las tres letras que representan todo un proyecto criptográfico.

Qué puedes hacer con la integración de la API de Upay

La API de Upay Business abarca varias funcionalidades básicas y se puede consultar en https://upay-api.readme.io/reference/api-list.

Aceptación de pagos con criptomonedas (API del adquirente)

Permita que su negocio acepte pagos con criptomonedas de clientes de todo el mundo con una infraestructura de pago fluida.

La API del adquirente genera direcciones de monedero únicas para cada transacción, lo que permite realizar un seguimiento preciso de los pagos y automatizar la conciliación. 

También permite crear y gestionar pedidos, procesar reembolsos y cancelar transacciones cuando sea necesario, lo que brinda a los comerciantes un control total sobre el ciclo de vida del pago, al tiempo que simplifica la aceptación de criptomonedas a gran escala.

Emisión de tarjetas (API de tarjetas)

Lanza tarjetas de pago virtuales y físicas con tu marca sin necesidad de crear la infraestructura desde cero. La API de tarjetas te permite emitir tarjetas a tus clientes y gestionar cada etapa de su ciclo de vida, desde la activación y la financiación hasta el bloqueo, el desbloqueo y la cancelación. 

UPay, a través de su solución de marca blanca, se encarga de la fabricación, el procesamiento y la entrega de las tarjetas, lo que permite a las empresas ofrecer un programa de tarjetas totalmente personalizado con una mínima inversión operativa.

Gestión de monederos de criptomonedas (API de monedero)

Integra la funcionalidad de monedero de criptomonedas seguro directamente en tu plataforma. La API de monedero permite a las empresas generar y gestionar direcciones de monedero, supervisar depósitos, procesar retiros y transferir activos digitales de forma eficiente. 

Los controles integrados contra el blanqueo de capitales ayudan a examinar las transacciones entrantes y a cumplir con los requisitos normativos, lo que la convierte en una solución ideal para bolsas de valores, plataformas fintech y aplicaciones que custodian fondos en nombre de los usuarios.

Pagos (API de desembolsos)

Automatice los pagos de criptomonedas a particulares o empresas en cualquier parte del mundo. La API de Outlay permite a las plataformas enviar fondos a direcciones de monederos externos de forma rápida y eficiente, ya sea para nóminas, pagos a autónomos, comisiones de afiliados, programas de recompensas o desembolsos masivos. 

Diseñado para transacciones de alto volumen, agiliza las operaciones de pago al tiempo que reduce la complejidad de gestionar transferencias de criptomonedas a gran escala.

Cómo funciona la integración de la API de Upay, paso a paso.

Así es como funciona el proceso de integración de la API de Upay, desde el registro hasta la primera transacción en vivo.

Paso 1: Regístrate y completa el proceso KYC.

Fuente: business.upay.com

Primero, deberá ponerse en contacto directamente con su equipo comercial a través de Sitio web de Upay para solicitar acceso a su infraestructura B2B escalable y herramientas API.

Una vez en la página web, desplácese hacia abajo hasta «Colabora con nosotros» y haga clic en la pestaña. Se abrirá la página con la imagen de arriba; complete la información requerida en la sección «Consulta», seleccione la pestaña «Integración de API» y haga clic en la pestaña «Solicitar demostración gratuita».

Una vez que el equipo de Upay se ponga en contacto contigo, descarga Upay desde el sitio web o a través de la App Store de Apple o Google Play Store y crea una cuenta de empresa. 

Antes de acceder a la API, deberá completar la verificación de identidad (KYC). Este proceso es estándar en cualquier plataforma de pago regulada y protege tanto a usted como a sus clientes.

Paso 2: Lea la documentación para desarrolladores.

Cada API viene con documentación que funciona como manual de instrucciones. Explica los puntos finales disponibles, qué datos enviar y qué esperar como respuesta.

Lea la documentación antes de escribir una sola línea de código. Upay proporciona documentación completa de la API a través de su portal para desarrolladores en https://upay-api-en.readme.io.

Paso 3: Obtenga la clave pública/clave API/clave secreta de la plataforma.

Fuente: upay-api-en.readme.io

Obtén la clave API pública/clave API/clave secreta de la plataforma desde tu panel de control de comerciante. Una clave API es una larga cadena de caracteres que funciona como contraseña de tu cuenta al comunicarte con el sistema Upay.

• Clave API: Proporcionada por UPay, un identificador único para el comerciante.
• Clave secreta: Se utiliza para firmar los datos al solicitar la API.
• Clave pública de la plataforma: Proporcionada por UPay, se utiliza para cifrar los parámetros al solicitar la API.
• Clave privada de la plataforma: Utilizada por UPay para descifrar los parámetros tras recibir la solicitud de la API y obtener los datos originales.

Ejemplo: 

—–COMIENZO DE LA CLAVE PÚBLICA—–

MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2r69mrDofiNPIAKNRV5v

BeVBjEnrYPgKf8LKDK+gLhLrepuTc+gxlJurH/gYwgRwD8DL5rmdcXRZMpX+L8gx

yszzD0qFWnBoumN1RHx2kkok1vgLr/dBlJRwVPZbZT69m/B8kGWR8JboBVOWJwxn

DX6WaRDyWVa2qu1KogQq4m028gJWZlVzs0bSExQqSW5ZiUFGyJygjTa2XAKqceSe

xHov8jR66mpnv0vJy6+4YJK34t2VzyNdEqseTE3spZkSJCzzxNV7xIs63u/WTenK

J1BWar+/rA63A+/0Lt2BB/Uf/iq0OwGm4t2d0Pf1O7hylXXP65BGunWvu0QWCsNo

xQIDAQAB

—–FIN DE LA CLAVE PÚBLICA—–

Importante: Nunca incluyas tu clave API directamente en el código de la interfaz de tu sitio web. Guárdala de forma segura en tu servidor, ya que cualquiera que la encuentre podrá realizar solicitudes en tu nombre.

Paso 4: Configurar la clave pública del comerciante

Fuente: upay-api-en.readme.io

clave pública del comercianteEl comerciante configura la clave pública generada en la plataforma del comerciante. Si una solicitud de API está cifrada, los datos de respuesta también lo estarán.

UPay cifrará los datos de respuesta utilizando la clave pública del comerciante.

clave privada del comercianteTras obtener los datos de respuesta de la API, el comerciante los descifra utilizando su clave privada para recuperar los datos de respuesta originales.

Paso 5: Crear API de solicitud de pago

Cuando un cliente elige pagar con criptomonedas, tu sistema backend envía una solicitud a la API de Upay. La solicitud le indica a Upay: Un cliente desea pagar. Genera una dirección de pago.

POST /v2/pagos/direcciones

{ “chain”: “ETH”, “asset”: “USDT”, “label”: “order_00245”, “callback_url”: “https://yourshop.com/webhooks/crypto” }

Respuesta: { “dirección”: “0x742d35Cc6634C0532925a3b844Bc…”, “activo”: “USDT”, “creado_en”: “2026-05-18T10:30:00Z” }

Así es como se ve esa solicitud en términos sencillos:

• Lo que usted envía: La cantidad, la moneda (por ejemplo, USDT) y una URL de devolución de llamada (su punto final de webhook).
• Lo que obtienes a cambio: Una dirección de monedero única y un código QR para que el cliente lo escanee.
  

Cada pedido recibe una dirección de monedero única. Esto evita que las transacciones se solapen y facilita la conciliación.

Paso 6: Configurar webhooks

Un webhook es una notificación automática que Upay envía a su servidor cuando se confirma un pago en la cadena de bloques.

En lugar de que tu sistema pregunte repetidamente: "¿Ha llegado el pago?", Upay te avisa en el momento en que llega. Imagínalo como una notificación de entrega de mensajería.

No es necesario actualizar constantemente la página de seguimiento; basta con esperar el mensaje de texto. Cuando llega el webhook, el sistema actualiza el estado del pedido, envía una confirmación al cliente y activa el siguiente paso del proceso de gestión de pedidos.

Lea también: ¿Qué significa 5x en criptomonedas?

Paso 7: Establecer una lista blanca de direcciones IP.

Fuente: upay-api-en.readme.io

Restrinja el acceso a la API especificando las direcciones IP permitidas para la conexión. Si no se configura ninguna dirección IP, la API acepta solicitudes de todas las direcciones IP por defecto.

Puedes incluir varias direcciones IP en la lista blanca separándolas con comas.

Ejemplo : 127.0.0.1, 127.0.0.2

Paso 8: Configura tu entorno de pruebas

Un entorno de pruebas (sandbox) es un entorno donde no se mueve dinero real. Refleja exactamente el sistema en vivo. El entorno de pruebas de Upay está disponible en: https://openapi.upay-test.best y es accesible para todos los socios desde el primer día. 

Utilice el entorno de pruebas para simular pagos, activar notificaciones webhook y comprobar cómo su sistema gestiona los pagos fallidos o parciales. Este paso es muy importante, así que no lo omita.

Paso 9: Vaya en vivo

Una vez que todo esté probado y verificado, cambie del modo de prueba al modo de producción utilizando su clave API. Upay comparte las credenciales del entorno de producción directamente con los socios aprobados tras la revisión de incorporación. Ahora, los pagos reales pueden procesarse a través de su sistema.

Entorno de la API de UPay 

UPay ofrece entornos de prueba y producción independientes, lo que permite a los desarrolladores probar las integraciones de forma segura antes de su lanzamiento. Crea y valida tus flujos de pago en el entorno de prueba y, cuando estés listo para procesar transacciones reales, cámbialo al entorno de producción.

Medio Ambiente	URL	Mareas Ideales para Lecciones
Prueba	https://openapi.upay-test.best	Disponible para todos los socios para la creación y prueba de su integración.
STG (Etapa)	actualmente no está disponible	N/A
Producción	No revelado públicamente	El entorno de modo en vivo proporcionado por Upay

Seguridad de la API de Upay: Condiciones y restricciones de acceso

Cada solicitud de API a Upay debe cumplir cuatro requisitos de seguridad.

factor de seguridad	Que hace	Obligatorio
Lista blanca de IP	La dirección IP de su servidor debe estar registrada en Upay antes de que se acepten las solicitudes.	Cierto
Verificación de IP de respuesta	Su sistema solo acepta respuestas de la dirección IP verificada de Upay.	Cierto
Devoluciones de llamada de webhook	Algunas transacciones activan una segunda confirmación a través de un webhook.	Falso
Ventana de firma de 60 segundos	Cada solicitud firmada caduca después de 60 segundos para bloquear los ataques de repetición.	Sí:

El lapso de 60 segundos es crucial. Un ataque de repetición ocurre cuando alguien intercepta una solicitud válida e intenta reenviarla posteriormente.

La ventana de firma lo impide. Asegúrese de que el reloj de su servidor esté sincronizado mediante NTP (Protocolo de Tiempo de Red) antes de comenzar la integración.

Encabezados de solicitud/respuesta de la API de Upay

Cada solicitud/respuesta requiere cuatro encabezados HTTP personalizados. Estos encabezados trabajan en conjunto para verificar que cada solicitud sea genuina, oportuna y provenga de la cuenta correcta.

• X-UPA-APIKEY: Esta es tu clave API única asignada por UPay. Solo quienes posean esta clave podrán realizar llamadas.
• ID DE SOLICITUD X-UPA: Un identificador único para cada solicitud para evitar el procesamiento duplicado.
• X-UPA-TIMESTAMP: La marca de tiempo actual en milisegundos
• X-UPA-SIGN: Una firma criptográfica que demuestre que la solicitud no ha sido alterada.
  

Solicitar encabezados

Campo	Tipo de datos	Explicación	Efecto
X-UPA-APIKEY	Cordón	Solicitud de clave API	Identificar y diferenciar a los usuarios de marca blanca
ID DE SOLICITUD X-UPA	Cordón	Solicitud de un código único	Solicitar idempotencia
Marca de tiempo X-UPA	Cordón	Marca de tiempo en milisegundos	Tiempo de solicitud: si no se recibe respuesta en 60 segundos, se agotará el tiempo de espera y no se responderá a esta solicitud. Previene ataques de repetición.
X-UPA-SIGN	Cordón	Firma	Firma para verificar la autenticidad y veracidad del solicitante.

Encabezados de respuesta

Campo	Tipo de datos	Explicación
ID DE SOLICITUD X-UPA	Cordón	Solicite un código único idéntico al ID de la solicitud para garantizar la coherencia en la respuesta.
Marca de tiempo X-UPA	Cordón	Marca de tiempo de respuesta, marca de tiempo, milisegundos

Un ejemplo real de la integración de la API de Upay en acción.

Tunde, un comerciante de productos digitales con sede en Lagos, vende a clientes en Nigeria, el Reino Unido, Canadá y los Emiratos Árabes Unidos. Anteriormente, las transferencias bancarias internacionales solían tardar varios días hábiles en procesarse e implicaban costosas comisiones por cambio de divisa.

Tras integrar la API de Upay en su proceso de pago, los pagos se volvieron prácticamente instantáneos. Cuando un cliente en Toronto selecciona "Pagar con criptomonedas", el sistema de Tunde envía una solicitud a Upay, que genera una dirección de pago y un código QR únicos en USDT. 

El cliente realiza el pago desde su billetera y Upay monitorea y verifica automáticamente la transacción en la cadena de bloques. Una vez confirmada, un webhook notifica a la plataforma de Tunde, lo que activa el procesamiento y la entrega del pedido.

Todo el proceso lleva menos de dos minutos, eliminando las demoras bancarias y reduciendo los costos de pago innecesarios. Según Datos de propiedad de Triple-AEn 2024, la posesión mundial de criptomonedas alcanzó aproximadamente los 562 millones de personas, un 34 % más que los 420 millones del año anterior. 

Ese crecimiento es precisamente la razón por la que cada vez más empresas como la de Tunde están añadiendo una opción de pago con criptomonedas en lugar de tratarla como una característica de nicho, y UPay está ofreciendo este servicio a escala global.

¿Por qué las empresas eligen Upay?

Si buscas integrar pagos con criptomonedas sin la complejidad técnica, UPay ofrece una solución práctica y escalable. Su negocio.

La API ofrece a los comerciantes múltiples activos, personalización de tarjetas con marca blanca y mucho más, con liquidaciones instantáneas y conversión automática de criptomonedas a moneda fiduciaria. 

Con el respaldo de registros regulatorios en EE. UU., Canadá, Hong Kong y los Emiratos Árabes Unidos, UPay ofrece la seguridad, el cumplimiento normativo y el alcance global necesarios para agilizar los pagos modernos con criptomonedas y respaldar el crecimiento a largo plazo.