# TX Pay — API de pagos

> Integra pagos en tu sitio con Hosted Checkout: tu servidor crea una checkout session, rediriges al comprador a la URL de pago que te entregamos, paga en nuestra página/proveedor y vuelve a tu sitio. Nunca manejas datos de tarjeta, así que quedas fuera del alcance PCI.

TX Pay (TX Company SpA) es un PSP chileno. La API v1 expone un Hosted Checkout: el servidor del comercio crea una checkout session, redirige al comprador a la URL de pago y confirma el resultado por GET y/o webhook firmado (HMAC-SHA256). Autenticación: header `Authorization: Bearer <secret key>` en cada request. Montos en CLP (enteros).

## Documentación

- [Guía completa para agentes (Markdown plano)](https://app.txncompany.com/llms-full.txt): toda la guía de integración con URLs y claves de producción resueltas, más los equivalentes de sandbox en el encabezado.
- [Especificación OpenAPI (JSON)](https://api.txncompany.com/api/v1/openapi.json): esquemas exactos de request/response de la API v1.
- [Referencia interactiva OpenAPI](https://api.txncompany.com/api/v1/docs): la misma especificación en formato navegable.
- [Guía para humanos (Developer Portal)](https://app.txncompany.com/partners/developer-docs): versión con selector Sandbox/Producción y pestañas por lenguaje (requiere sesión en el dashboard).

## Entornos

- Sandbox (pruebas, sin dinero real): https://api-dev.txncompany.com — claves `sk_test_…`, `livemode: false`.
- Producción: https://api.txncompany.com — claves `sk_live_…`, `livemode: true`.
- Todas las rutas cuelgan de `/api/v1`. El entorno lo define la URL base, no la clave.

## Secciones de la guía

- Integra con IA (docs listas para agentes)
- Introducción y conceptos
- Autenticación
- Quickstart
- Referencia
- Webhooks
- Errores
- Idempotencia
- Datos de prueba (Sandbox)
- Checklist para producción

## Soporte

- Las claves (secret key, webhook secret y webhook URL) se administran desde el dashboard TX Pay (https://app.txncompany.com) → detalle del comercio → Desarrolladores.
- Soporte de integración: a través de tu Partner (Socio) TX Pay o del canal de contacto del dashboard. Cita siempre el `X-Request-Id` de la respuesta afectada.