From c1026dc3083860344de6524dedc1bd00bcc8d193 Mon Sep 17 00:00:00 2001
From: Edwin Comino <comino@noreply.localhost>
Date: Fri, 21 Nov 2025 16:43:34 +0000
Subject: [PATCH] Add Tagging Square Merchants

---
 Tagging-Square-Merchants.md | 83 +++++++++++++++++++++++++++++++++++++
 1 file changed, 83 insertions(+)
 create mode 100644 Tagging-Square-Merchants.md

diff --git a/Tagging-Square-Merchants.md b/Tagging-Square-Merchants.md
new file mode 100644
index 0000000..c8f42b3
--- /dev/null
+++ b/Tagging-Square-Merchants.md
@@ -0,0 +1,83 @@
+![wiki banner tagger](https://gitea.btcmap.org/teambtcmap/btcmap-general/raw/branch/main/wiki-images/wiki-banner-tagging.png)
+
+# Let’s put those Square merchants on the map!
+
+Great to see you here. Below you’ll find everything you need to help us tag the businesses that announced they now accept Bitcoin. Work at your own pace, ask questions anytime on Discord, and most of all: have fun while mapping!
+
+# What you’ll need
+
+- A computer with two monitors (makes life easier)
+- Access to OpenStreetMap, Gitea and Discord
+- Access to Facebook & Instagram for quick verifications
+- Some OSM tagging experience, or the willingness to read our guide
+- A careful eye and a bit of perseverance
+
+**Tip**: use the same handle on OSM, Gitea and Discord so we can ping you quickly if something looks odd
+
+If you’d like, we’ll pair you with a buddy who will walk you through tagging your very first ticket.
+
+# Step-by-step workflow
+
+#### 1. Log in to [Gitea]([url](https://gitea.btcmap.org/))
+#### 2. Pick a ticket
+    Open any open issue → click “Assignees” on the right → choose yourself
+#### 3. Verify the merchant
+Search engines, the company website, Facebook and Instagram are your friends.
+Rule of thumb: website data wins.
+#### 4. Check OSM
+    Click the “OpenStreetMap editor link” in the Gitea ticket.
+Zoom in/out to see if the place is already mapped.
+
+    Already there? Add the following tags:
+
+`check_date:currency:`
+
+`check_date=`
+
+`currency:XBT=yes`
+
+`payment:lightning=yes`
+
+`payment:lightning_contactless=no`
+
+`payment:onchain=no`
+
+`payment:lightning:operator=square`
+
+    Not there yet?
+    Click “Point” in the OSM web editor and drop it on the correct doorstep.
+    Choose the most fitting category (restaurant, hair salon, coffee café …).
+    
+    Fill name and address (normal case, no ALL-CAPS, drop legal suffixes like LLC/Inc./Corp.).
+    
+    Add opening hours
+    (use tools like https://projets.pavie.info/yohours/)
+    
+    Add phone tag 
+    Use syntax +1 123 456 7890
+    
+Optional extras if listed:
+
+`email=`
+
+`contact:facebook=`
+
+`contact:instagram=`
+
+#### 5. Upload to OSM
+Use a changeset comment such as
+`#btcmap – Merchant added`
+or
+`#btcmap – Bitcoin tags added`
+
+#### 6. Close the ticket
+    Add a label → click “Labels” on the right → choose status
+
+- `status/pending`: The submission is being verified.
+- `status/added`: The submission has been verified and has either been added to OSM or already exists on OSM.
+- `status/rejected`: The submission could not be verified and was not added to OSM. 
+
+#### 7. Close the ticket
+    Copy the OSM URL of the node into the Gitea ticket → click “Close with comment”.
+    
+That’s it time for the next one!