> For the complete documentation index, see [llms.txt](https://doc.ecomm.api.tietoevry.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.ecomm.api.tietoevry.com/tietoevry-egw-documentation-es/integraciones/api-unificada-para-comercios.md).

# API unificada para comercios

## Introducción

La API del Comerciante en el ecosistema EGW permite a los comerciantes interactuar programáticamente con la pasarela de pago, habilitando una integración fluida de las funciones de pago en sus propias aplicaciones, sitios web y sistemas de back office. Sigue las mejores prácticas de los estándares globales de API para garantizar la seguridad, la escalabilidad y la facilidad de integración.

## Cumplimiento y estándares

La API del Comerciante de EGW está diseñada para cumplir con estándares reconocidos a nivel mundial, garantizando compatibilidad y cumplimiento normativo:

* **Cumplimiento de FAPI 2.0**: Cumple con los requisitos de seguridad para API financieras.
* **Estándar ISO8583**: Admite el formato de mensajes de pagos con tarjeta.
* **Estándar ISO20022**: Permite la mensajería financiera estructurada para pagos basados en cuenta.
* **Cumplimiento del marco del Berlin Group**: Admite los estándares europeos de banca abierta.
* **Soporte multidivisa**: Gestiona pagos en múltiples divisas, habilitando transacciones globales.
* **Soporte de datos de aerolíneas**: Capacidades de integración para el procesamiento de datos específicos de aerolíneas.

## Funcionalidades de la API

* **Arquitectura RESTful**: Sigue el estilo arquitectónico REST para una interacción clara y eficiente.
* **Soporte para CIT y MIT**: Gestiona tanto **Transacciones iniciadas por el cliente (CIT)** y **Transacciones iniciadas por el comercio (MIT)**.
* **Tokenización segura**: Reduce el alcance de PCI al reemplazar los datos sensibles por tokens.
* **Captura, anulación y reembolsos**: Simplifica los flujos de trabajo financieros con operaciones optimizadas. Para el ciclo de vida del pago con tarjeta y la diferencia entre preautorización, captura, anulación y reembolso, consulte [Pagos con tarjeta](https://doc.ecomm.api.tietoevry.com/tietoevry-egw-documentation-es/metodo-de-pago/pagos-con-tarjeta.md) y [Reversión del pago y reembolsos](https://doc.ecomm.api.tietoevry.com/tietoevry-egw-documentation-es/funciones/reversion-de-pagos-y-reembolsos.md).
* **Notificaciones de devolución de llamada y push**: Notifica al instante a los comerciantes sobre el estado de las transacciones y los eventos del sistema.
* **Gestión de transacciones recurrentes**: Automatiza los pagos basados en suscripciones y los ciclos de facturación recurrente.
* **Transferencias automatizadas de fondos y liquidaciones**: Admite el procesamiento fluido de pagos hacia las cuentas del comerciante.

[Ir a las referencias de la API](https://doc.ecomm.api.tietoevry.com/tietoevry-egw-documentation-es/referencias-de-api/api-unificada-para-comercios.md)&#x20;

## Buenas prácticas de seguridad

* **Autenticación OAuth 2.0**: Control de acceso seguro basado en tokens.
* **mTLS mutuo**: Verificación basada en certificados para conexiones seguras.
* **Firma de mensajes**: Garantiza la integridad de los datos durante la transmisión.
* **Registro de auditoría**: Registros detallados de llamadas y respuestas de la API para el seguimiento del cumplimiento.

## Monitoreo y gestión de errores

* **Monitoreo en tiempo real**: Supervise el estado de la API y las métricas de rendimiento.
* **Respuestas de error estandarizadas**: Siguen los códigos de estado HTTP con detalles de error JSON estructurados.
* **Analítica de uso de la API**: Supervise los volúmenes de llamadas, las tasas de error y la latencia de respuesta.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.ecomm.api.tietoevry.com/tietoevry-egw-documentation-es/integraciones/api-unificada-para-comercios.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
