Referencia
Una cuenta puede tener varias tiendas. Cada llave cobra a nombre de una.
/v1/merchantsLos comercios de tu organización que ya están activados.
/v1/merchants/{id}Un comercio. Responde 404 si no es tuyo.
/v1/merchants/{id}Actualiza sus datos.
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
name | texto | no | Razón social o nombre del negocio. |
alias | texto | no | Nombre corto, el que ve el comprador. |
email | texto | no | Contacto del comercio. |
phone | texto | no | Línea de atención al cliente: la que llaman el comprador o su banco. |
website | URL | no | Su sitio o su perfil (instagram.com/tienda, wa.me/573001234567), no una dirección genérica. Sin espacios ni @. Obligatorio si vende en línea o con links de pago; si vende en persona, hace falta este o phone. |
activity | texto | no | A qué se dedica. |
default_currency | texto | no | COP. |
supported_currencies | lista | no | Las que acepta. |
billing_address | objeto | no | Dirección de facturación. |
location_address | objeto | no | Dirección física. |
tax_information | objeto | no | Identificación tributaria. |
El sitio web y el teléfono llegan a la red de tarjetas. UnPUTconwebsiteophoneen un comercio ya registrado en la red se le pasa primero al procesador, porque las redes de tarjetas los exigen; solo si los acepta se guardan. Si no los acepta responde422(contact_rejected), y si no se pudo hablar con él,502: en los dos casos no se guarda nada. Un comercio que vende en línea no puede quedar sin sitio web, ni ningún comercio sin sitio y sin teléfono. Un cuerpo vacío responde400.
Listar comercios
curl "https://api.lane.money/v1/merchants" \
-H "Authorization: Bearer sk_test_…"Respuesta 200
{
"object": "list",
"data": [
{
"id": "b21f…",
"name": "Café Vecino S.A.S.",
"alias": "Café Vecino",
"default_currency": "COP",
"supported_currencies": ["COP"]
}
]
}Esta página en markdown: /docs/api/comercios.md · Toda la documentación: /docs/llms-full.txt