Plataforma

Sandbox

El mismo código, la misma URL, otra llave. En sandbox no se mueve plata.

Sandbox no es un servidor aparte: es el mismo, respondiendo distinto según la llave. Una sk_test_ cobra en pruebas y una sk_live_ cobra de verdad, sobre las mismas rutas. Los datos están separados: un cobro de prueba no aparece en los listados de producción.

Antes de empezar

Registra tu comercio de prueba en Configuración → Comercio y sandbox. Sin esto no se puede crear ningún cobro.
Crea una llave sk_test_ en Desarrolladores → Llaves de API.
Crea un endpoint de webhook y guarda su secreto whsec_….

Tarjetas

En pruebas, lo que decide cómo termina un cobro es el número de la tarjeta, no el monto. Todo lo demás es libre:

Dato	Qué usar
Fecha de vencimiento	Cualquier fecha futura. Por ejemplo `12/30`.
Código de seguridad	Cualquier valor de tres dígitos. Por ejemplo `123`.
Nombre del titular	Cualquiera.
Monto	No cambia el resultado.
Código del desafío 3-D Secure	`1234`, cuando la pantalla lo pida.

Para aprobar un cobro

Tarjeta	Marca y producto	Qué pasa
`4111 1111 1111 1111`	Visa, débito	Aprueba. No da cuotas.
`4242 4242 4242 4242`	Visa, crédito	Aprueba. Su reembolso se rechaza: mira más abajo.
`4258 1800 0000 0001`	Visa, crédito	Aprueba.
`4093 5500 0000 0020`	Visa, débito	Aprueba.
`5306 9100 0000 0091`	Mastercard, débito	Aprueba.
`5330 0105 0000 0004`	Mastercard, débito	Aprueba.

Cualquier otro número de tarjeta válido también aprueba. Por eso los números de rechazo de otras pasarelas, como 4000 0000 0000 0002, acá aprueban igual. Para consultar un BIN de crédito sin cobrar: 518617 o 541333.

Para probar un rechazo

Tarjeta	Marca y producto	Qué simula
`5555 4444 3333 1111`	Mastercard, débito	Fondos insuficientes.
`5404 0000 0000 0001`	Mastercard, débito	Rechazo por prevención de fraude.
`5100 0000 0000 0008`	Mastercard, crédito	Tarjeta vencida.
`5555 5555 5555 4444`	Mastercard, débito	Error de procesamiento.
`5200 8282 8282 8210`	Mastercard, crédito	Rechazo genérico.

Un cobro rechazado queda en failed y te llega payment.failed. El comprador puede intentar de nuevo en la misma página, con otra tarjeta o con otro medio.

Para probar un reembolso que no sale

Con la 4242 4242 4242 4242 el cobro se aprueba y el reembolso sobre ese pago se rechaza. Sirve para comprobar que tu sistema sabe qué hacer con un cobro hecho cuya devolución no salió. Para probar un reembolso que sí sale, usa cualquiera de las otras tarjetas de aprobación.

Para probar 3-D Secure

Solo aplica si pides la autenticación con checkout_options.require_3ds en una sesión de checkout. Sin desafío, el banco decide sin mostrarle nada al comprador:

Tarjeta	Marca	Cómo termina la autenticación
`4242 4242 4242 4242`	Visa	Autentica, sin pedir nada.
`5555 5555 5555 4444`	Mastercard	Autentica, sin pedir nada. Después el cobro falla: es también la de «error de procesamiento».
`4111 1111 1111 1111`	Visa	Queda como intento: el banco lo registró, sin confirmar ni negar.
`5424 1800 1111 3336`	Mastercard	Queda como intento.
`4264 2815 1111 2228`	Visa	Falla.
`5424 1800 0000 0171`	Mastercard	Falla.
`5405 0011 1111 1165`	Mastercard	No disponible.
`5405 0011 1111 1116`	Mastercard	Rechazada.

Con desafío, al comprador le aparece una pantalla que pide un código. En pruebas es 1234:

Tarjeta	Marca	Cómo termina el desafío
`4000 0200 0000 0000`	Visa	Exitoso.
`4005 5622 3121 2123`	Visa	Exitoso.
`4761 3699 8032 0253`	Visa	Exitoso. El desafío es obligatorio.
`4000 0000 0000 0341`	Visa	Exitoso, aprobado por fuera de la pantalla (en la app del banco).
`5200 0000 0000 1104`	Mastercard	Exitoso. El desafío es obligatorio.
`4005 5717 0111 1111`	Visa	Queda como intento.
`4055 0111 1111 1111`	Visa	Falla.
`5427 6600 6424 1339`	Mastercard	Falla.

Y tres que simulan una falla del sistema de autenticación, que no es un rechazo del banco: 4264 2815 0000 3339 y 4264 2815 0000 1119 (Visa, error de los servidores de autenticación) y 5424 1800 1111 0001 (Mastercard, la tarjeta no admite 3-D Secure).

Cuáles recorrimos nosotros. En las páginas de Lane pagamos de principio a fin con la 4111 1111 1111 1111 y con la 4242 4242 4242 4242, la última el 10 de octubre de 2026. La marca y el producto de las tablas de aprobación y de rechazo los consultamos uno por uno el 12 de octubre de 2026. Los escenarios de rechazo, de reembolso y de 3-D Secure son los que documenta el simulador del procesador y no los hemos recorrido todos: si alguna tarjeta no se porta como dice acá, escríbenos.

Qué se puede probar

	Sandbox
Cobro con tarjeta	Sí, de punta a punta
Guardar una tarjeta y cobrarla después	Sí
Webhooks con firma real	Sí
Cuotas	Solo con una tarjeta de crédito; la de prueba es débito
PSE, Nequi, Daviplata, Bre-B	Depende del riel: algunos no tienen simulador
Contracargos	No se pueden originar; se consultan si existen

Pasar a producción

Cambia la llave por una sk_live_. Nada más cambia en tu código.
Crea el endpoint de webhook de producción: los endpoints no se comparten entre entornos.
Revisa que ningún sk_ haya quedado en el repositorio ni en el bundle del front.
Haz un cobro real de monto bajo y reembólsalo. Es la única prueba que cuenta.

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