Cómo aceptar pagos con criptomonedas en Arbitrum One: guía para comercios

Aceptar pagos con criptomonedas en Arbitrum One no es tan sencillo como mostrar una dirección de estilo Ethereum. Un flujo de pago listo para producción debe indicar al cliente qué red y token debe usar, reconocer el contrato correcto, seguir la transferencia hasta que alcance un estado de confirmación adecuado y asociarla a un único pedido sin realizar la entrega dos veces.

Arbitrum One utiliza billeteras EVM conocidas y direcciones 0x, pero esa familiaridad puede ocultar errores. Un cliente puede elegir Ethereum, Base, Arbitrum Nova u otra red compatible y seguir viendo una dirección que parece válida. La transferencia resultante puede ser real y, aun así, no pagar el pedido de Arbitrum One.

Esta guía explica los controles que un comercio necesita para usar pagos en Arbitrum One en producción: configuración de la billetera, USDC nativo y transferido mediante puente, gas en ETH, etiquetas de la página de pago, política de confirmación, idempotencia de webhooks, reembolsos y registros financieros. La página de pagos en Arbitrum de Yolfi describe enlaces de pago, pagos recurrentes, eventos y webhooks, así como la liquidación directa y sin custodia en la billetera del comercio. Considera estas funciones como capacidades del producto que debes evaluar y confirma después las opciones exactas de activos y redes en tu configuración autenticada antes de ofrecérselas a los clientes.

Empieza por la red Arbitrum exacta

«Arbitrum» puede referirse a todo un ecosistema, no a un destino de pago único. En esta guía, la red de producción prevista es la red principal de Arbitrum One.

La guía oficial de inicio rápido del puente de Arbitrum enumera los parámetros principales de la billetera:

Una solicitud de pago completa debe conservar más información que una dirección de destino. Guarda:

• Arbitrum One como red solicitada;
• el ID de cadena 42161 para validar la integración;
• el activo nativo o el contrato exacto del token;
• la dirección de liquidación del comercio;
• el importe exacto y el vencimiento de la cotización, si corresponde;
• un identificador de pedido, factura o solicitud de pago;
• el hash y el estado de la transacción detectada;
• el resultado de la entrega y cualquier reembolso posterior.

No reduzcas las instrucciones para el cliente a «envía por Arbitrum» si tu sistema espera específicamente Arbitrum One. Arbitrum Nova y las redes de prueba de Arbitrum tienen otros ID de cadena. Una dirección EVM por sí sola no puede comunicar esa diferencia.

Decide si Arbitrum One es adecuado para tus clientes

Arbitrum One es una opción razonable si los clientes ya mantienen fondos allí, utilizan billeteras que permiten seleccionarla con claridad o pueden retirar fondos directamente a esa red desde su proveedor habitual. Puede ser adecuada para suscripciones de software, servicios en línea, productos digitales, facturas, comunidades y productos de saldo para cuentas destinados a clientes que usan criptomonedas de forma habitual.

La pregunta importante no es si la red puede procesar transferencias de tokens, sino si funciona todo el recorrido del cliente y del comercio:

• ¿Los clientes ya poseen el activo previsto en Arbitrum One?
• ¿Pueden elegir Arbitrum One al retirar fondos de una plataforma de intercambio?
• ¿La billetera mostrará con claridad la red y el contrato del token?
• ¿El equipo de atención puede investigar una transferencia realizada en la red o con el token equivocados?
• ¿El equipo financiero puede valorar y conciliar el activo?
• ¿La empresa puede realizar reembolsos y transferencias de tesorería de forma segura?

Evita afirmaciones fijas sobre el coste o la velocidad de las transacciones. La estimación actual de la billetera, las condiciones de la red, la propia transacción y la política de riesgo del comercio influyen en la experiencia real. Un cliente que primero tenga que retirar o transferir fondos mediante un puente también afrontará costes y pasos ajenos a la transacción de pago final. Si estás comparando alternativas, utiliza un marco más amplio para elegir la mejor blockchain para pagos con stablecoins.

