Con qué se termina
Un negocio que acepta bitcoin, listado en MappingBitcoin y legible por cualquier otra herramienta construida sobre los mismos datos, cargado por uno mismo y comprobado después para confirmar que efectivamente está ahí.
Una cosa que conviene decir antes de la recomendación y no después: el directorio de comercios de este sitio se mudó a MappingBitcoin, y MappingBitcoin es uno de los proyectos que enlazamos desde nuestra página de proyectos. Esa es la conexión, y por eso se nombra acá en lugar de dejarla para que alguien la descubra.
MappingBitcoin no guarda una base de datos privada de comercios. Su documentación de sincronización describe cargar locales desde OpenStreetMap a través de la API Overpass y después seguir el feed de replicación de OpenStreetMap para los cambios. El formulario de carga dice lo mismo en una línea debajo del botón de enviar: los locales enviados quedan públicamente visibles en OpenStreetMap.
Ese solo hecho define todo lo demás. No se presenta un registro ante una empresa. Se edita el mapa abierto que esa empresa lee, y que también lee todo lo demás construido encima. El mismo registro lo recoge BTC Map, el directorio comunitario de larga data, y cualquier otra herramienta que lea las mismas etiquetas. Nadie puede revocarlo ni ponerlo detrás de un acuerdo de API, y esa es la razón por la que esto vale una hora de trabajo y no cinco minutos.
Antes de empezar
- Un negocio que realmente acepte bitcoin, y la confirmación de la dueña o del encargado. No el cartel en la vidriera, no lo que dijo alguien en 2023.
- Qué método aceptan. On-chain, Lightning, o una terminal Lightning sin contacto. El formulario tiene una casilla separada para cada uno, y una ficha que se equivoca manda a la próxima persona a la caja con la billetera equivocada.
- Una cuenta gratuita de OpenStreetMap. El formulario termina derivando a openstreetmap.org para autorizar la edición, así que la carga queda hecha bajo la cuenta propia y aparece en el historial público de ediciones. No hace falta una cuenta de MappingBitcoin ni una clave Nostr para cargar un lugar: la guía de contribución de MappingBitcoin dice que Nostr solo se necesita para adjuntar una imagen.
- Diez minutos, con honestidad. Escribir es la parte rápida.
Probado el 20 de agosto de 2026 contra el formulario en vivo de mappingbitcoin.com/places/create, que cargó con tres pasos (About, Location, Details) y terminó en un botón Connect with OSM, y contra btcmap.org y api.btcmap.org, que devolvieron datos.
El costo que se está aceptando
Se publica una afirmación bajo la cuenta propia sobre la que otras personas van a actuar. Una ficha equivocada le cuesta un viaje perdido a la próxima persona y una conversación que no pidió al comercio, y no hay una cola de moderación entre la carga y el mapa. Ese es el precio de un conjunto de datos que no es de nadie.
Hay un costo menor que conviene nombrar. El historial de ediciones de OpenStreetMap es público y está atado a la cuenta, así que agregar los lugares que uno frecuenta deja un registro de por dónde anda.
Y un límite honesto sobre cuánto va a valer la ficha. La verificación existe en MappingBitcoin, pero casi nada la lleva todavía: el 20 de agosto de 2026 su página de estadísticas informaba 28.408 comercios en 155 países y 29 negocios verificados. Lo que se agrega es una afirmación de la comunidad, igual que casi todo lo demás en el mapa, hasta que alguien la verifique.
Pasos
La vía del formulario
- Confirmar con la dueña o el encargado que aceptan bitcoin, y preguntar específicamente con qué método.
- Abrir mappingbitcoin.com/places/create.
- En el paso About, escribir el nombre del negocio en el campo de nombre. Busca locales existentes mientras se escribe, y esa es la comprobación de duplicados: si el lugar ya está, conviene frenar y editar esa ficha en lugar de crear una segunda.
- Elegir una categoría. Es obligatoria, y es lo que ubica al lugar en el filtro correcto de la página de categorías.
- Completar los datos de contacto: sitio web, teléfono, correo. El correo conviene cargarlo bien, porque es lo que después va a usar la dueña para verificar la ficha.
- En el paso Location, buscar la dirección y arrastrar el marcador sobre el edificio real y no sobre la calle. Las coordenadas son el campo en el que más confía toda herramienta que lea estos datos.
- En el paso Details, cargar los horarios, marcar los métodos de pago y responder quién es uno respecto del lugar: dueña del negocio, cliente que lo visitó, u otra cosa. Lightning Contactless, Lightning y On-chain son las opciones de bitcoin; las opciones de tarjeta que están al lado son etiquetas comunes de pago de OpenStreetMap y no son lo que pone a un lugar en un mapa de bitcoin.
- Elegir Connect with OSM. La página deriva a openstreetmap.org para iniciar sesión y autorizar dos permisos: leer el perfil básico y escribir los cambios de mapa que se envíen desde el formulario. La contraseña de OpenStreetMap se queda en OpenStreetMap.
- Volver al paso Details y enviar.
Conviene conectar OSM antes de escribir algo largo. La guía de MappingBitcoin advierte que por ahora los borradores de edición no se restauran después de la vuelta por la autorización, así que una corrección larga escrita primero se puede perder en el camino.
La vía directa, para editar el mapa por cuenta propia
Todo lo de arriba termina siendo etiquetas de OpenStreetMap, y se pueden agregar a mano. Se inicia sesión en openstreetmap.org, se busca el negocio, se entra en Editar y se agrega:
currency:XBT=yes
payment:onchain=yes
payment:lightning=yes
payment:lightning_contactless=yes
Las últimas tres son los métodos, agregadas encima de currency:XBT y no en su lugar, y la
etiqueta de on-chain es payment:onchain y no el payment:bitcoin que se ve usado con
soltura en otros lados. Los directorios difieren en cuáles tratan como obligatorias. La
documentación de sincronización de MappingBitcoin enumera cuatro que vigila: currency:XBT,
payment:bitcoin, payment:lightning y bitcoin. Etiquetar currency:XBT=yes junto con el
método específico es la combinación que menos probablemente se le escape a alguno.
Después va una fecha, que es el campo que casi todo el mundo saltea. Se usa
survey:date=AAAA-MM-DD si se estuvo en el local comprobándolo, o
check_date:currency:XBT=AAAA-MM-DD si se confirmó por teléfono o desde el sitio de la
empresa. Es lo único que le dice al próximo lector cuándo miró una persona por última vez.
Guardar con un comentario de changeset diciendo que se confirmó con el negocio.
BTC Map también sigue teniendo un formulario, y funciona distinto: se completa y una persona voluntaria hace la edición en OpenStreetMap, sin plazo fijo. Para quien prefiera no tener cuenta de OpenStreetMap, esa vía existe y produce las mismas etiquetas.
Cómo comprobar que salió bien
- Encontrar la edición en openstreetmap.org. Tiene que estar en el historial de
ediciones de la cuenta, con las etiquetas escritas exactamente.
currency:xbten minúscula, ocurrency:XBT=true, no son la misma etiqueta y no se recogen. - Esperar, y después buscar en MappingBitcoin. La sincronización documentada procesa los diffs de OpenStreetMap cada minuto y regenera los slugs cada cinco, y la página de estadísticas dice que los totales se actualizan cada hora, pero conviene dar un día antes de concluir que algo falló.
- Abrir la ficha del lugar y releerla. Tiene que mostrar la categoría, la dirección y un bloque de métodos de pago con exactamente los que se marcaron. Si faltan los métodos de pago, lo que hay que revisar son las etiquetas.
- Comprobarlo en un segundo directorio. Buscar el mismo lugar en BTC Map. Que aparezca en los dos es la prueba de que se editó la fuente compartida y no el producto de una empresa, y es el argumento entero para hacerlo de esta manera.
- Avisarle al comercio que quedó listado. Muchas veces no saben que estos directorios existen, y un comercio que puede verse en el mapa es un comercio que va a seguir aceptando.
Si el negocio es propio, conviene verificarlo
Una ficha que pudo cargar cualquiera y una ficha cuya propiedad quedó probada son objetos
distintos, y la
página de verificación de MappingBitcoin
describe tres formas gratuitas de pasar de la primera a la segunda: un código enviado al
correo del negocio que figura en el registro de OpenStreetMap, un registro TXT de DNS en el
dominio propio, o un archivo servido desde /.well-known/ en el sitio propio. La
verificación queda atada a una clave pública de Nostr, así que hace falta una cuenta de
Nostr, y la propia página nombra el modo de falla: si los datos de contacto cambian en
OpenStreetMap hay una ventana de 30 días para volver a verificar antes de que la insignia
caduque. La del archivo en el sitio propio es la versión que no depende de los campos de
OpenStreetMap.
El costo es el habitual de la identidad basada en claves. La verificación pertenece a un par de claves bajo control propio, lo que significa que nadie puede quitarla y nadie puede restituirla. Si la clave se pierde, hay que verificar de nuevo desde cero.
Si algo sale mal
El negocio no aparece después de varios días. Revisar primero cómo quedó escrita la etiqueta; es la causa la enorme mayoría de las veces. Después, comprobar que la edición realmente se guardó y no quedó abierta en el navegador.
La autorización de OpenStreetMap fue denegada o venció. Reconectar y enviar de nuevo. Es comportamiento documentado y no una falla: la sesión de MappingBitcoin y la autorización de OpenStreetMap vencen con relojes distintos.
El envío falla en silencio. El formulario corre una comprobación anti bots, y los bloqueadores de scripts la frenan. Conviene recargar con el bloqueo desactivado para el sitio e intentar una vez más.
Hay dos entradas para el mismo lugar. Fusionarlas en OpenStreetMap en lugar de borrar una, para que sobreviva el historial de ediciones. Ante la duda, conviene dejar una nota en el nodo describiendo la duplicación y alguien con más experiencia lo va a resolver.
Otra persona revierte la edición. OpenStreetMap tiene sus propias normas, y una etiqueta de bitcoin en un negocio que no obviamente cobra pagos puede parecer spam. Conviene responder al changeset explicando que se confirmó con la dueña y en qué fecha. Es una conversación, no una decisión de moderación, y normalmente se resuelve.
El negocio deja de aceptar bitcoin. Volver y poner currency:XBT=no en lugar de borrar
la etiqueta. Un no es información y sobrevive; una etiqueta borrada se ve idéntica a un
negocio que nadie relevó nunca, y alguien la va a volver a agregar dentro de un año. Un yes
viejo es peor para el ecosistema que ninguna ficha, porque enseña que el mapa no es confiable,
que es lo más difícil de reparar.
El pipeline que convierte estas etiquetas en un directorio buscable, y las formas en que cada etapa produce basura, está descrito aparte.
Corrección, 20 de agosto de 2026. Este artículo se publicó como "Cómo agregar un negocio
a BTC Map" en /learn/btc-map-org y estaba escrito enteramente alrededor de BTC Map. Ahora
cubre la carga a través de MappingBitcoin, que escribe el mismo registro en OpenStreetMap, y
se mudó a /learn/add-a-bitcoin-business. Con eso cambiaron dos afirmaciones de hecho. La
versión anterior decía que currency:XBT era la única etiqueta exigida, presentado como un
hecho sobre BTC Map que este artículo ya no afirma en nombre de ningún directorio, y describía
la única alternativa a editar a mano como un formulario atendido por voluntarios. Hoy existe
un formulario de carga que se conecta con la cuenta propia de OpenStreetMap y escribe la
edición directamente, que es la vía descrita arriba.
Corrección, 20 de agosto de 2026. Una versión anterior de este artículo decía que el
conjunto de datos completo se podía descargar desde btcmap.org/api/venues.json, y describía
agregar una ubicación como hacer clic en un botón y ver la carga publicarse. Nada de eso era
exacto: esa URL devuelve 404, la API de BTC Map está en api.btcmap.org, y su vía del
formulario la atiende una persona voluntaria en lugar de publicarse de inmediato. Las dos
cosas fueron corregidas en su momento.