Para plataformas

Probar tu integración de plataforma

Todo el recorrido se prueba con una llave sk_test_, sin mover plata. Para salir a real cambias la llave.

Antes de empezar

Tu empresa ya es plataforma. Si las rutas responden 403 con not_a_platform, falta ese paso: escríbenos.
Una llave `sk_test_` de tu empresa, creada en Desarrolladores → Llaves de API.
Un endpoint de webhook en modo Prueba, en Desarrolladores → Webhooks. Guarda su secreto whsec_….
Una segunda cuenta de Lane, con otro correo, para hacer de comercio. El comercio de tu propia empresa no se conecta a tu plataforma: ese ya cobra con tus llaves.

El recorrido

1. Conecta un comercio de prueba

Crea un enlace de registro y ábrelo con la segunda cuenta. Acepta la conexión, activa el comercio y espera merchant.connected en tu endpoint. Trae el id del comercio.

Comprobar que quedó conectado

curl https://api.lane.money/v1/platform/merchants \
  -H "Authorization: Bearer sk_test_…"

Respuesta 200

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "connected_merchant",
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "name": "Tienda de Ana",
      "reference": "vendedor-77",
      "status": "active",
      "can_charge": true,
      "connected_at": "2026-10-10T15:02:11.000Z",
      "disconnected_at": null
    }
  ]
}

2. Crea un cobro y págalo

Crea el cobro como en Crear cobros, abre checkout_url y paga. En modo de prueba no todos los datos aprueban. Estos son los que medimos:

Medio	Con qué aprueba en pruebas	Cuánto tarda
Bre-B	Un total de exactamente $ 15.000 COP (`1500000`).	Se aprueba solo, entre 15 segundos y 2 minutos.
Daviplata	El celular `+573333012306` y el código `123456`. Probado con $ 20.000 COP.	Al confirmar el código.
Tarjeta	La `4242 4242 4242 4242`, con cualquier fecha futura y cualquier código de tres dígitos. Probado con $ 189.900 COP. Las demás, con sus rechazos, están en Sandbox.	Al confirmar el código de seguridad te llega `payment.succeeded`. La captura llegó al día siguiente, y con ella se anotó tu parte.

Lo que no hemos recorrido. Bre-B, Daviplata y tarjeta se recorrieron completos en la página de pago, en modo de prueba, el 10 de octubre de 2026. PSE y Nequi no: dependen del simulador de cada red. Si alguno te falla en pruebas, escríbenos antes de darlo por un error tuyo.

3. Recibe el aviso

Verifica la firma, busca el pedido por checkout_session_id y márcalo pagado. El aviso sale poco después del pago: las entregas se despachan cada minuto. Si no llega, mira los intentos en Desarrolladores → Webhooks.

4. Prueba lo que sale mal

Prueba	Qué debe pasar
La misma petición dos veces con la misma `Idempotency-Key`	El mismo cobro, con la cabecera `Idempotent-Replayed: true`.
La misma clave con otro cuerpo	`422` con `idempotency_key_reused`.
Un `Lane-On-Behalf-Of` que no es de un comercio tuyo	`404` con `merchant_not_connected`.
Un medio que el comercio no tiene	`422` con `payment_method_unavailable`.
Un cobro con `extra_items`, sumando uno al pagar	El aviso trae el total mayor y `extra_items`.
El mismo aviso entregado dos veces	Tu sistema entrega el pedido una sola vez.

Antes de salir a cobros reales

Tus condiciones están puestas. Míralas en Plataforma: si tu parte está en cero, los cobros que crees no te dejan nada.
Tienes un endpoint de webhook en modo Real. Los de prueba no reciben los avisos de cobros reales.
Cambiaste la llave por una `sk_live_`. Nada más cambia en tu código.
El comercio está aprobado. Espera merchant.approved, o revisa que can_charge sea true con la llave real.
Guardas el `id` de cada cobro y reconoces el pedido por checkout_session_id.
Lees el total y los extras del aviso, no los que mandaste.
Mandas `Idempotency-Key` en cada cobro y en cada enlace.
Ninguna `sk_` quedó en un repositorio ni en el código que corre en el navegador o en el teléfono.

Esta página en markdown: /docs/plataformas/pruebas.md · Toda la documentación: /docs/llms-full.txt