API del comerciante
El Sandbox de Tieto E-commerce Payment Gateway también te permite probar la plataforma utilizando APIs de Merchant, simulando flujos de pago end-to-end, consultas de estado y lógica de reembolso sin usar la interfaz de usuario. Esto es ideal para desarrolladores que desean integrar EGW directamente en sus sistemas o plataformas de comercio electrónico.
En modo sandbox, puedes probar las operaciones principales de pago con tarjeta utilizando la Unified Merchant API. Las siguientes funciones están disponibles:
Iniciar pagos
Crear solicitudes CIT (Customer Initiated Transaction) y MIT (Merchant Initiated Transaction)
Compatible solo con flujos basados en tarjeta y en token
Consultar estado del pago - Recupera el estado actual de un pago usando el endpoint GET /payments/{id}.
Cancelar o capturar pagos - Realiza acciones de seguimiento como:
Cancelar un pago preautorizado
Capturar un pago previamente autorizado
Gestionar tokens
Obtener el estado del token
Desactivar o cancelar un token de tarjeta almacenado
Limitación
En modo sandbox, el acceso a la API se limita a las siguientes operaciones:
Operaciones de pago con tarjeta (p. ej., iniciar, consultar estado)
Flujos basados en token (p. ej., creación y cancelación de token)
Los pagos Account-to-Account (A2A) y Click-to-Pay no están disponibles vía API en sandbox. Estos flujos solo pueden probarse a través de la página de checkout alojada por el Gateway.
Datos de prueba
Nombre del titular de la tarjeta: Cualquier valor
Número de tarjeta:
5186 0000 0000 0005 – Autorización exitosa
5186 0000 0000 0013 – Autorización fallida
Fecha de caducidad: Cualquier fecha futura válida (p. ej., 12/28)
CVV: Cualquier número de 3 dígitos (p. ej., 123)
Todos los datos están simulados. No se realiza ninguna autorización real y las respuestas se basan en reglas predefinidas del sandbox.
Primeros pasos con el acceso a la API
Para comenzar a usar la API en modo sandbox, sigue estos pasos para generar tus credenciales de prueba:
Inicia sesión en el Merchant Portal con tu cuenta de sandbox.
En el menú de la izquierda, ve a: Settings → Shop Settings → Technical Information
Si aún no has generado credenciales, verás el mensaje: “API Client ID y API Secret aún no se han generado.”
Haz clic en el botón “Generate Credentials”. El sandbox creará:
API Client ID
API Secret
Puedes copiar las credenciales directamente desde la interfaz y guardarlas de forma segura para las pruebas.
Si es necesario, el API Secret puede regenerarse en cualquier momento desde la misma vista.
Estas credenciales solo son válidas para el entorno sandbox y no pueden usarse en producción.
URLs de la API Sandbox
URL del endpoint de autenticación -
https://ecomm.api.tietoevry.com/auth/realms/participants-tietoevry/protocol/openid-connect/tokenURL base de la API -
https://sandbox-api.ecomm.api.tietoevry.com
Estas URLs ya están configuradas en el entorno y la colección de Postman proporcionados.
Para especificaciones detalladas de la API y ejemplos, consulta la documentación oficial
Guía de uso de la API
Sigue estos pasos para empezar a probar las APIs de EGW usando Postman:
Importar archivos de Postman
Descarga e importa el entorno de Postman y la colección de API proporcionados por Tietoevry.
Configurar entorno
Abre el entorno importado.
Actualízalo con tu Client ID y Client Secret de sandbox (de Shop Settings → Technical Information).
Obtener token de acceso
Ve a la carpeta de la colección: Unified Merchant API → solicitud "Get access token"
Ejecuta la solicitud "Get access token"
Nota: la solicitud debe volver a ejecutarse cuando el token caduque
Enviar solicitudes a la API
Ahora puedes probar los siguientes endpoints de la colección:
Inicio de CIT/MIT con tarjetas y tokens
Obtener estado del pago
Cancelar o capturar pagos
Obtener estado del token / Desactivar token
Descargas:
Última actualización
¿Te fue útil?