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

{% hint style="info" %}
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. 
{% 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 vencimiento:** 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 son 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, siga estos pasos para generar sus credenciales de prueba:

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

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

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

### Guía de uso de la API

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

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

**Descargas:**

{% file src="/files/2edfb96644c4c67e725700efd55d3f983a7ffbda" %}

{% file src="/files/2cad258ecc7d316342118432d8e920a2a18a599d" %}


---

# 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/documentation-es/pasarela-de-pagos-para-comercio-electronico/guia-del-sandbox/api-para-comerciantes.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.