Docs listas para IA

Integra en horas, no en semanas

Una API de checkout, tres llamadas y un webhook. Nunca tocas datos de tarjeta, así que tu servidor queda fuera del alcance PCI. Certificados PCI DSS v4.0.1 (SAQ D Service Provider, agosto 2026).

Pide tus claves sandbox Ver la API (OpenAPI)

Qué puedes integrar hoy

Hosted Checkout por API

Creas una sesión de pago desde tu servidor, rediriges al comprador a nuestra página y confirmas el resultado por API o webhook.

Webpay Plus y Vita Wallet

Tarjetas de crédito, débito y prepago vía Transbank, y transferencias o pagos multimoneda LATAM vía Vita Wallet, con una sola integración.

Links de pago y QR sin código

Cobra sin programar: links reutilizables o de un solo uso y códigos QR con confirmación en tiempo real desde el dashboard.

Webhooks firmados con reintentos

Eventos firmados con HMAC-SHA256, reintentos con backoff durante 8 horas y un panel para revisar y reenviar cada entrega.

Así se ve

Una llamada crea la sesión y te devuelve la URL a la que envías al comprador.

Request 
curl -X POST https://api-dev.txncompany.com/api/v1/checkout-sessions \
  -H "Authorization: Bearer sk_test_TU_SECRET" \
  -H "Idempotency-Key: orden-4821" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 19990,
    "currency": "CLP",
    "external_reference": "orden-4821",
    "success_url": "https://tutienda.cl/orden/4821/ok",
    "cancel_url": "https://tutienda.cl/orden/4821/cancelado"
  }'
Response 201 
{
  "id": "cs_65f1a2b3c4d5e6f7a8b9c0d1",
  "status": "pending",
  "amount": 19990,
  "currency": "CLP",
  "checkout_url": "https://api-dev.txncompany.com/checkout/65f1a2b3c4d5e6f7a8b9c0d1",
  "expires_at": "2026-09-29T15:45:00.000Z",
  "livemode": false
}

Integra con IA en 3 pasos

La misma documentación que lees existe en formato para máquinas. Tu asistente de programación puede hacer la integración completa a partir de ella.

01

Copia el prompt

Pégalo en Claude Code, Cursor, Copilot o el asistente que uses.

02

El asistente lee las docs

Consume llms-full.txt y la especificación OpenAPI, y arma la integración en tu stack.

03

Prueba en sandbox

Con tu clave sk_test_ y las tarjetas de prueba de Transbank. Al terminar, solo cambias la URL base y la clave.

Prompt 
Integra la API de pagos de TX Pay (Hosted Checkout) en este proyecto.

1. Lee primero la documentación completa en https://app.txncompany.com/llms-full.txt
   y la especificación OpenAPI en https://api.txncompany.com/api/v1/openapi.json.
2. Usa el entorno SANDBOX: base URL https://api-dev.txncompany.com y una secret key
   de prueba con prefijo sk_test_ (léela desde la variable de entorno TXPAY_SECRET_KEY;
   nunca la escribas en el código ni la expongas en el frontend).
3. Implementa en el servidor:
   a) POST /api/v1/checkout-sessions con amount (CLP, entero), currency "CLP",
      external_reference (mi ID de orden), success_url y cancel_url, enviando un
      header Idempotency-Key único por orden.
   b) Redirección del comprador a la checkout_url que devuelve la API.
   c) Un endpoint de retorno que lea ?session_id= y confirme el estado real con
      GET /api/v1/checkout-sessions/:id (no confiar solo en la redirección).
   d) Un endpoint público HTTPS que reciba los webhooks: verifica el header
      X-TXPay-Signature (t=<timestamp>,v1=<hmac>) calculando HMAC-SHA256 de
      "<t>.<rawBody>" con el webhook secret (variable TXPAY_WEBHOOK_SECRET),
      compara en tiempo constante, rechaza timestamps fuera de ±300 s y responde
      2xx en menos de 10 segundos.
4. Al terminar, verifica este checklist y dime qué hiciste en cada punto:
   - Idempotency-Key único por orden y manejo de 409 idempotency_key_reused.
   - Firma del webhook verificada sobre el body crudo (sin re-serializar).
   - Deduplicación de eventos por su id (los reenvíos reusan el mismo id).
   - Un checkout_session.completed puede llegar DESPUÉS de un
     checkout_session.failed para la misma sesión: el estado final lo define
     el último evento confirmado con el GET.
   - Manejo de failed (rejected/voided/refunded) y expired además de approved.
   - Para pasar a producción solo cambian la base URL (https://api.txncompany.com)
     y la clave (sk_live_...): déjalos configurables por entorno.

Qué necesitas para salir a producción

Tiempo típico de desarrollo: 2 a 4 horas con la guía. Menos con IA.

  1. 1

    Cuenta y comercio

    Te damos de alta con tu Partner TX Pay o directamente con nosotros. Configuramos tus métodos de pago y comisiones.

  2. 2

    Claves sandbox

    Desde el portal obtienes tu clave sk_test_, tu webhook secret y configuras la URL de tu webhook.

  3. 3

    Crear sesión, retorno y webhook

    Creas la sesión con Idempotency-Key, recibes al comprador en success_url o cancel_url y verificas la firma del webhook.

  4. 4

    Pruebas con tarjetas de integración

    Pagos aprobados, rechazados y abortados con las tarjetas de prueba de Transbank y el flujo de prueba de Vita.

  5. 5

    Checklist de producción

    Webhook en https, manejo de completed después de failed, deduplicación por id de evento y registro del X-Request-Id.

  6. 6

    Activación

    Activamos tu comercio y te entregamos las claves sk_live_. Solo cambian la URL base y la clave: el código es el mismo.

Recursos

Especificación OpenAPI

Contrato completo de la API v1 en JSON: esquemas, headers, errores.

Referencia interactiva

La misma especificación, navegable, para probar desde el navegador.

llms.txt

Índice corto para asistentes de IA, con los enlaces esenciales.

llms-full.txt

La guía completa en Markdown plano, lista para que un agente la consuma.

Guía completa en el portal

Quickstart, referencia, webhooks, errores, idempotencia y datos de prueba. Requiere cuenta.

Seguridad y cumplimiento

Certificación PCI DSS v4.0.1 SAQ D Service Provider (agosto 2026), sin datos de tarjeta en la plataforma.

Pide tus claves sandbox

Cuéntanos qué quieres integrar y te damos acceso al entorno de pruebas y a la guía completa.

Respondemos dentro de 24 horas