Sandbox

Ver también: README · Autenticación

#Cómo obtener acceso

1. Primero CardV tiene que aprobar tu empresa.
2. Inicia sesión en el Portal y elige Sandbox en la parte superior. No es posible iniciar sesión directamente en Sandbox.
3. La primera vez, CardV crea tu cuenta de Sandbox. Tiene el mismo Merchant ID y 1,000 USD de dinero de prueba.
4. En Sandbox, un Owner crea y muestra una clave de API de Sandbox. Las claves de Live no funcionan aquí.
5. Opcional: configura un webhook de Sandbox. Tiene su propio secreto de firma.

#Qué es independiente

• Sandbox tiene sus propias claves, billetera, pedidos, webhooks, lista de IPs permitidas y registro de auditoría.
• La configuración no se comparte. Configura las claves, los webhooks y la lista de IPs en cada entorno.
• Los pedidos de Sandbox nunca compran productos reales. Los códigos de prueba no se pueden canjear.
• El dinero de prueba no tiene valor. En Sandbox no puedes agregar fondos, retirarlo ni pasarlo a Live.
• Si se te acaba el dinero de prueba, pide más al soporte de CardV.

#Dinero de prueba

Los pedidos usan el dinero de prueba igual que los pedidos de Live usan dinero real. Los pedidos de prueba fallidos se reembolsan de la misma forma. Puedes ver los movimientos del dinero de prueba en la página de transacciones del Portal.

#Catálogo de prueba

• El catálogo de Sandbox es pequeño y solo tiene productos de prueba.
• Los IDs de SKU son distintos a los de Live. Búscalos siempre con GET/skus en Sandbox.
• Nunca copies IDs de Sandbox a tu configuración de Live, ni al revés.
• Los precios, la disponibilidad y la velocidad de entrega en Sandbox no son iguales a los de Live.

#Lista de pruebas

• GET/account muestra tu Merchant ID y "api_access_enabled": true.
• GET/balance funciona.
• Puedes recorrer todas las páginas de GET/skus y solo pides SKUs available.
• Un pedido firmado se procesa bien. Una firma incorrecta recibe HTTP 403.
• Envías expected_unit_price en cada línea del pedido.
• Funciona un pedido de un SKU de monto variable con amount (si Sandbox tiene uno).
• Enviar el mismo pedido dos veces (nonce nuevo, mismo cuerpo y mismo número de pedido) devuelve HTTP 200 con el mismo order_id. Tu saldo se cobra una sola vez.
• El mismo número de pedido con otro cuerpo devuelve HTTP 400 en external_order_id.
• Después de un tiempo agotado, tu código reenvía el mismo pedido en vez de crear un número de pedido nuevo.
• Lees deliveries[].display_fields y se los entregas al cliente.
• Manejas failed, refunded y partially_succeeded.
• Tu código de webhooks pasa el vector de prueba y luego un webhook real de Sandbox. Los duplicados se ignoran.
• Esperas lo que indica Retry-After después de un HTTP 429.
• Tus logs no contienen claves de API, firmas, códigos ni datos de cuentas de clientes.

#Lista para salir a producción

• Crea una clave de API de Live en el Portal de Live. Guárdala en tu gestor de secretos de producción.
• Cambia la URL base a https://b2b.cardv.net/api/v1 en tu configuración.
• Carga el catálogo de Live y asocia tus productos con los IDs de SKU de Live.
• Agrega fondos a tu billetera de Live en el Portal. Configura una alerta de saldo bajo.
• Opcional: agrega las IPs de tus servidores a la lista de IPs permitidas de Live.
• Configura un webhook de Live e instala su secreto de firma.
• Confirma con CardV tus límites de pedidos y tu límite de solicitudes.
• Haz un pedido pequeño en Live. Revisa el cobro, los códigos y el webhook. Después aumenta el tráfico poco a poco.
• Concilia a diario con la página de transacciones y las exportaciones del Portal.
• Activa la verificación en dos pasos para todos los Owners.

#Solución de problemas

HTTP 403 error code: 1010

El servidor de Sandbox está detrás de un servicio de red perimetral. Algunos clientes HTTP reciben HTTP 403 con el texto plano error code: 1010. La solicitud nunca llegó a CardV, así que cambiar tu clave o tu firma no sirve de nada.

• Usa un User-Agent claro.
• Si el problema sigue, envía al soporte de CardV la IP de tu servidor, tu User-Agent y la hora.
• Nunca hagas las pruebas en Live como alternativa.