Elige el activo antes de crear la página de pago

La compatibilidad con la red y la compatibilidad con el activo son cuestiones distintas. Que una billetera pueda usar Arbitrum One no demuestra que tu sistema de pago acepte todos los tokens de esa red.

USDC nativo en Arbitrum One

USDC puede ser un buen activo inicial para productos cuyo precio se expresa en dólares estadounidenses, porque el importe solicitado en tokens es más fácil de entender que una cotización de ETH que cambia continuamente. Aun así, conlleva riesgos relacionados con el emisor, el contrato, la pérdida de paridad, la regulación, la billetera y la red.

El directorio de contratos de USDC oficial de Circle indica que la dirección de USDC nativo en Arbitrum es:

0xaf88d065e77c8cC2239327C5EDb3A432268e5831

La dirección es el identificador relevante. Un nombre, un símbolo, un icono o un valor de mercado aproximado no bastan, porque las billeteras pueden mostrar activos diferentes con etiquetas similares.

Antes de anunciar «USDC en Arbitrum One», compara esta dirección publicada por el emisor con el contrato que reconoce el flujo de pago de tu configuración autenticada. Vuelve a comprobarla durante la revisión de la integración en lugar de copiar una dirección de un resultado de búsqueda, una sugerencia de la billetera o un mensaje de un cliente.

USDC nativo y USDC transferido mediante puente no son intercambiables

Arbitrum One cuenta tanto con USDC nativo como con una versión transferida mediante puente que suele mostrarse como USDC.e. Utilizan contratos diferentes. Un cliente puede tener un token denominado en dólares llamado USDC.e y, aun así, no poseer el activo solicitado por una página de pago de USDC nativo.

Para las operaciones del comercio, aplica esta regla: un contrato diferente representa un activo de pago diferente. No abones automáticamente un pedido solo porque el símbolo o el valor mostrado parezcan similares.

Esta es una lista de comprobación para lanzar pagos con USDC de forma segura:

1. Confirma que la configuración autenticada disponible en producción ofrece la modalidad de USDC prevista en Arbitrum One.
2. Registra el contrato del token admitido junto con la configuración del pago.
3. Compara el USDC nativo con el directorio de contratos vigente de Circle.
4. Usa una etiqueta explícita para el cliente, como «USDC nativo en Arbitrum One».
5. Realiza una transferencia de poco valor desde las billeteras que probablemente usarán los clientes.
6. Comprueba que USDC.e u otro contrato que no coincida se rechace o se envíe a revisión.
7. Proporciona al equipo de atención un procedimiento escrito para las discrepancias entre contratos.

Si un cliente necesita mover fondos a la red, remítelo a la guía oficial de inicio rápido de Arbitrum en lugar de improvisar instrucciones para usar un puente. La propia documentación del puente advierte que Arbitrum One admite versiones nativas y transferidas mediante puente de USDC. Usar un puente es una acción independiente del usuario y tiene sus propios riesgos; no la conviertas en una condición oculta del proceso de pago.

ETH y otros tokens

ETH es la moneda para pagar el gas en Arbitrum One y también puede utilizarse como activo de compra si esa opción exacta aparece en la configuración autenticada del comercio. En productos cuyo precio se expresa en una moneda de referencia, define cómo se calcula la cotización en ETH, cuándo vence y qué ocurre con los pagos tardíos, insuficientes o excesivos.

Ofrece otro token solo cuando ese token exacto de Arbitrum One esté disponible en la configuración activa y la empresa pueda verificar su contrato, asignarle un precio, conservarlo o convertirlo, conciliarlo y reembolsarlo. Que sea técnicamente posible transferirlo a una billetera no significa que esté disponible como opción de pago admitida.

Explica el gas de Arbitrum sin prometer una comisión

En una transacción ordinaria de Arbitrum One, el remitente paga el gas con ETH en Arbitrum One. Un cliente puede tener USDC suficiente para la factura, pero no disponer de ETH para enviar la transferencia del token.

