Lane · Documentación

Referencia

Comercios

Una cuenta puede tener varias tiendas. Cada llave cobra a nombre de una.

GET/v1/merchants

Los comercios de tu organización que ya están activados.

GET/v1/merchants/{id}

Un comercio. Responde 404 si no es tuyo.

PUT/v1/merchants/{id}

Actualiza sus datos.

El objeto

CampoTipoObligatorioDescripción
nametextonoRazón social o nombre del negocio.
aliastextonoNombre corto, el que ve el comprador.
emailtextonoContacto del comercio.
phonetextonoLínea de atención al cliente: la que llaman el comprador o su banco.
websiteURLnoSu 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.
activitytextonoA qué se dedica.
default_currencytextonoCOP.
supported_currencieslistanoLas que acepta.
billing_addressobjetonoDirección de facturación.
location_addressobjetonoDirección física.
tax_informationobjetonoIdentificación tributaria.
El sitio web y el teléfono llegan a la red de tarjetas. Un PUT con website o phone en 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 responde 422 (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 responde 400.

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