DocsPruebas de integracion
Configura tu entorno de pruebas y usa credenciales de prueba
Antes de pasar a produccion, utiliza un sitio web sandbox de Cost+ para verificar que tu integracion funciona correctamente. No existe una URL de sandbox separada — utilizas el mismo endpoint de la API de produccion (https://api.costplus.online/v1) con una clave API de un sitio web sandbox.
Obtener tu clave API de prueba
- Inicia sesion en el portal de comerciante
- Navega a Websites
- Crea un nuevo sitio web y selecciona Sandbox como tipo, o selecciona un sitio web sandbox existente
- Haz clic en Integration para encontrar tu clave API
- Usa esta clave API en tu integracion — todas las transacciones seran simuladas
El modo sandbox vs produccion se determina completamente por el tipo de sitio web en el portal de comerciante, no por la URL de la API. La clave API de un sitio web sandbox procesa transacciones simuladas; la clave API de un sitio web de produccion procesa pagos reales. Ambas usan el mismo endpoint de la API.
Numeros de tarjeta de prueba
Usa los numeros de tarjeta a continuacion para simular diferentes escenarios de pago. No uses numeros de tarjeta reales en modo de prueba.
| Numero de tarjeta | CVV | Marca | Resultado |
|---|---|---|---|
4111111111111111 | cualquiera | Visa | Exitoso |
5544330000000037 | cualquiera | Mastercard | Exitoso |
4462030000000000 | cualquiera | Visa | Exitoso |
4111111111111105 | cualquiera | Visa | Do Not Honor |
4111111111111143 | cualquiera | Visa | Stolen Card |
4111111111111151 | cualquiera | Visa | Insufficient Funds |
Usa cualquier fecha de caducidad futura y cualquier CVC de 3 digitos.
Los numeros de tarjeta de prueba solo funcionan en modo sandbox. Enviarlos a la clave API de un sitio web de produccion resultara en una transaccion rechazada.
Codigos de error
Cuando una transaccion falla, la API devuelve uno de los siguientes codigos de error en el campo reason de la transaccion:
| Codigo de error | Descripcion |
|---|---|
ERROR_CARD_AUTHENTICATION_FAILURE | La autenticacion 3DS no se completo a tiempo; pago cancelado |
ERROR_CARD_CVV_NOT_VALID | CVV con formato correcto pero no valido |
ERROR_CARD_INFORMATION_NOT_VALID | Datos de tarjeta con formato correcto pero no validos |
ERROR_CARD_NOT_SUPPORTED_FOR_ECOMMERCE | Transaccion no soportada para eCommerce |
ERROR_CARD_NOT_VALID | El ID de tarjeta no es valido |
ERROR_CARD_TYPE_DISABLED | El tipo de tarjeta esta deshabilitado |
ERROR_TRANSACTION_FAILED | La transaccion con tarjeta fallo |
ERROR_TRANSACTION_REJECTED_BY_CARD_PROCESSOR | Rechazada por el procesador (incluye codigo numerico de Visa/MC) |
ERROR_TRANSACTION_TYPE_NOT_ALLOWED_BY_SELLER | Tipo de transaccion no permitido por el vendedor |
ERROR_TRANSACTION_TYPE_NOT_SUPPORTED | No soportado por la red de tarjetas |
INVALID_CARD_CVV | CVV no reconocido |
INVALID_CARD_NUMBER | Numero de tarjeta no reconocido |
Errores comunes de validacion de la API
Estos errores se devuelven como 400 Bad Request cuando la solicitud a la API es invalida:
| Error | Descripcion |
|---|---|
| Unknown payment method | Proporcionaste un nombre de metodo de pago incorrecto |
| No permissions for payment method | Tu clave API (proyecto) no tiene permisos para el metodo de pago especificado |
| Payment method not enabled | El metodo de pago no ha sido habilitado para tu clave API (proyecto) |
| Payment method not supported | Tu clave API (proyecto) no tiene el estado correcto para usar el metodo de pago especificado |
Si recibes "Payment method not enabled" o "No permissions", verifica la configuracion del metodo de pago en el portal de comerciante en la configuracion de tu sitio web.