Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/renat2985/toncoin_payment
Payment for Your Services via TonCoin
https://github.com/renat2985/toncoin_payment
crypto payment payments smalltv ton toncenter toncoin
Last synced: about 1 month ago
JSON representation
Payment for Your Services via TonCoin
- Host: GitHub
- URL: https://github.com/renat2985/toncoin_payment
- Owner: renat2985
- License: mit
- Created: 2024-09-03T10:09:18.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-11-14T14:42:25.000Z (about 2 months ago)
- Last Synced: 2024-11-14T15:36:10.145Z (about 2 months ago)
- Topics: crypto, payment, payments, smalltv, ton, toncenter, toncoin
- Language: HTML
- Homepage:
- Size: 22.6 MB
- Stars: 3
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[🇷🇺 Русская версия документации здесь](https://github.com/renat2985/toncoin_payment/blob/main/README_RU.md)
# Payment for Your Services via TonCoin
A convenient and fast way to implement paid services using the TonCoin cryptocurrency. The process is simple: You open any crypto wallet, scan the QR code, transfer the specified amount, and once the payment is received, the relay is activated and turns on your device for the time you set. This can be any device, from a kettle, coffee machine, and light bulb to powering a room or any other location.
You can assemble the device yourself or ask to do it for you. To order a ready-made device, contact me via [Telegram](https://t.me/ESPiotDevice), [Skype](https://skype:renat2985?chat), [Discord](https://discord.com/invite/zaGaDuGe).
We have a similar project with a display, [check it out](https://github.com/renat2985/crypto_payment_touchScreen), and also based on Sonoff:
- [Sonoff for Toncoin (toncenter.com)](https://github.com/renat2985/toncoin_payment_sonoff)
- [Sonoff for Toncoin, Solana, Cosmos, Algorand (tatum.io)](https://github.com/renat2985/crypto_payment_sonoff)
[](https://www.youtube.com/watch?v=zKdVJmzJNLM&list=PL6NJTNxbvy-LpsI6D_1RM6v5YWDvsm5j4)
### Main Features:
1. **Connecting the Device:**
- On the first power-up or if the device cannot find the router, it will create an access point named "TonCoin payment."
- Connect to this access point (no password required) and open a browser, where you enter http://192.168.4.1. Typically, after connecting to Wi-Fi, the Captive Portal will automatically open and redirect you to the required page.
- Click "Configure WiFi" to configure the settings.
2. **Configuring the Device:**
- **Router and Password:** Enter the details to connect to your Wi-Fi.
- **Device Name:** Specify the name of the device, for example, "Buy coffee."
- **Your Toncoin Wallet:** Enter your wallet address to receive payments.
- **CoinMarketCap API:** Is a service that allows you to get the current TonCoin price in fiat currency. For testing, you can use the default API, but if you plan to use the device on a regular basis, it is highly recommended to register on the [CoinMarketCap](https://coinmarketcap.com/api/) website and get your own API. The free version allows up to 10,000 requests per month for price data. This is more than enough for 10 devices, but if our API is used by more devices, not everyone will be able to receive the actual price, and as a result, payments may fail.
- **Currency:** Choose the currency in which you want to receive payments (EUR, USD, RUB, BYN, BGN, GBP, etc.). This is necessary for automatic conversion of the amount into TonCoin based on the current exchange rate, which is updated every 3 hours via coinmarketcap.com.
- **Service Currency Price:** Specify the price in the selected currency that the client needs to pay. After scanning the QR code, the client will be prompted with the equivalent amount in TonCoin.
- **Payment Tolerance:** This field indicates the acceptable price tolerance. Since the price of Ton fluctuates, you need to specify the acceptable deviation (as a single number) that you are willing to accept during payment. This is for situations where the person does not scan the QR code but tries to send the amount manually in fiat currency.
- **Relay Work Time:** Specify how long the relay should be activated. This can be from one second (e.g., to simulate a button press) to several minutes or hours.
### Instructions for DIY Assembly:
For DIY assembly, you will need a [smalltv or smalltv-ultra](https://www.aliexpress.com/w/wholesale-smalltv-wifi.html) device. Note that there are also smalltv-pro, which look the same but differ internally. The project only works on smalltv, smalltv-ultra. Additionally, you will need:
- 5V Relay Module and ULN2003(look photo) or 5V Relay Arduino module
- Soldering iron and wires
The image below shows how everything should be soldered:
# Flashing (recommended)
Download the file [toncoin_payment.ino.bin](https://github.com/renat2985/toncoin_payment/raw/main/build/esp8266.esp8266.generic/toncoin_payment.ino.bin) and upload it to your laptop or phone. Then, connect to the WiFi of the gadget, which will be named GIFTV. Next, open a browser and go to http://192.168.4.1/update, select the previously downloaded file [toncoin_payment.ino.bin](https://github.com/renat2985/toncoin_payment/raw/main/build/esp8266.esp8266.generic/toncoin_payment.ino.bin), and click Upload...
After this, follow the instructions from steps 1 “Connecting the Device” and 2 “Configuring the Device.”
Good luck! If you have any questions, feel free to contact me.
# For Advanced Users: Instructions for Flashing via Programmer
## Web installer
Go to the web installer and follow instructions.
## [https://renat2985.github.io/toncoin_payment/](https://renat2985.github.io/toncoin_payment/)
### NodeMCU Flasher
Specification of [toncoin_payment.ino.bin](https://github.com/renat2985/toncoin_payment/raw/main/build/esp8266.esp8266.generic/toncoin_payment.ino.bin) file.
```
- Module: Generic ESP8266 Module
- Flash Size: 4M
- CPU Frequency: 80Mhz
- Flash Mode: DOUT
- Flash Frequency: 40Mhz
- Upload Speed: 921600
```
https://github.com/nodemcu/nodemcu-flasher
Download Release: [Win32](https://github.com/nodemcu/nodemcu-flasher/blob/master/Win32/Release/ESP8266Flasher.exe) or [Win64](https://github.com/nodemcu/nodemcu-flasher/blob/master/Win64/Release/ESP8266Flasher.exe).
## :battery: Donation
If you like this project, you can buy me a cup of coffee :coffee:
- PayPal [https://www.paypal.me/RKevrels](https://www.paypal.me/RKevrels/5)