Lo que necesitas
| Campo | Que hace |
|---|---|
| URL del endpoint de acunacion | La direccion publica de tu servidor para acunar direcciones. La llamamos para obtener una direccion nueva para cada pedido. No es secreta. |
| Secreto del webhook | Un secreto compartido que tu servidor firma y nosotros verificamos. Nunca puede tocar tu cartera. Secreto. |
Esta opcion es para las personas que quieren recibir Monero por su cuenta. Ejecutas algunos programas pequenos en tu propio ordenador: la aplicacion de cartera Monero, un asistente de cartera, un servidor listo, y una herramienta de direccion publica. Esta guia te lleva a traves de todo en una Mac. Si prefieres no ejecutar nada, conecta un servicio de criptomonedas alojado en cambio.
Por que pedimos cada campo
URL del endpoint de acunacion
Cuando un comprador hace clic en Comprar, le pedimos a tu servidor una direccion nueva para mostrarle. Esa solicitud va a esta ruta publica. Devuelve una direccion y nada mas; tu cartera permanece privada detras de ella.
Secreto del webhook
Tu servidor nos dice "este pedido esta pagado" enviando un mensaje firmado. Este secreto compartido nos permite confirmar que el mensaje realmente proviene de tu servidor, para que nadie pueda falsificar un evento pagado. No puede leer nada ni mover nada.
Configurar
- Obten la aplicacion Monero y las herramientas
Tres descargas gratuitas de getmonero.org y nodejs.org. Obtenlas todas ahora.
- La aplicacion de cartera Monero (la cartera GUI). Aqui es donde haces tu cartera.
- Las herramientas de linea de comandos de Monero (la cartera CLI). Esto mantiene el asistente de cartera que inicia mas tarde. Descomprimelo, cambia el nombre de la carpeta a monero-tools y movelo a tu Escritorio.
- Node.js (el boton verde LTS en nodejs.org). Esto ejecuta el pequeno servidor que distribuye direcciones.
Descarga la aplicacion de cartera Descarga las herramientas de linea de comandos La primera vez que ejecutas las herramientas de linea de comandos, tu Mac puede bloqueadas porque no conoce al fabricante. El paso 6 muestra como permitirlas.
- Abre la aplicacion y elige el modo Simple
Abre la aplicacion Monero. En la pantalla de seleccion de modo, elige el modo Simple y deja el modo Portable sin marcar. Luego explica el modo Simple y te pide que estes de acuerdo.
- Abre la aplicacion y continua pasando la pantalla de bienvenida.
- Elige el modo Simple y continua.
- Marca la casilla que dice que entiendes que se utiliza un servidor de terceros, luego haz clic en Siguiente.
Abre la aplicacion Monero Seleccion de modo, elige el modo Simple Marca la casilla y haz clic en Siguiente El modo Simple toma prestado un ordenador publico de Monero para que no descargues todo el blockchain. Tus palabras secretas nunca salen de tu ordenador.
Prefieres ejecutar tu propio nodo? (avanzado)
Para no usar ningun nodo externo, elige el modo Avanzado en esta pantalla en lugar del modo Simple. El modo Avanzado ejecuta tu propio nodo y descarga todo el historial de Monero primero, lo que toma un tiempo. Tambien cambias una linea cuando inicias el asistente de cartera, que se muestra en ese paso.
- Haz tu cartera
En la pantalla de Bienvenida elige Crear una cartera nueva. Luego nombrela, guarda tus palabras y establece una contrasena.
- Elige Crear una cartera nueva (la opcion superior).
- Dale un nombre y anota la ruta de carpeta que muestra. Necesitas esa ruta en el paso 6.
- Escribe las 25 palabras en papel, en orden, y mantenalas seguras. Son la unica clave para tu dinero.
- Establece una contrasena y anotala tambien.
- Cuando se abra la cartera, cierrala. El asistente de cartera en el paso 6 la necesita cerrada.
Elige Crear una cartera nueva Nombra tu cartera Escribe tus 25 palabras Establece una contrasena de cartera Tu cartera nueva esta lista - Haz tu codigo secreto
Un secreto compartido firma y verifica el mensaje pagado. Hazlo una vez con el comando a continuacion, o haz clic en Generar cuando agregues el proveedor en el panel. De cualquier manera, usa el mismo valor en ambos lugares y mantanlo privado.
openssl rand -hex 32 - Haz tu proyecto y copia el id
Inicia sesion en el panel, haz un proyecto y copia su id de proyecto. Comienza con proj_. Lo usas cuando inicias el servidor.
Copia tu id de proyecto - Inicia el asistente de cartera
Este programa abre tu cartera y responde al servidor. Ejecutalo en Terminal desde tu carpeta monero-tools. Pide tu contrasena de cartera, oculta, para que la contrasena nunca se muestre. Reemplaza YOUR-WALLET-PATH con la ruta del paso 3 (en Finder, haz clic derecho en el archivo de cartera y elige Copiar como Nombre de ruta).
cd ~/Desktop/monero-tools ./monero-wallet-rpc \ --wallet-file 'YOUR-WALLET-PATH' \ --prompt-for-password \ --rpc-bind-ip 127.0.0.1 --rpc-bind-port 18083 \ --disable-rpc-login \ --daemon-address nodes.hashvault.pro:18081 --untrusted-daemonMac puede bloquearlo la primera vez Privacidad y Seguridad, Permitir de todas formas El asistente de cartera se esta ejecutando Si Mac lo bloquea, abre Configuracion del Sistema, Privacidad y Seguridad, haz clic en Permitir de todas formas, luego ejecuta el comando nuevamente y haz clic en Abrir. Deja esta ventana abierta.
Usando tu propio nodo en lugar de uno publico?
Si elegiste el modo Avanzado, inicia primero tu propio nodo, luego apunta el asistente de cartera hacia el.
monerod --data-dir ~/.bitmonero --prune-blockchain --restricted-rpcLuego en el comando anterior, cambia --daemon-address nodes.hashvault.pro:18081 --untrusted-daemon por --daemon-address 127.0.0.1:18081 --trusted-daemon. Para dinero real, mantente tu clave de gasto en una maquina sin conexion separada y ejecuta una cartera de solo lectura en la maquina que enfrenta internet.
- Descarga e inicia el servidor
Un servidor listo distribuye una direccion para cada venta y vigila el dinero. No lo editas. Ejecuta las lineas a continuacion, luego responde dos preguntas: tu id de proyecto y tu codigo secreto (el secreto se muestra como asteriscos).
mkdir ~/Desktop/coinmoebius-server cd ~/Desktop/coinmoebius-server curl -fsSL https://coinmoebius.com/tools/monero-server.mjs -o server.mjs npm init -y npm install @aquarian-metals/coin-moebius-monero @aquarian-metals/coin-moebius-server node server.mjsObten el servidor listo Hace dos preguntas, luego se ejecuta - Pon tu servidor en linea
Tu servidor necesita una direccion web publica para que podamos alcanzarlo. Una herramienta gratuita llamada ngrok hace una.
- Haz una cuenta gratuita en ngrok.com y descarga ngrok para Mac.
- Agrega tu authtoken (ngrok muestra la linea exacta en su pagina de configuracion).
- Ejecuta el comando a continuacion, luego copia la direccion https que muestra junto a Reenviando.
./ngrok http 8787Copia la direccion de Reenviando de ngrok - Conecta en el panel
Agrega proveedor, elige Ser tu propio proveedor, luego Monero. Pega dos cosas y guarda.
- URL del endpoint de acunacion: tu direccion ngrok con /coin-moebius/monero/mint agregado al final.
- Secreto del webhook: el codigo secreto del paso 4.
Agrega proveedor, Ser tu propio proveedor Busca y elige Monero Pega la URL y el secreto Cuando guardas, verificamos silenciosamente que podemos alcanzar tu servidor. Tu asistente de cartera, servidor y ngrok todos necesitan estar en funcionamiento.
- Agrega el boton de compra a tu pagina
Haz un producto en el panel, luego copia su codigo de boton de compra a tu pagina. Son dos piezas: una linea de script cerca del final de la pagina, y un bloque de boton donde quieres el boton.
<script src="https://sdk.coinmoebius.com/latest/sdk.global.js" crossorigin="anonymous" defer></script> <coin-moebius-buy project-id="proj_yourprojectid" product-id="your-product" amount="59.99" currency="USD" label="Buy now"> </coin-moebius-buy> - Haz tu primer pago
No hay sandbox para una configuracion autohospedada, por lo que un pequeno pago real es la prueba. Mantena todos los tres ventanas en funcionamiento (asistente de cartera, servidor, ngrok).
- Abre tu pagina, haz clic en Comprar y elige Monero. La ventana muestra una direccion, un codigo QR y la cantidad.
- Envia esa cantidad exacta de Monero desde cualquier cartera.
- Espera confirmaciones. Monero tarda aproximadamente veinte minutos en confirmarse completamente, por diseno. La ventana sigue buscando todo el tiempo.
- Cuando muestre que el pago esta completo, toda tu configuracion funciona de principio a fin.
La ventana de compra muestra la direccion El pago esta completo
Despues que conectes
Tu primer pago real es la prueba, y el paso anterior te lo muestra. Aqui hay lo que debes verificar mientras se liquida. Mantena todos los tres ventanas en funcionamiento: el asistente de cartera, el servidor y ngrok.
- Despues de que pagues, la ventana de compra sigue buscando. Un 404 en la verificacion de estado significa que aun no se confirma, no es un error.
- Monero tarda aproximadamente veinte minutos en confirmarse completamente, por diseno.
- Abre la pestana Transacciones en el panel. Cuando la nueva fila alcance Exitosa, toda tu configuracion funciona de principio a fin.
Resolucion de problemas
El pago falla de inmediato.
No pudimos alcanzar tu servidor. Asegurate de que todos los tres ventanas esten en funcionamiento y que la URL del endpoint de acunacion en el panel sea tu direccion ngrok con /coin-moebius/monero/mint al final.
El asistente de cartera dice que no hay conexion al demonio.
El nodo publico de Monero esta ocupado. Abre monero.fail, elige otro nodo, ponlo despues de --daemon-address en el comando del paso 6, e inicia el asistente de cartera nuevamente.
El comprador pago pero el pedido permanece pendiente, y la verificacion de estado muestra 404.
Eso es normal mientras el pago se confirma. Un 404 aqui significa que aun no se confirma, no es un error. Se convierte en pagado una vez que el pago alcanza diez confirmaciones, aproximadamente veinte minutos despues de que llega.
Aun dice pendiente despues de treinta minutos.
O el servidor no esta en funcionamiento, o su secreto no coincide. Confirma que el servidor este activo y que el secreto que escribiste coincida con el secreto del webhook en el panel.
Bueno saber
Ejecutalo en un ordenador que permanece encendido. La prueba se ejecuta en tu propio ordenador. Para una tienda cotidiana, ejecuta las mismas partes en un ordenador que permanece encendido todo el tiempo, con una direccion web fija.
El tiempo de inactividad es barato. El servidor se pone al dia despues de una interrupcion e informa los pagos que perdio. Nada se pierde, por lo que un ordenador domestico esta bien.
Mantena una cartera de solo lectura para dinero real. Cuando vendes de verdad, mantena tu clave de gasto en una maquina sin conexion separada y ejecuta una cartera de solo lectura en la maquina que enfrenta internet.
Rotacion del secreto. Haz un nuevo secreto en cualquier momento, luego usalo tanto en el servidor como en el panel.
Preguntas Join our Discord