# API del comercio

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)

{% hint style="info" %}
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. 
{% endhint %}

### 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)

{% hint style="info" %}
Todos los datos están simulados. No se realiza ninguna autorización real y las respuestas se basan en reglas predefinidas del sandbox.
{% endhint %}

### 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:

1. Inicia sesión en el Merchant Portal con tu cuenta de sandbox.
2. En el menú de la izquierda, ve a: Settings → Shop Settings → Technical Information
3. Si aún no has generado credenciales, verás el mensaje: *“API Client ID y API Secret aún no se han generado.”*
4. Haz clic en el botón “Generate Credentials”. El sandbox creará:
   * API Client ID
   * API Secret
5. Puedes copiar las credenciales directamente desde la interfaz y guardarlas de forma segura para las pruebas.
6. Si es necesario, el API Secret puede regenerarse en cualquier momento desde la misma vista.

{% hint style="info" %}
Estas credenciales solo son válidas para el entorno sandbox y no pueden usarse en producción.
{% endhint %}

**URLs de la API 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.

{% hint style="info" %}
Para especificaciones detalladas de la API y ejemplos, consulta la documentación oficial

<a href="/pages/75a099a336f93c793dde8bee463ebf2df7c33d7c" class="button primary">Unified Merchant API</a>
{% endhint %}

### Guía de uso de la API

Sigue estos pasos para empezar a probar las APIs de EGW usando [Postman](https://www.postman.com/):

1. Importar archivos de Postman
   * Descarga e importa el entorno de Postman y la colección de API proporcionados por Tietoevry.
2. Configurar entorno
   * Abre el entorno importado.
   * Actualízalo con tu Client ID y Client Secret de sandbox (de *Shop Settings → Technical Information*).
3. 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
4. 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:**

{% file src="/files/00fcecf155a05922a0dec4445140d8df21f5ab83" %}

{% file src="/files/3c6e374a521d4e2e04c8cc71bce3fe927fad500a" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.ecomm.api.tietoevry.com/tietoevry-egw-documentation-es/pasarela-de-pago-para-comercio-electronico/guia-de-sandbox/api-del-comercio.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.