API para comerciantes

La Tieto E-commercePayment Gateway Sandbox también le permite probar la plataforma usando APIs de Merchant, simulando flujos de pago de extremo a extremo, comprobaciones de estado y lógica de reembolso sin usar la interfaz de usuario. Esto es ideal para desarrolladores que quieren integrar EGW directamente en sus sistemas o plataformas de comercio electrónico.

En modo sandbox, puede probar las operaciones principales de pago con tarjeta usando la Unified Merchant API. Las siguientes funciones están disponibles:

Iniciar pagos
- Crear solicitudes CIT (Transacción Iniciada por el Cliente) y MIT (Transacción Iniciada por el Comerciante)
- Compatible solo con flujos basados en tarjeta y basados en token
Comprobar el estado del pago - Recuperar el estado actual de un pago usando el endpoint GET /payments/{id}.
Cancelar o capturar pagos - Realizar 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 (por ejemplo, iniciar, comprobar estado)
Flujos basados en token (por ejemplo, creación y cancelación de token)

Los pagos de cuenta a cuenta (A2A) y Click-to-Pay no están disponibles a través de la API en sandbox. Estos flujos solo se pueden probar a través de la página de pago alojada por 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 vencimiento: Cualquier fecha futura válida (p. ej., 12/28)
CVV: Cualquier número de 3 dígitos (p. ej., 123)

Todos los datos son 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, siga estos pasos para generar sus credenciales de prueba:

Inicie sesión en el Merchant Portal usando su cuenta sandbox.
En el menú de la izquierda, vaya a: Settings → Shop Settings → Technical Information
Si aún no ha generado credenciales, verá el mensaje: “API Client ID y API Secret aún no se han generado.”
Haga clic en el botón “Generate Credentials”. El sandbox creará:
- API Client ID
- API Secret
Puede 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 de Sandbox

URL del endpoint de autenticación - https://ecomm.api.tietoevry.com/auth/realms/participants-tietoevry/protocol/openid-connect/token
URL 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 obtener especificaciones y ejemplos detallados de la API, consulte la documentación oficial

Merchant Unified API

Guía de uso de la API

Siga estos pasos para comenzar a probar las APIs de EGW usando Postman:

Importar archivos de Postman
- Descargue e importe el entorno de Postman y la colección de API proporcionados por Tietoevry.
Configurar entorno
- Abra el entorno importado.
- Actualícelo con su Client ID y Client Secret de sandbox (de Shop Settings → Technical Information).
Obtener token de acceso
- Vaya a la carpeta de la colección: Unified Merchant API → solicitud "Get access token"
- Ejecute la solicitud "Get access token"
- Nota: la solicitud debe ejecutarse de nuevo cuando el token caduque
Enviar solicitudes de API
Ahora puede probar los siguientes endpoints de la colección:
- iniciación CIT/MIT con tarjetas y tokens
- Obtener estado del pago
- Cancelar o capturar pagos
- Obtener estado del token / Desactivar token