Mantén separados estos tres importes:

• el importe de la compra que espera el comercio;
• la comisión de red que la billetera estima en ETH;
• cualquier comisión del proveedor o de la empresa que el comercio comunique por separado.

Si la factura solicita 60 USDC, el cliente debe enviar 60 USDC y disponer además de ETH en Arbitrum One para el gas. No debe restar del importe en USDC una comisión denominada en ETH.

La guía de estimación del gas oficial de Arbitrum recomienda el flujo estándar eth_estimateGas para estimar una transacción y señala que la estimación puede variar a medida que cambia el precio de los datos de llamada en la cadena principal. En la página de pago, deja que una billetera conectada calcule una estimación actual. No publiques una comisión permanente ni prometas que todas las transferencias costarán lo mismo.

El texto de ayuda para los clientes debe indicar que «se necesita ETH en Arbitrum One para pagar el gas». El ETH que solo existe en la red principal de Ethereum o en otra red no puede pagar la comisión de una transacción de Arbitrum One. Si tu flujo activo utiliza otro mecanismo de gas, patrocinio o abstracción, documenta el comportamiento que muestre realmente esa configuración autenticada en lugar de presuponer el modelo de transferencia ordinario.

Crea el flujo de pago para el comercio

1. Confirma la disponibilidad real

Inicia sesión en la configuración del comercio y revisa tanto la pantalla de configuración como la página de pago del cliente. Registra los activos exactos de Arbitrum One disponibles para tu cuenta. Si la red y el token previstos no aparecen, no los anuncies.

La página pública de Yolfi sirve como indicio de la dirección y las capacidades del producto, no como garantía de que todos los tokens estén disponibles para todas las cuentas, jurisdicciones o modalidades. Vuelve a comprobar la disponibilidad autenticada antes del lanzamiento y después de cambios importantes en el producto o la cuenta.

2. Configura una billetera de liquidación controlada

Utiliza una billetera compatible con Arbitrum One y controlada de acuerdo con la política de la empresa. Verifica el destino de forma independiente antes de aceptar pagos. Define:

• quién puede cambiar la dirección de liquidación;
• cómo se protegen y respaldan las claves o los dispositivos de firma;
• si los cambios de dirección y los reembolsos necesitan una segunda aprobación;
• cómo se registran y prueban todos los cambios de configuración;
• cómo se mantiene ETH suficiente en Arbitrum One para las transacciones salientes aprobadas;
• cómo distingue el equipo financiero una misma dirección y un token de aspecto idéntico entre distintas redes.

Yolfi describe en su página pública de Arbitrum la liquidación directa y sin custodia en la billetera del comercio. Confirma ese comportamiento para la modalidad exacta disponible en producción. La liquidación directa elimina la necesidad de retirar fondos de un saldo mantenido por el proveedor, pero el comercio sigue siendo responsable de la seguridad de la billetera, el acceso a la tesorería, los reembolsos y la contabilidad.

3. Elige enlaces de pago, una página de pago o acceso recurrente

Un enlace de pago con criptomonedas es un punto de partida práctico para una factura, un proyecto de consultoría, un pedido personalizado o un producto de entrega manual. Añade un importe solicitado y el contexto del pago sin exigir una integración completa.

Utiliza una página de pago integrada cuando un pago confirmado deba crear automáticamente una cuenta, emitir créditos, entregar un archivo, activar una licencia o actualizar un pedido. Conserva la red, el contrato, el importe, los datos de la cotización, el ID de la solicitud de pago, el hash de la transacción, el historial de estados y el estado de la entrega.

La página pública del producto Arbitrum también describe pagos recurrentes y eventos de pago. Consulta las suscripciones con criptomonedas si la empresa necesita renovaciones y después verifica el activo concreto de Arbitrum One disponible en la configuración autenticada. No presupongas que «recurrente» significa un débito automático de la billetera. Define el aviso de renovación, el plazo de pago, el periodo de gracia, el procedimiento de cancelación, la regla de acceso y el tratamiento de eventos duplicados.

