{"id":22781172,"url":"https://github.com/everoddandeven/monero-ecwid","last_synced_at":"2026-02-11T05:32:21.788Z","repository":{"id":265286228,"uuid":"895692927","full_name":"everoddandeven/monero-ecwid","owner":"everoddandeven","description":"Monero Payment Gateway for ECWID Store","archived":false,"fork":false,"pushed_at":"2024-12-29T23:46:44.000Z","size":111,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-26T00:34:57.623Z","etag":null,"topics":["cryptocurrency-payment-gateway","ecommerce","ecwid","monero","monero-payment-gateway","payment-gateway"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/everoddandeven.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-28T17:36:44.000Z","updated_at":"2025-07-04T13:31:08.000Z","dependencies_parsed_at":"2024-11-28T18:34:51.065Z","dependency_job_id":"656f10bb-29d1-4bd0-89d0-37232f36737d","html_url":"https://github.com/everoddandeven/monero-ecwid","commit_stats":null,"previous_names":["everoddandeven/moneroecwid","everoddandeven/monero-ecwid"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/everoddandeven/monero-ecwid","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/everoddandeven%2Fmonero-ecwid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/everoddandeven%2Fmonero-ecwid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/everoddandeven%2Fmonero-ecwid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/everoddandeven%2Fmonero-ecwid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/everoddandeven","download_url":"https://codeload.github.com/everoddandeven/monero-ecwid/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/everoddandeven%2Fmonero-ecwid/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29327326,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-11T03:52:29.695Z","status":"ssl_error","status_checked_at":"2026-02-11T03:52:23.094Z","response_time":97,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cryptocurrency-payment-gateway","ecommerce","ecwid","monero","monero-payment-gateway","payment-gateway"],"created_at":"2024-12-11T21:06:39.056Z","updated_at":"2026-02-11T05:32:21.774Z","avatar_url":"https://github.com/everoddandeven.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Monero ECWID\n\n[![License][license-badge]](LICENSE.md)\n[![Build](https://github.com/everoddandeven/monero-ecwid/actions/workflows/build.yml/badge.svg)](https://github.com/everoddandeven/monero-ecwid/actions/workflows/build.yml)\n[![XMR Donated](https://img.shields.io/badge/donated-0_XMR-blue?logo=monero)](https://github.com/everoddandeven/monero-ecwid?tab=readme-ov-file#monero)\n\nThis project provides a payment integration solution for Ecwid stores using Monero as a payment method. It leverages the [monero-java API](https://github.com/woodser/monero-java) for seamless integration, ensuring secure and private payments.\n\n## Features\n\n- **Monero Payment Gateway**: Integrate Monero as a payment method in your Ecwid store.\n- **Monero RPC API**: Uses Monero's Node RPC API for transaction management.\n- **Easy Setup**: Simplified integration process for Ecwid store owners.\n- **Secure Transactions**: Monero ensures privacy and security for both merchants and customers.\n- **Real-Time Payment Status**: Get immediate updates on payment status using the Node RPC API.\n\n## Prerequisites\n\nBefore you begin, make sure you have the following installed:\n\n- **Java** (v17 or later)\n- **Monero Node**: A running instance of Monero node for managing transactions. You can found an already running instance at [monero.fail](https://monero.fail)\n- **Ecwid Store**: An active Ecwid store with API access enabled\n\n## Installation\n\n1. **Clone the repository**:\n\n   ```bash\n   git clone https://github.com/everoddandeven/monero-ecwid.git\n   cd monero-ecwid\n   ```\n\n2. **Install dependencies**\n\n   ```bash\n   sudo apt update \u0026\u0026 sudo apt install build-essential cmake pkg-config libssl-dev libzmq3-dev libunbound-dev libsodium-dev libunwind8-dev liblzma-dev libreadline6-dev libexpat1-dev libpgm-dev qttools5-dev-tools libhidapi-dev libusb-1.0-0-dev libprotobuf-dev protobuf-compiler libudev-dev libboost-chrono-dev libboost-date-time-dev libboost-filesystem-dev libboost-locale-dev libboost-program-options-dev libboost-regex-dev libboost-serialization-dev libboost-system-dev libboost-thread-dev python3 ccache doxygen graphviz nettle-dev libevent-dev\n   ```\n\n3. **Install MySQL Server dependency**\n\n   ```bash\n   sudo apt update \u0026\u0026 sudo apt install mysql-server\n   ```\n\n4. **MySQL secure installation**\n\n   ```bash\n   sudo mysql_secure_installation\n   ```\n5. **Edit mysqld configuration at `/etc/mysql/mysql.conf.d/mysqld.cnf`**\n   \n   ```bash\n   [mysqld]\n   # Add this line\n   log-bin-trust-function-creators = 1\n   ```\n\n6. **Create MySQL User**\n\n   ```bash\n   sudo mysql -u root -p\n   ```\n\n   ```bash\n   CREATE USER 'monero_ecwid' IDENITIFIED BY 'devpassword';\n   GRANT ALL PRIVILEGES ON monero_ecwid.* TO 'monero_ecwid'@'localhost';\n   FLUSH PRIVILEGES;\n   ```\n\n8. **Build server application**\n\n   ```bash\n   mvn clean package\n   ```\n\n9. **Start server application**\n\n   ```bash\n   java -jar target/monero-ecwid-0.0.1-SNAPSHOT.jar\n   ```\n\n## Configuration\nYou must provide a valid configuration before running server\n\n\n   ```bash\n   # moneroecwid.conf example\n   port=8080\n   db-host=localhost\n   db-port=3306\n   db-username=monero_ecwid\n   db-password=devpassword\n   required-confirmations=1\n   client-secret=Pe087Q6jr0CgwI96R2ZTuUMWfUAHQjMq\n   wallet-address=9xjCAvNQaYYDLc5UsxQPZtP8nNDUJnuhiacmMaE3zzTBetYcLusyCtD5kuQNNGo3TVCEUFKjd7yjeE3rCjPahy3RQGa39aJ\n   wallet-view-key=9ce15a203d7e31aa930e55e4bf18e65509fb73ba316528182b77b079bb997b0d\n   wallet-server-uri=http://node2.monerodevs.org:28089\n   wallet-password=supersecretpassword123\n   wallet-net-type=testnet\n   wallet-restore-height=2644330\n   mail-host=smtp.mailgun.org\n   mail-port=587\n   mail-username=\n   mail-password=\n   ```\n\n   ```bash\n   java -Dconfig-file=/path/to/moneroecwid.conf -jar monero-ecwid-0.0.1-SNAPSHOT.jar\n   ```\n\n## ECWID Integration\n\n1. Apply for a [Ecwid Paid Plan](https://www.ecwid.com/pricing) \n2. Create a new [Custom App](https://my.ecwid.com/cp/#develop-apps) for your store\n3. Copy your Custom App `Client Secret` and paste it in your configuration file `client-secret=custom_app_client_secret` \n4. Write to Ecwid support and ask to change the `Payment URL` with your payment gateway `https://yourservername.com/v1/monero/ecwid`, custom app will be enabled within two days\n5. Enjoy Monero Ecwid payments!\n\n## Usage\n\n1. **Create Payment Request:** The integration will handle creating a Monero payment request when a customer proceeds to checkout in your Ecwid store.\n2. **Handle Payment:** Once the payment is initiated, the integration will monitor the transaction and provide real-time updates to both the merchant and the customer.\n3. **Payment Confirmation:** Once the payment is confirmed, the order status in Ecwid will be updated, and the customer will be redirected to the confirmation page.\n4. **Error Handling:** If there are any issues with the payment (e.g., payment not received or canceled), appropriate error messages will be displayed to the customer.\n\n## Example Flow\n\n1. A customer creates a new cart in the store and then selects Monero as the payment method at checkout.\n2. The payment gateway server generates a new Monero invoice.\n3. The customer pays the invoice to complete the transaction.\n4. Once the transaction is confirmed, the Ecwid store's order status is updated to \"PAID\".\n5. The customer is redirected to a confirmation page.\n6. If the invoice is not paid within 15 minutes, it will expire and the order will be cancelled.\n\n## Donating\n\nPlease consider donating to support the development of this project.\n\n### Monero\n\n\u003cp align=\"center\"\u003e\n \u003cimg src=\"xmr_qrcode.png\" width=\"115\" height=\"115\" alt=\"xmrQrCode\"/\u003e\u003cbr\u003e\n \u003ccode\u003e87qmeEtvQvuELasb4ybjV4iE17KF14SKTPvhgzAwrD5k1vWZUTqsWM52pbyHy8Wb97jCkq4pm5hLKaw39pEnvUKPPf3GFJA\u003c/code\u003e\n\u003c/p\u003e\n\n[license-badge]: https://img.shields.io/badge/license-MIT-blue.svg\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feveroddandeven%2Fmonero-ecwid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feveroddandeven%2Fmonero-ecwid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feveroddandeven%2Fmonero-ecwid/lists"}