Migrated previous wiki content
Nathan Day
parent
239b4253ee
commit
4ff48d6882
28
communities.md
Normal file
28
communities.md
Normal file
@ -0,0 +1,28 @@
|
||||
# Communities
|
||||
|
||||
BTC Map Communities are areas on the map, but they are also much more!
|
||||
|
||||
They are hubs of activity that connect local bitcoiners with each other and with local merchants. They provide focus for a community to help onboard new people and businesses to bitcoin.
|
||||
|
||||
You can add a community [here](https://btcmap.org/communities/add), other useful links are the communities [directory](https://btcmap.org/communities) and [leaderboard](https://btcmap.org/communities/leaderboard).
|
||||
|
||||
Each community gets their own page to track progress on BTC Map. You will receive a Grade based on your number of Up-To-Date locations. We provide all the metrics and data visualization needed to ensure you can maintain a high quality community in the bitcoin mapping context.
|
||||
|
||||
Bitcoin mapping communities maintain their local datasets and strive to have the most accurate information. Take ownership of your local data and help drive adoption. Bitcoin communities are the spark that ignites the movement. Join your friends and have fun!
|
||||
|
||||
## Community Responsibilities 🧡
|
||||
|
||||
- Help to onboard new users to bitcoin.
|
||||
|
||||
- Maintain the merchants accepting bitcoin in your area. This means periodically [verifying](verifying-locations.html) merchant details and making sure they are up-to-date on OpenStreetMap. See [verified tags](tagging-instructions.html#verified-tags---more-information) and the [map legend](map-legend.html#verified) for more details.
|
||||
|
||||
- Help [onboard](onboarding-merchants.html) new merchants to bitcoin and [add them](tagging-instructions.html) to the map.
|
||||
|
||||
## Community Icon Specs
|
||||
|
||||
- Preferred format is `svg` but `webp`, `png` or `jpg` will also be accepted.
|
||||
- The image should be square.
|
||||
- The image should have a background fill color (no transparent backgrounds).
|
||||
- Keep file sizes small.
|
||||
- Try to include some padding so that your icon looks good when the corners are rounded by apps.
|
||||
- The icon may be displayed on small screens so try to make it as readable as possible.
|
||||
57
content.md
Normal file
57
content.md
Normal file
@ -0,0 +1,57 @@
|
||||
# Content
|
||||
|
||||
## Art 🎨
|
||||
|
||||
- [BTC Map painting on a merchant shop in South Africa ❤️](https://twitter.com/BitcoinEkasi/status/1654910073506869250?s=20)
|
||||
|
||||
## Podcasts 🎙️
|
||||
|
||||
- [Stephan Livera - ep. 420](https://stephanlivera.com/episode/420/)
|
||||
- [Accept Bitcoin? Put Yourself on the Map with BTCMap! - Nathan Day](https://fountain.fm/episode/13678103262)
|
||||
- [Bitcoin Review Podcast BR035 - OpenSats, Nunchuk, BTC Map, BRC-20 Mania + MORE ft. Sjors, Nicholas Gregory & Daniel Prince](https://bitcoin.review/podcast/episode-35/) (BTC Map content starts at 0:30:00)
|
||||
- [Bitcoin Berlin 1 Year Anniversary POD-A-THON](https://www.youtube.com/live/KnYTDtEilWE?t=15821s)
|
||||
|
||||
## Presentations 🧍
|
||||
|
||||
- [Leo Weese of Lightning Labs @ Vancouver Bitcoiners meetup](https://youtu.be/5MD_gn1Q8og)
|
||||
- [BTCMap.org - secondl1ght - Adopting Bitcoin Day 2 - Solutions Stage](https://youtu.be/BzdKSgT17pQ)
|
||||
- [Legends Of Lightning: Global Adoption Finals 🧡](https://youtu.be/fCPf7m8f_9U?t=1h41m4s) (BTC Map content starts at 1:41:04)
|
||||
- [BOLT.FUN Legends of Lightning Pitch - Nathan Day](https://www.canva.com/design/DAFSsnNBZB0/zSwnN3krgzwonsq0K127xQ/view)
|
||||
- [BTC Prague 23 - Expo Stage](https://github.com/teambtcmap/btcmap-general/blob/main/events/BTCPrague-BTCMap.pdf)
|
||||
- [Nathan Day - BTC Map: SPEDN is the new HODL (BTC Prague 2023)](https://youtu.be/VO3pdA9P5As)
|
||||
- [Nathan Day - State of Merchant Adoption (Adopting Bitcoin 2023)](https://www.youtube.com/watch?v=4Qh7HIumiUo&t=60s)
|
||||
- [Nathan Day - Adopting Bitcoin Arnhem 2024](https://www.youtube.com/live/-GTw6k1IkC0?t=4255s)
|
||||
- [Nathan Day - BTC Prague 2024](https://www.youtube.com/watch?v=8J20WO80aPo)
|
||||
|
||||
## Videos 📹
|
||||
|
||||
- [How to create an entry on OpenStreetMap - Nathan Day](https://rumble.com/v1ldybp-how-to-create-an-entry-on-openstreetmap..html)
|
||||
- [Overview of BTC Map and OpenStreetMap in Spanish 🇪🇸 - Cripto Panas](https://www.youtube.com/watch?v=oD6plqA64Rw)
|
||||
- [Trader University - Can You Actually Buy Anything With Bitcoin?](https://youtu.be/WfCLHbt6vtU)
|
||||
- [Bill on Bitcoin Island - Shadowy Supertagger](https://drive.google.com/file/d/178Md7XS4Sk_R0xLYRftEf9C9-346jjZe/view)
|
||||
- [WHY ARE WE BULLISH? HodlSolo, James Dewar, Christopher Gordon, Peter Rounce](https://youtu.be/Lco16m3tWP8?t=1h20m) (BTC Map content starts at 1:20:00)
|
||||
- [So much to look forward to in #Bitcoin in 2023. Here’s a look at our Top 10: - Natalie Brunell](https://twitter.com/natbrunell/status/1614025417010339840?s=20) (BTC Map content starts at 2:21)
|
||||
- [Bitcoin ile Nerelerden Alışveriş Yapılır? 👉🏻 BTCMap’i Keşfedin – P2P #12](https://youtu.be/2orxuT57eCo)
|
||||
- [How do you know who accepts #bitcoin in El Salvador? 👀 Try these two maps/apps!](https://youtube.com/shorts/VaaHTjBnIPA)
|
||||
- [Bitcoin Kabul Eden İşletmeleri Keşfetmek 👉🏻 BTC Map | Bitcoin Lifestyle #8](https://www.youtube.com/watch?v=SmCTeBRODSA)
|
||||
- [BTC Map : la map des bitcoiners](https://www.youtube.com/watch?v=cMJDdQx9jl8)
|
||||
- [Promociona tu negocio en BTCMap.org](https://www.youtube.com/watch?v=oD6plqA64Rw)
|
||||
- [Geyser Community Workshop Spaces](https://x.com/geyserfund/status/1790767504958332959) (BTC Map content starts at 02:07:00)
|
||||
- Short clips from an interview with Blockstream
|
||||
- [The end goal of BTC Map is DEATH](https://twitter.com/Blockstream/status/1788131934134272183)
|
||||
- [Opensource software, opensource data](https://twitter.com/Blockstream/status/1787746232217358379)
|
||||
|
||||
## Blogs / Articles 🖋️
|
||||
|
||||
- [Web developers are lightning app developers - Alby](https://blog.getalby.com/web-developers-are-lightning-app-developers/)
|
||||
- [Lightning Network Empowers Bitcoin To Become The Currency Of The Future - Forbes](https://www.forbes.com/sites/rogerhuang/2022/12/23/lightning-network-empowers-bitcoin-to-become-the-currency-of-the-future/?sh=4090bc55141d)
|
||||
- [BTC Map: mappare le attività che accettano pagamenti in bitcoin - Bitcoin for Freedom](https://bitcoinforfreedom.xyz/2023/01/06/btc-map-mappare-le-attivita-che-accettano-pagamenti-in-bitcoin/)
|
||||
- [Bitcoin’s Lightning Network: What It Is And How It Works - Forbes](https://www.forbes.com/sites/digital-assets/2023/04/27/bitcoins-lightning-network-what-it-is-and-how-it-works/?sh=574e0743509c)
|
||||
- [ORANGE PILLING YOUR BARBER OR STYLIST: A SHORT CUT TO HYPERBITCOINIZATION - Bitcoin Magazine](https://bitcoinmagazine.com/culture/share-bitcoin-with-your-barber-or-stylist)
|
||||
- [The Adoption Dilemma - CARL ₿ MENGER](https://carlbmenger.substack.com/p/the-adoption-dilemma)
|
||||
- [In-person businesses accepting bitcoin nearly tripled in 2023 - The Block](https://www.theblock.co/post/270789/in-person-businesses-accepting-bitcoin-nearly-tripled-in-2023)
|
||||
|
||||
## Songs 🎶
|
||||
|
||||
- [Bitcoin Landslide - CARLA⚡️](https://twitter.com/thecryptoc0up1e/status/1613675892215250944?s=20)
|
||||
- [Lemonade - Man Like Kweks](https://www.wavlake.com/track/6bd0bb3b-c59d-4224-bc98-e97f9c5edb29)
|
||||
70
embedding.md
Normal file
70
embedding.md
Normal file
@ -0,0 +1,70 @@
|
||||
# Embedding
|
||||
|
||||
If you would like to embed the web map on your own website, simply add the following code to your HTML:
|
||||
|
||||
```html
|
||||
<iframe
|
||||
id="btcmap"
|
||||
title="BTC Map"
|
||||
width="600"
|
||||
height="300"
|
||||
allowfullscreen="true"
|
||||
allow="geolocation"
|
||||
src="https://btcmap.org/map"
|
||||
>
|
||||
</iframe>
|
||||
```
|
||||
|
||||
You can adjust the `width` and `height` attributes to fit your page.
|
||||
|
||||
**NOTE:** If you want the geolocation feature to work you must also allow this in the `Permissions Policy HTTP Header` on the server of your website.
|
||||
|
||||
```
|
||||
Permissions-Policy: geolocation=(self "https://btcmap.org")
|
||||
```
|
||||
|
||||
For more information see this [article](https://developer.chrome.com/docs/privacy-sandbox/permissions-policy/).
|
||||
|
||||
### If you would like the map the initialize on a specific location there are a couple more steps to complete
|
||||
|
||||
#### General area
|
||||
|
||||
1. Visit [btcmap.org/map](https://btcmap.org/map) and zoom the map to your desired location
|
||||
2. Copy the URL from your browser tab which contains geolocation data
|
||||
3. Add this URL to your `iframe` `src` attribute embed code
|
||||
|
||||
#### Communities map
|
||||
|
||||
1. Use `https://btcmap.org/communities/map` for your `iframe` URL
|
||||
|
||||
##### Community area
|
||||
|
||||
1. Use `https://btcmap.org/communities/map?community=einundzwanzig-deutschland` for your `iframe` URL (replace `einundzwanzig-deutschland` with the ID of your community - this can be found in the URL when visiting your community page)
|
||||
|
||||
##### Organization filter
|
||||
|
||||
1. Use `https://btcmap.org/communities/map?organization=einundzwanzig`
|
||||
|
||||
##### Language filter
|
||||
|
||||
1. Use `https://btcmap.org/communities/map?language=es`
|
||||
|
||||
### If you would like to filter by payment method
|
||||
|
||||
Add the preferred payment method(s) as `URLSearchParams` to the `src` attribute of your `iframe`. These can be added in addition to the location params above.
|
||||
|
||||
The available options are:
|
||||
|
||||
- onchain
|
||||
- lightning
|
||||
- nfc
|
||||
|
||||
Example: `/map?onchain&lightning`
|
||||
|
||||
### Selecting a default basemap
|
||||
|
||||
To choose which basemap displays on page load, you can add the `basemap` param to your URL. The values correspond to the order they appear in the list on the map. For example, if you wanted to use the Terrain basemap you would add `basemap=7`. Like so: `/map?basemap=7`.
|
||||
|
||||
That's it!
|
||||
|
||||
Embedding is also possible on native mobile applications by utilizing the **WebView**.
|
||||
21
faq.md
Normal file
21
faq.md
Normal file
@ -0,0 +1,21 @@
|
||||
# Frequently Asked Questions 🙋♂️🙋♀️
|
||||
|
||||
## How do I add a Pay Button?
|
||||
|
||||
Please contact [hello@btcmap.org](mailto:hello@btcmap.org) with your request.
|
||||
|
||||
This information is sensitive and cannot be stored in OpenStreetMap. It requires BTC Map to verify the information and store it in the BTC Map database.
|
||||
|
||||
## How long does it take to add a Merchant?
|
||||
|
||||
That depends on the current backlog and how busy our community of volunteer Shadowy Suppertaggers are.
|
||||
|
||||
You will have received a GitHub Issue ID when you submitted the form where you can check progress, or you can reach out on our [Discord](https://discord.gg/wPqva83uzq). [Here](https://github.com/teambtcmap/btcmap-data/issues?q=is%3Aissue+is%3Aopen+label%3Alocation-submission) is a list of all open location submissions.
|
||||
|
||||
You can jump the queue by adding the location yourself in OpenStreetMap. Instructions are [here](tagging-instructions.html). If you do this, please comment on your issue in GitHub so that we don't duplicate effort.
|
||||
|
||||
## How long does is take to add a Community?
|
||||
|
||||
That depends on how busy our core team is, usually a few weeks maximum.
|
||||
|
||||
[Here](https://github.com/teambtcmap/btcmap-data/issues?q=is%3Aissue+is%3Aopen+label%3Acommunity-submission) is a list of all open community submissions.
|
||||
47
geojson-areas.md
Normal file
47
geojson-areas.md
Normal file
@ -0,0 +1,47 @@
|
||||
# Creating GeoJSON Areas
|
||||
|
||||
The BTC Map API uses [Areas](../api/areas.html) to calculate stats for Communities and Countries.
|
||||
|
||||
Originally, these areas were simple rectangles but we have now moved to polygons using the [GeoJSON](https://geojson.org/) format. This provides much more accurate data.
|
||||
|
||||
## GeoJSON polygon creation process
|
||||
|
||||
### 1. Find your area
|
||||
|
||||
Go to [geojson.codingarena.top](https://geojson.codingarena.top/) and search for your area (town, city, country).
|
||||
|
||||
|
||||
|
||||
Select your area from the search results.
|
||||
|
||||
|
||||
|
||||
### 2. Create your simplified polygon
|
||||
|
||||
You can view your polygon on the map and see the number of points it contains. Use the percentage buttons to reduce the number of points to no more than 150.
|
||||
|
||||
When you are happy with your polygon you can click on the blue **Copy to clipboard** button under the simplified GeoJSON.
|
||||
|
||||
|
||||
|
||||
### 3. Validate using linter (optional)
|
||||
|
||||
Your GeoJSON should be valid, but if you want to take an extra step and verify you can do this.
|
||||
|
||||
Go to [geojsonlint.com](https://geojsonlint.com/) and paste your GeoJSON into the textarea. Click the blue **Test GeoJSON** button. Any errors that need to be fixed will display in a popup modal. Once the code is valid there will be no errors and the area will be displayed on the website. If you receive the `Polygons and MultiPolygons should follow the right-hand rule` error you can visit [this website](https://mapstertech.github.io/mapster-right-hand-rule-fixer/) to 'Rewind' and generate a new file.
|
||||
|
||||
### 4. Check population data
|
||||
|
||||
Please also add `population` and `population:date` information for the area in question.
|
||||
|
||||
There are Wikipedia links for the area which should contain information about the population that you can use.
|
||||
|
||||
|
||||
|
||||
### 5. Update the Issue
|
||||
|
||||
Save and attach the file as `community-name.geojson` to the relevant [Issue](https://github.com/teambtcmap/btcmap-data/issues?q=label%3Acommunity-submission+).
|
||||
|
||||
### 6. Fin
|
||||
|
||||
One of the Admin team will make the update in the BTC Map DB.
|
||||
25
hashing-sites.md
Normal file
25
hashing-sites.md
Normal file
@ -0,0 +1,25 @@
|
||||
# Tagging Hashing Sites
|
||||
|
||||
For those wanting to tag locations that perform hashing (mining), you should use the following tags:
|
||||
|
||||
`man_made=works`
|
||||
|
||||
`product=bitcoin`
|
||||
|
||||
As described here: [Tag:man_made=works](https://wiki.openstreetmap.org/wiki/Tag:man_made%3Dworks).
|
||||
|
||||
AND
|
||||
|
||||
`telecom=data_center`
|
||||
|
||||
`building=data_center`
|
||||
|
||||
As described here: [OSM Wiki - Telecoms-Datacenters](https://wiki.openstreetmap.org/wiki/Telecoms#Datacenters) and [Tag:telecom=data_center](https://wiki.openstreetmap.org/wiki/Tag:telecom%3Ddata_center).
|
||||
|
||||
AND _OPTIONALLY_
|
||||
|
||||
`operator=*` - The operator of the datacenter. In the case of a corporate datacenter, this will be the organisation which owns it. In the case of a colocation facility, this will be the colocation company.
|
||||
|
||||
`name=*` - The name of the datacenter.
|
||||
|
||||
`owner=*` - Some datacenters are constructed and owned by one company, but long-term leased in their entirety to another company to operate.
|
||||
44
integrations.md
Normal file
44
integrations.md
Normal file
@ -0,0 +1,44 @@
|
||||
# Integrations
|
||||
|
||||
## Bitcoin projects integrating with BTC Map 🙏
|
||||
|
||||
### Ways to integrate
|
||||
|
||||
1. [API](../api/introduction.html)
|
||||
2. [Embed](embedding.html)
|
||||
3. Payment buttons ([contact us](mailto:hello@btcmap.org))
|
||||
4. [Mapping](tagging-instructions.html)
|
||||
5. A new integration?!
|
||||
|
||||
### Projects
|
||||
|
||||
- [Coinos](https://coinos.io/)
|
||||
- [Wallet of Satoshi](https://www.walletofsatoshi.com/)
|
||||
- [Pouch](https://pouch.ph/)
|
||||
- [Bolt Card](https://www.boltcard.org/)
|
||||
- [Galoy](https://galoy.io/)
|
||||
- [Satimoto](https://satimoto.com/)
|
||||
- [Bitcoin Dashboard](https://bitcoin-primodata.streamlit.app/)
|
||||
- [BitLocal](https://www.bitlocal.app/)
|
||||
- [BTC Map Nostr Bot](https://github.com/BcnBitcoinOnly/btcmap-bot)
|
||||
- [Fedi](https://www.fedi.xyz/)
|
||||
- [Decouvre Bitcoin](https://decouvrebitcoin.fr/)
|
||||
- [Osmo](https://www.osmowallet.com/)
|
||||
- [Bitcoin Rocks!](https://bitcoin.rocks/)
|
||||
- [lipa](https://lipa.swiss/)
|
||||
- [Spirit of Satoshi](https://www.spiritofsatoshi.ai/)
|
||||
- [Blockstream](https://blockstream.com/local/)
|
||||
- [Satlantis](https://www.satlantis.io/)
|
||||
- [Aqua Wallet](https://aquawallet.io/)
|
||||
- [Adopting Bitcoin](https://www.adoptingbitcoin.org/)
|
||||
|
||||
### Featured on
|
||||
|
||||
- [Alby](https://getalby.com/)
|
||||
- [BOLT.FUN](https://makers.bolt.fun/project/btcmap)
|
||||
- [Lightsats](https://lightsats.com/guide/spend)
|
||||
- [Lightning Landscape](https://www.lightning-landscape.net/projects?modal=projectDetails¶ms=JTdCJTIycHJvamVjdElkJTIyJTNBJTIycmVjbHRBVGliNUI1Wm1vUm8lMjIlN0Q%3D)
|
||||
- [Minds Studio](https://mindsstudio.com/projects/adopting-bitcoin/)
|
||||
- [Geyser](https://geyser.fund/projects/btcmap)
|
||||
|
||||
**Have you integrated or featured BTC Map? Let us know!**
|
||||
25
lightning-tips.md
Normal file
25
lightning-tips.md
Normal file
@ -0,0 +1,25 @@
|
||||
# Lightning Tips ⚡
|
||||
|
||||
There are lightning tip buttons in different places around BTC Map indicating that you can send a donation to one of our Shadowy Supertaggers for their contributions to the bitcoin mapping community.
|
||||
|
||||
## Receiving tips
|
||||
|
||||
In order to receive tips and have your tip button appear on BTC Map you need to complete a few steps first.
|
||||
|
||||
1. ### Create a [lightning address](https://lightningaddress.com/) or an [LNURL-pay](https://github.com/fiatjaf/lnurl-rfc#lnurl-documents) string
|
||||
|
||||
- BTC Map supports either of these methods for accepting lightning payments. You can find a list of wallets that support both specs in the above links. You may already have a lightning address and not know, for example if you have a [stacker.news](https://stacker.news/) account you can find your lightning address on your profile page. It only takes a few clicks to setup a lightning address with many of the wallets linked above and you can share your address in other places online to receive tips there as well.
|
||||
|
||||
2. ### Add this information to your [OpenStreetMap](https://www.openstreetmap.org) user profile
|
||||
|
||||
- After logging into your OSM account, edit your profile description to include the following information: `[⚡](lightning:btcmap@zbd.gg)`
|
||||
- Replace `btcmap@zbd.gg` with your own lightning address or LNURL-pay string that you created in Step 1
|
||||
- Save your changes by clicking `Update Profile`
|
||||
|
||||
That's it! 🥳 You are now ready to receive lightning tips to your wallet for your contributions.
|
||||
|
||||
You will need to make an edit on OSM after updating your profile for the data to sync with BTC Map and it may take up to 24 hours.
|
||||
|
||||
## Sending tips
|
||||
|
||||
To send lightning tips on BTC Map simply click on the Tip button and it will open any lightning enabled bitcoin wallet installed on your device. There are many lightning wallets to choose from. If you are using BTC Map on a desktop or laptop we recommend using the [Alby](https://getalby.com/) browser extension for the most seamless experience.
|
||||
17
map-legend.md
Normal file
17
map-legend.md
Normal file
@ -0,0 +1,17 @@
|
||||
# Map Legend
|
||||
|
||||
## Payment methods ₿
|
||||
|
||||
| Method | Accepted | Not accepted | Unknown |
|
||||
| :-------------------: | :-------------------------: | :----------------------------: | :---------------------------------: |
|
||||
| On-chain |  |  |  |
|
||||
| Lightning |  |  |  |
|
||||
| Lightning contactless |  |  |  |
|
||||
|
||||
For more information on how these tags work you can check out our [Tagging Instructions](tagging-instructions.html#required-tags).
|
||||
|
||||
## Verified
|
||||
|
||||
|
||||
|
||||
Locations with a **Survey Date** that is less than one year old will have a verified checkmark indicating that the information is most likely up-to-date. If you visit a location and are able to pay with bitcoin it is best practice to update the `survey:date`, `check_date`, or `check_date:currency:XBT` tag yourself. More information on which tag to use can be found [here](tagging-instructions.html#verified-tags---more-information). Thanks for contributing to bitcoin open mapping!
|
||||
31
merchant-best-practices.md
Normal file
31
merchant-best-practices.md
Normal file
@ -0,0 +1,31 @@
|
||||
# Merchant Best Practices
|
||||
|
||||
Here are a few tips and tricks which will help you boost your bitcoin sales.
|
||||
|
||||
## Get a "Bitcoin Accepted" Sticker
|
||||
|
||||
Unfortunately, many bitcoiners don't know about BTC Map, and some of them may be your frequent customers. Putting a "Bitcoin Accepted" sticker at your entrance is a good way to target the "offline" audience.
|
||||
|
||||
|
||||
|
||||
Going all in is fun, but if it's not your cup of tea, a modest sticker wont hurt:
|
||||
|
||||
|
||||
|
||||
## Mention Bitcoin Acceptance on Your Website or Socials
|
||||
|
||||
Make sure your online visitors get the same treatment as the offline ones. People want to know how they can pay you, so it's a good place to mention Bitcoin. It also makes it easier for others to verify your business and update your entry on BTC Map.
|
||||
|
||||
## Consider Discounts for Bitcoiners
|
||||
|
||||
Everyone likes discounts, and bitcoiners are no exception. Offering a little discount may also help you convert a few locals, and it's always a good idea to expand our movement, which is critical for its success.
|
||||
|
||||
|
||||
|
||||
## Train Your Staff
|
||||
|
||||
Don't forget to notify your staff that you started accepting bitcoins. Many merchants fail to do so, which is the most common source of user complaints. If you hire someone new, don't forget to include Bitcoin training in your onboarding process.
|
||||
|
||||
## Check Your Records at Least Once a Year
|
||||
|
||||
If you followed the rest of the tips, you probably won't need to update your business details by yourself, it will be done automatically by your happy customers. You can always see the "last checked date" of your place on BTC Map. Make sure that date is no more than one year old. [Here is a guide](./outdated.md) on keeping your listing up-to-date.
|
||||
37
onboarding-merchants.md
Normal file
37
onboarding-merchants.md
Normal file
@ -0,0 +1,37 @@
|
||||
# Onboarding Merchants
|
||||
|
||||
**A collection of resources to help onboard new merchants with accepting bitcoin as payment. 🤝**
|
||||
|
||||
- [BTC Map Stickers!](https://github.com/teambtcmap/btcmap-general/tree/main/design/stickers)
|
||||
- [Bitcoin for Local Business](https://bitcoinforlocalbusiness.com/)
|
||||
- [Bridge 2 Bitcoin](https://bridge2bitcoin.com/) - UK-focused
|
||||
- [Bitcoin Bridge](https://bitcoin-bridge.de/) - Merchants onboarder focused on Germany
|
||||
- [Bitcoin Rocks! Business Kit](https://bitcoin.rocks/business/kit)
|
||||
- [Bitcoin Rocks! Accounting Guide](https://bitcoin.rocks/business/accounting)
|
||||
- [Bitcoin Rocks! Business FAQ](https://bitcoin.rocks/business/faq)
|
||||
- [Bitcoin Rocks! Business Wallet Resource](https://bitcoin.rocks/business/wallets)
|
||||
- [Bitcoin Rocks! Stickers](https://bitcoin.rocks/business/stickers)
|
||||
|
||||
**Hints and Tips**
|
||||
|
||||
- Simply ask "Cash or bitcoin" to raise awareness, particularly if you're a regular.
|
||||
- Ask your server if they would like their tip (maybe double it!) in bitcoin and have them download a simple custodial wallet like [Wallet of Satoshi](https://www.walletofsatoshi.com/) to get started; non-custodial can wait.
|
||||
- If you are speaking to the manager, don't necessarily try to Orange Pill them on day 1. Talk about bringing in more customers with very little effort.
|
||||
|
||||
**Payment Providers**
|
||||
|
||||
There are a number of merchant solutions to help vendors take payment in bitcoin and optionally convert to local fiat:
|
||||
|
||||
- [Coinos](https://coinos.io/)
|
||||
- [Alby BuzzPay](https://pos.albylabs.com/)
|
||||
- [Wallet of Satoshi POS](https://www.walletofsatoshi.com/pos)
|
||||
- [Breez POS](https://breez.technology/mobile/) (non-custodial)
|
||||
- [Swiss Bitcoin Pay](https://swiss-bitcoin-pay.ch/)
|
||||
- [IBEX Pay](https://www.ibexpay.io/)
|
||||
- [CoinCorner](https://www.coincorner.com/)
|
||||
- [Pouch](https://pouch.ph/)
|
||||
- [Galoy](https://galoy.io/)
|
||||
- [Strike](https://strike.me/)
|
||||
- [Confirmo](http://confirmo.net)
|
||||
|
||||
If you know of any other easy to use point-of-sale applications for new merchants please let us know!
|
||||
45
outdated.md
Normal file
45
outdated.md
Normal file
@ -0,0 +1,45 @@
|
||||
# Outdated Locations
|
||||
|
||||
As Satoshi Nakamoto [clearly stated](https://btcmap.org/bitcoin.pdf), Bitcoin is an electronic cash system, and the best way to accelerate Bitcoin adoption is to create a [circular enomomy](https://blog.bitfinex.com/education/a-look-at-bitcoin-circular-economies-around-the-world/).
|
||||
|
||||
Having a map of all participating merchants is how we can bootstrap new regions. All bitcoiners should be able to find each other and trade goods and services without touching the fiat infrastructure. That's what we're working on, and we need your help.
|
||||
|
||||
Nothing lasts forever, and our merchants are no exception. Some shops may go out of business or just move across the street. That's why we need to check them from time to time. We're attempting to check every merchant at least once per year, and we can't do it without the help of local bitcoiners.
|
||||
|
||||
If you want to help us accelerate Bitcoin adoption, please read this simple step-by-step guide:
|
||||
|
||||
## 1. Find a Merchant on BTC Map
|
||||
|
||||
Let's say you're living in (or visiting) Kuala Lumpur, Malaysia, and you want to check the merchants nearby:
|
||||
|
||||
|
||||
|
||||
It looks like this cafe accepts Bitcoins, and the last verification date is `2024-01-28`. In order to re-verify this place, you need to open it on OpenStreetMap. Click on the `"Edit"` button, you will need to create a OSM account if you don't already have one.
|
||||
|
||||
## 2. Update Merchant Details on OpenStreetMap
|
||||
|
||||
In the location editor:
|
||||
|
||||
|
||||
|
||||
Check that all fields are valid and accurate. If some fields are outdated or false, please update them.
|
||||
|
||||
## 3. Bump Check Date
|
||||
|
||||
Set the `"Last Checked Date"` field value to today's date and then press `"Save"`:
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Every OSM change requires a short description. If you only changed the check date, you can type `"Bump check date"`. If you updated additional fields, you can mention that as well. After entering the changeset comment, hit the `"Upload"` button.
|
||||
|
||||
|
||||
|
||||
_Note: There are other tags that can be used to verify a location including `survey:date`. The location you are editing may have one of those tags instead of the `"Last Checked Date"` tag. You can read more about the different verified tags [here](tagging-instructions#verified-tags---more-information)._
|
||||
|
||||
## 4. You're Awesome!
|
||||
|
||||
As you can see, verifying locations usually takes a couple of minutes, and everyone can do it.
|
||||
|
||||
_Note: If you visited the location and found that the merchant no longer accepts bitcoin, you would simply remove the [bitcoin-related tags](tagging-instructions#required-tags) from the merchant._
|
||||
49
resources.md
Normal file
49
resources.md
Normal file
@ -0,0 +1,49 @@
|
||||
# Resources
|
||||
|
||||
## Tools 🔨
|
||||
|
||||
### Query and export data from OSM
|
||||
|
||||
[Overpass Turbo](https://overpass-turbo.eu/)
|
||||
|
||||
## OpenStreetMap Resources 📚
|
||||
|
||||
[Abuse](https://wiki.openstreetmap.org/wiki/Abuse)
|
||||
|
||||
[Automated Edits](https://wiki.openstreetmap.org/wiki/Automated_Edits)
|
||||
|
||||
[Automated Edits - Code of Conduct](https://wiki.openstreetmap.org/wiki/Automated_Edits_code_of_conduct)
|
||||
|
||||
[Best Practices](https://wiki.openstreetmap.org/wiki/Good_practice)
|
||||
|
||||
[Bitcoin (OSM)](https://wiki.openstreetmap.org/wiki/Bitcoin)
|
||||
|
||||
[Cryptocurrency](https://wiki.openstreetmap.org/wiki/Cryptocurrency)
|
||||
|
||||
[Data Working Group](https://wiki.osmfoundation.org/wiki/Data_Working_Group)
|
||||
|
||||
[Good Changeset Comments](https://wiki.openstreetmap.org/wiki/Good_changeset_comments)
|
||||
|
||||
[Import Guidelines](https://wiki.openstreetmap.org/wiki/Import/Guidelines)
|
||||
|
||||
[Licence Compatibility](https://wiki.osmfoundation.org/wiki/Licence/Licence_Compatibility)
|
||||
|
||||
[Organised Editing Guidelines](https://wiki.osmfoundation.org/wiki/Organised_Editing_Guidelines)
|
||||
|
||||
[Organised Editing - BTC Map](https://wiki.openstreetmap.org/wiki/Organised_Editing/Activities/BTCMap)
|
||||
|
||||
[Source](https://wiki.openstreetmap.org/wiki/Key:source)
|
||||
|
||||
[Spam](https://wiki.openstreetmap.org/wiki/Spam)
|
||||
|
||||
[taginfo](https://taginfo.openstreetmap.org/)
|
||||
|
||||
[Verifiability](https://wiki.openstreetmap.org/wiki/Verifiability)
|
||||
|
||||
### Wiki
|
||||
|
||||
[https://wiki.openstreetmap.org/wiki/Main_Page](https://wiki.openstreetmap.org/wiki/Main_Page)
|
||||
|
||||
### Community Forum
|
||||
|
||||
[https://community.openstreetmap.org/](https://community.openstreetmap.org/)
|
||||
7
services.md
Normal file
7
services.md
Normal file
@ -0,0 +1,7 @@
|
||||
# Services
|
||||
|
||||
Local services that accept bitcoin are great, however in order to be mapped they need to have a real physical location. OpenStreetMap rules state that [verification](https://wiki.openstreetmap.org/wiki/Verifiability) is a key component to being eligible for mapping. This means that anyone should be able to visit the location and verify that it exists as described on the map. Services are accepted if they have an in-person location. If not, then there are other good options for being discovered by bitcoiners listed below:
|
||||
|
||||
- [satmap](https://satmap.app/)
|
||||
- [BitList](https://www.bitlist.com/)
|
||||
- [Spend in Bitcoin](https://spendinbitcoin.com/)
|
||||
45
verifying-locations.md
Normal file
45
verifying-locations.md
Normal file
@ -0,0 +1,45 @@
|
||||
# Verifying Locations
|
||||
|
||||
## Verify, don't trust. 🕵️
|
||||
|
||||
Does a location accept bitcoin?
|
||||
|
||||
You can verify this in a number of ways:
|
||||
|
||||
- visit the location in person
|
||||
- phone the location
|
||||
- check their website or other online sources
|
||||
- ask a local in the area
|
||||
- contact via social media
|
||||
- send them an email
|
||||
|
||||
Once a location has been verified you can update the [survey tags](tagging-instructions.html#verified-tags---more-information) on OpenStreetMap so that the location will have a [checkmark](map-legend.html#verified) visible on BTC Map.
|
||||
|
||||
Below is an email template for the UK that you can use as a starting point and adapt it to contain correct information about your own local area.
|
||||
|
||||
---
|
||||
|
||||
Hello,
|
||||
|
||||
I appreciate that you are busy, so thank you for taking a couple of minutes to read and respond to this email. I'm part of a team of volunteers working on [BTCmap.org](https://btcmap.org/) - an open source map which shows all merchants which accept Bitcoin worldwide. According to OpenStreetMap data, your business accepts Bitcoin - or perhaps did so in the past!
|
||||
|
||||
Please can you reply to this email with the following information:
|
||||
|
||||
**A) Yes, we still accept Bitcoin!**
|
||||
|
||||
**B) We no longer accept Bitcoin, but would be interested in accepting it in the future**
|
||||
|
||||
**C) We no longer accept Bitcoin and have no interest in accepting it in the future**
|
||||
|
||||
Before you respond with Option C) you might want to consider that Bitcoin payments have come a long way in recent years...
|
||||
|
||||
- The "Lightning network" allows Bitcoin to be sent near-instantly with very low fees - you can even accept contactless [Bitcoin card](https://www.boltcard.org/) payments!
|
||||
- Services such as [CoinCorner](https://www.coincorner.com/) allow you to automatically convert the Bitcoin you receive into GBP.
|
||||
- There is a growing community of bitcoiners who want to spend their "sats". Accept it and they will come!
|
||||
- Free and impartial advice on getting started is available from [Bridge2Bitcoin](http://bridge2bitcoin.com/).
|
||||
|
||||
I look forward to hearing from you soon. Happy to chat and answer any questions that you may have!
|
||||
|
||||
All the best,
|
||||
|
||||
Matt
|
||||
Loading…
x
Reference in New Issue
Block a user