> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.recurrente.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.recurrente.com/_mcp/server.

# Introducción

> Comienza con la API de Recurrente

La API de Recurrente te permite crear sesiones de compra, manejar tus productos, suscripciones, y clientes, hacer transferencias de dinero entre diferentes cuentas de Recurrente, y mucho más.

## Tu primer pago de prueba

Sigue [Primer pago de prueba](/guias-espanol/comenzar/primer-pago-de-prueba) para abrir un Sandbox, obtener una llave TEST y verificar tu primer pago y webhook. Puedes empezar antes de activar cobros reales.

## Cómo empezar

* [Crea una cuenta](http://app.recurrente.com/bienvenida) en Recurrente.
* La API responde en formato JSON. Cuando retorna un error, el error es enviado en un *error key* en JSON.

## URL Base

```
https://app.recurrente.com/api
```

## Inicio Rápido

1. En **Configuración → Llaves API → Abrir Sandbox**, elige **Crear mi llave TEST**. Confirma `environment: sandbox` antes de crear pagos.
2. **Prueba tus credenciales** con una solicitud GET simple:

```bash
curl https://app.recurrente.com/api/test \
  -H "X-SECRET-KEY: tu_llave_secreta"
```

3. **Crea tu primer checkout:**

```bash
curl -X POST https://app.recurrente.com/api/checkouts \
  -H "X-SECRET-KEY: tu_llave_secreta" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [{
      "name": "Camiseta",
      "amount_in_cents": 15000,
      "currency": "GTQ",
      "quantity": 1
    }],
    "success_url": "https://tusitio.com/exito",
    "cancel_url": "https://tusitio.com/cancelar"
  }'
```

Esto retorna una `checkout_url` — redirige a tu cliente ahí para completar el pago.

Para montos inline, `amount_in_cents` debe respetar el mínimo de la moneda: 500 para GTQ (Q5) o 100 para USD (\$1).

## ¿Qué puedes hacer con la API?

| Funcionalidad      | Descripción                            |
| ------------------ | -------------------------------------- |
| **Checkouts**      | Crear páginas de pago alojadas         |
| **Productos**      | Manejar tu catálogo y precios          |
| **Suscripciones**  | Manejar facturación recurrente         |
| **Clientes**       | Rastrear y administrar tus compradores |
| **Reembolsos**     | Procesar reembolsos de pagos           |
| **Transferencias** | Enviar dinero entre cuentas            |
| **Webhooks**       | Recibir notificaciones sobre eventos   |

## Sandbox y pagos de prueba

Cada Sandbox es un ambiente aislado con miembros, llaves TEST, webhooks, objetos,
actividad y balances simulados propios. Puedes probar el ciclo completo de una
suscripción —cobro inicial, renovación, rechazo, recuperación, refund y cancelación—
sin dinero real ni datos LIVE.

Usa `4242 4242 4242 4242` para éxito o `4000 0000 0000 0002` para rechazo. Los
eventos normales se entregan solamente a los endpoints del Sandbox con
`live_mode: false` y `sandbox_id`.

Consulta el contrato de cada endpoint: transferencias, splits, swaps, retiros y comandos de hardware están bloqueados. Las simulaciones de tarjeta admiten éxito y rechazo; no reproducen 3DS ni liquidación bancaria. Para probar únicamente un consumer de
webhooks, `/test_helpers/webhook_events` puede emitir cualquier evento publicado;
para probar comportamiento, usa el flujo real y sus eventos naturales.

Consulta la [guía de Sandboxes](/guias-espanol/guias/sandboxes-y-test-clocks) para crear un ambiente,
usar Test Clocks y ejecutar el escenario end-to-end.

## **¿Necesitas ayuda?**

* Si estás usando Wordpress, te recomendamos que utilices [nuestro plugin](https://ayuda.recurrente.com/es/articles/8971522-como-instalo-el-plugin-de-recurrente-en-woocommerce).
* Únete y pregunta en nuestro [Discord](https://discord.gg/QhKPEkSKp2).
* O envíanos un correo a [soporte@recurrente.com](https://mailto:soporte@recurrente.com)