4. Elimina las ambigüedades de la página de pago

Repite la red junto al token, el importe, el código QR y el botón de la billetera. Algunas instrucciones útiles son:

• «Envía 60 USDC nativos en Arbitrum One».
• «Utiliza únicamente la red principal de Arbitrum One (ID de cadena 42161)».
• «Necesitas ETH en Arbitrum One para pagar la comisión de red».
• «No envíes USDC.e ni USDC desde otra red».

Si hay varias redes disponibles, exige una elección explícita antes de abrir la billetera. Nunca muestres solo «USDC» y elijas Arbitrum One sin avisar. La guía más amplia sobre cómo evitar pagos con criptomonedas en la red equivocada explica la prevención, la recopilación de pruebas y la respuesta ante incidentes.

5. Prueba un pago real de poco valor

Utiliza la misma página de pago y el mismo traspaso a la billetera que usará un cliente. Confirma que:

1. la página indica Arbitrum One y el activo exacto;
2. la billetera selecciona el ID de cadena 42161;
3. el destino y el importe coinciden con la solicitud de pago;
4. el USDC nativo utiliza el contrato de Circle previsto;
5. el gas en ETH se muestra por separado;
6. el envío genera un estado pendiente en vez de activar una entrega inmediata;
7. el estado confirmado adecuado llega al sistema de pedidos;
8. un evento repetido no repite la entrega;
9. el equipo financiero puede relacionar la solicitud, la transacción, la recepción en la billetera y el pedido;
10. se puede completar el procedimiento controlado de reembolso.

Repite la prueba después de cambiar la billetera de liquidación, el activo, el código de la página de pago, el punto de conexión de eventos, la regla de confirmación o la lógica de entrega.

Trata las confirmaciones y la finalidad como una política, no como un eslogan

El hash de una transacción solo demuestra que hay algo que inspeccionar. La transacción puede estar pendiente, haber fallado, haberse enviado en otra red, utilizar un contrato incorrecto, transferir un importe equivocado o estar ya asignada a otro pedido.

Antes de aceptar un pago, verifica que:

• la transacción esté en Arbitrum One;
• el activo y el contrato coincidan con la solicitud;
• el destino sea la billetera configurada del comercio;
• el importe recibido cumpla la política del pedido;
• el pago haya alcanzado el estado requerido;
• la transacción no se haya utilizado para otro pedido;
• el pedido no se haya entregado ya.

El envío, la inclusión, la confirmación y la decisión del comercio de entregar el producto son estados diferentes. Utiliza el estado confirmado que exponga el flujo de pago y cualquier política adicional apropiada para el valor del pedido, la posibilidad de revertir la entrega, el riesgo de fraude y la infraestructura disponible. No prometas un número fijo de segundos, una cantidad universal de confirmaciones ni una finalidad irreversible inmediata.

Para los pedidos de mayor riesgo, documenta quién puede retener un pago para revisarlo y qué pruebas permiten liberarlo. En el caso de bienes digitales de bajo riesgo, la automatización puede ser adecuada, pero solo después de que coincidan todos los campos de aceptación.

Diseña webhooks que admitan reintentos de forma segura

Los eventos de pago y los webhooks son útiles porque permiten que la página de pago actualice el pedido sin pedir al cliente que recargue el navegador. Confirma que los eventos estén disponibles para el flujo exacto de Arbitrum One en producción y sigue después el método de autenticación documentado para la integración.

Guarda como mínimo:

• el ID del evento y el ID de la solicitud de pago;
• el hash de la transacción, la red, el activo y el contrato;
• el estado comunicado y la hora de creación del evento;
• los intentos de procesamiento y su resultado;
• el único registro de entrega asociado al pedido.

La entrega de un webhook puede retrasarse o repetirse. Crea un controlador idempotente: aunque el mismo evento confirmado se procese varias veces, solo debe generar una licencia, un abono de saldo, un envío o una ampliación de la suscripción. Una restricción de unicidad aplicada a un identificador estable del pago o el evento, combinada con una actualización duradera del estado del pedido, es más sólida que un indicador de «ya visto» almacenado en memoria.

