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

Para qué	Número	Vence	CVV
Aprobar un cobro	`4111111111111111`	12/30	123
BIN de crédito, para probar cuotas	`518617` · `541333`	—	—

No hay tarjetas de rechazo estándar. Los números de rechazo que usan otras pasarelas —4000000000000002 y parientes— acá pueden aprobar igual. Para probar un rechazo, pídele a soporte los datos que lo fuerzan en tu entorno.

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