Prueba tu integración

Hay dos formas de probar, y responden a preguntas distintas:

• Las claves de prueba responden a "¿esta petición es correcta?". Cada llamada se comprueba y se simula, no se guarda nada.
• El sandbox (para partners) responde a "¿funciona toda mi integración?". Todo ocurre de verdad, con empresas, canales, webhooks y pedidos reales, pero no se factura nada.

La mayoría de las integraciones usan ambos: claves de prueba mientras escribes cada llamada, y el sandbox para ejecutar el flujo completo de principio a fin antes de salir a producción.

De un vistazo

Claves de prueba

Crea una en Configuración → Desarrolladores (modo Prueba). Úsala exactamente como una clave live:

curl -X POST https://api.nembol.com/rest/v1/products \
  -H "Authorization: Bearer nbl_test_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"title": "Test mug", "variants": [{"sku": "MUG-1", "price": "12.00", "quantity": 5}]}'

La respuesta tiene la forma que devolvería una llamada live, con "simulated": true. Los errores son reales: un campo que falta, un formato de precio incorrecto o un permiso que falta responden exactamente igual que en live.

Lo que una clave de prueba no hace:

• No se guarda nada. Las llamadas de lectura devuelven los datos reales de tu tienda, así que un producto simulado nunca aparece en GET /products. Prueba cada escritura por separado; no encadenes "crear y luego volver a leer".
• No se contacta ningún canal, no se envía ningún pedido, no se manda ningún email.
• Las llamadas simuladas no generan eventos ni webhooks.

Sandbox (partners)

El sandbox es tu cuenta de partner con la facturación desactivada. Todo funciona como en live (esa es la idea), así que puedes construir toda la integración y verla funcionar:

1. Tu cuenta de partner empieza en el sandbox: Nembol la activa así. Compruébalo con GET /partner/billing, que responde "sandbox": true y "sandbox_max_accounts": 3.
2. Crea hasta 3 empresas con POST /accounts. Una 4.ª empresa abierta responde 409 sandbox_limit. Cierra una (POST /accounts/{id}/close) para liberar una plaza.
3. Conecta tiendas de prueba, no tiendas reales: una development store de Shopify, una cuenta de prueba de eBay o Etsy, un sitio WooCommerce tuyo. Los anuncios, el stock y los pedidos les llegan de verdad. Los marketplaces con compradores (Amazon, TikTok Shop) son marketplaces reales, así que publica con cuidado y retira los anuncios al terminar.
4. Recibe webhooks y consulta la API exactamente como en producción: los eventos de cada empresa llegan a tus endpoints con account_id.
5. Revisa el extracto: GET /partner/statement lista tus empresas con importe 0 y "sandbox": true.

Pasar a producción

Cuando tu integración esté lista, sal a producción tú mismo desde el panel: Configuración → Partner → Pasar a producción (en el aviso de Sandbox).

1. Si pagas con tarjeta, añade primero una tarjeta. Nembol abre una página segura de Stripe que guarda la tarjeta y no cobra nada.
2. Confirma. La ventana muestra cuántas empresas están abiertas y cuánto cuestan al mes con tus tarifas. La facturación empieza ese día, prorrateada por día.
3. Después, GET /partner/billing responde "sandbox": false.

Tu clave, tus empresas, sus canales y tus webhooks se quedan exactamente como están, sin nada que migrar. Cierra antes de salir a producción las empresas de prueba que no quieras que se facturen.

Pasar a producción es un paso sin vuelta atrás: volver dejaría de facturar empresas reales, así que para regresar al sandbox escribe a developer@nembol.com. No está disponible desde la API a propósito: la facturación nunca empieza por error desde un script.

Cuál usar y cuándo

• Escribes una llamada nueva o una nueva rama de error → clave de prueba.
• Compruebas que un handler de webhook, el flujo de conexión (enlace de retorno), la consulta de pedidos y el envío funcionan juntos → sandbox.
• Una integración solo para vendedor (sin programa de partners) → clave de prueba, luego una clave live en una tienda de prueba conectada a tu propia tienda Nembol.

Última actualización el 20 de octubre de 2026