No utilices la página de retorno del navegador como prueba de pago ni dependas de los webhooks como único registro contable. Ejecuta un proceso de conciliación que compare las solicitudes de pago, los registros de pagos confirmados, las transacciones de Arbitrum One, la actividad de la billetera de liquidación y los pedidos entregados. Así podrás detectar notificaciones perdidas y fallos internos sin asignar transferencias arbitrarias de la billetera a pedidos.

Define cómo gestionar las excepciones y los errores de red

Redacta la política antes de que el equipo de atención reciba la primera reclamación sobre un pago:

• Pago insuficiente: mantén el pedido sin pagar o en revisión conforme a una regla de tolerancia documentada.
• Pago excesivo: registra el importe recibido completo y revisa el excedente por separado.
• Pago tardío: decide si aceptarás la cotización anterior, solicitarás la diferencia o realizarás un reembolso.
• Pago duplicado: entrega una sola vez e investiga la transferencia adicional por separado.
• Contrato incorrecto: no abones automáticamente USDC.e u otro activo similar como si fuera USDC nativo.
• Red incorrecta: verifica qué cadena se utilizó realmente y nunca prometas que la recuperación sea posible.
• Transferencia desconocida: no la asocies al pedido más parecido sin pruebas.

Ante un aviso de red incorrecta, recopila la referencia del pedido, el hash de la transacción, la cadena utilizada, el contrato del token, el destino, el importe y la dirección de la billetera. Verifica esos datos de forma independiente. Una captura de pantalla puede respaldar el aviso, pero no sustituye los datos de la transacción.

Como una misma clave privada puede controlar una dirección coincidente en varias redes EVM, a veces la recuperación puede ser técnicamente posible. Eso no significa que sea segura ni que esté aprobada desde el punto de vista operativo. Las direcciones controladas por contratos, los acuerdos de custodia, los entornos de firma no compatibles, las normas de cumplimiento y la política de seguridad pueden impedir la recuperación. Escala el caso mediante un proceso controlado en lugar de pedir al personal que importe claves o improvise un puente.

Planifica los reembolsos y la conciliación antes del lanzamiento

Un reembolso en Arbitrum One es una nueva transacción saliente, no una reversión de la recepción original. Antes de enviarlo:

1. verifica el pedido original y el pago confirmado;
2. confirma el activo y el importe de reembolso aprobados;
3. autentica al cliente y el destino mediante un canal controlado;
4. indica quién asume la comisión de red;
5. obtén la aprobación interna necesaria;
6. comprueba que la billetera de firma disponga del token y de ETH en Arbitrum One;
7. registra por separado la transacción saliente.

No copies una dirección de sustitución desde un correo electrónico o mensaje de chat inesperado. El pagador original, el titular de la cuenta y el destino solicitado para el reembolso pueden ser distintos, y un atacante puede intentar sustituir una dirección.

Para el equipo financiero, conserva:

• las referencias del pedido, la factura, el cliente y la solicitud de pago;
• Arbitrum One, el activo y el contrato del token;
• los importes solicitados y recibidos en criptomonedas;
• el valor en la moneda de referencia, la fuente del tipo de cambio y la fecha y hora de valoración;
• la dirección de liquidación y el hash de la transacción;
• las horas de solicitud, detección, confirmación y entrega;
• las comisiones registradas por la empresa;
• las excepciones, los cambios de estado, los reembolsos y las transacciones de corrección.

Realiza la conciliación con una frecuencia adecuada al volumen de transacciones y al riesgo de entrega. Mantén las transferencias sin correspondencia, los tokens incorrectos, los duplicados y los avisos no resueltos sobre redes incorrectas en una cola de excepciones con una persona responsable y un estado de resolución. Las normas fiscales, de valoración y de reconocimiento de ingresos varían según la jurisdicción, por lo que debes obtener asesoramiento adecuado para la empresa.

Preguntas frecuentes

¿Cómo acepto pagos con criptomonedas en Arbitrum One?

Confirma el activo exacto de Arbitrum One en la configuración autenticada de tu comercio, configura una billetera de liquidación controlada por la empresa y crea un enlace de pago o una página de pago integrada. Indica con claridad el token y la red, realiza una prueba con una transferencia de poco valor y entrega el producto solo cuando la transacción coincida con la solicitud de pago y alcance el estado confirmado requerido.

¿Cuál es el ID de cadena de Arbitrum One?

La red principal de Arbitrum One utiliza el ID de cadena 42161. La guía oficial de inicio rápido de Arbitrum indica ETH como símbolo de moneda. Utiliza el ID de cadena para validar la configuración de la billetera y de la integración, pero sigue escribiendo «Arbitrum One» con claridad para los clientes.

¿Los clientes necesitan ETH para enviar USDC en Arbitrum One?

Para una transferencia ordinaria de tokens, sí. La billetera remitente necesita ETH en Arbitrum One para pagar el gas. Ese saldo para gas es independiente del importe de USDC solicitado. Confirma el comportamiento del flujo de pago real en producción si utiliza patrocinio del gas u otro mecanismo.

¿Cuál es el contrato de USDC nativo en Arbitrum?

Circle indica que la dirección de USDC nativo en Arbitrum es 0xaf88d065e77c8cC2239327C5EDb3A432268e5831. Antes del lanzamiento, verifícala con el directorio vigente de Circle y con el contrato reconocido en la configuración autenticada del comercio.

¿USDC.e es lo mismo que USDC nativo?

No. El USDC nativo y el USDC transferido mediante puente, que suele mostrarse como USDC.e, utilizan contratos diferentes en Arbitrum One. Acepta únicamente el contrato configurado para la modalidad de pago y envía a revisión las transferencias que no coincidan, en lugar de marcar el pedido como pagado automáticamente.

¿Los pagos en Arbitrum One son instantáneos y definitivos?

No lo prometas. Una transacción enviada puede permanecer pendiente o fallar, y para aceptar un pago no basta con ver un hash. Utiliza el estado confirmado del flujo de pago junto con una política de riesgo adecuada al pedido, en vez de garantizar un plazo o una cantidad fija de confirmaciones.

¿Puedo aceptar cualquier token en Arbitrum One?

No lo des por hecho. Acepta únicamente la combinación exacta de activo y red que aparezca en la configuración autenticada disponible en producción y que sea compatible con tus procesos de billetera, precios, confirmación, contabilidad, atención y reembolsos.

¿Se pueden reembolsar los pagos en Arbitrum One?

Un comercio puede emitir un reembolso enviando una transacción saliente independiente de acuerdo con su política de reembolsos. Verifica el pago original, el cliente, el destino, el activo, el importe, la aprobación, el gas y el tratamiento de las comisiones, y registra después el reembolso por separado.

Conclusión

Un método de pago con Arbitrum One listo para producción es una modalidad controlada, no una dirección 0x reutilizable. Especifica el ID de cadena 42161, nombra Arbitrum One en cada punto de decisión del cliente, verifica el contrato exacto del token y explica que las transferencias ordinarias de tokens necesitan ETH en Arbitrum One para pagar el gas.

El USDC nativo es un candidato inicial claro para muchos productos con precios en dólares, pero solo cuando el contrato indicado por Circle coincide con el activo de la configuración autenticada disponible en producción. Mantén separados USDC.e y los demás contratos. Después, prueba de principio a fin los estados pendiente y confirmado, los reintentos de webhooks, la entrega idempotente, la conciliación, las excepciones y un reembolso aprobado.

Empieza por el activo que tus clientes ya utilicen y que la empresa pueda gestionar de forma segura. Amplía a más tokens, una página de pago automatizada o acceso recurrente solo cuando la primera modalidad sea fiable y la opción exacta de Arbitrum One siga disponible en la configuración activa del comercio.