# API · processRecurrentPayment

> Cobro servidor a servidor con token de tarjeta v2 mediante processRecurrentPayment.

- kind: api-operation
- status: stable
- api_version: v1
- last_verified: 2026-08-29
- url: https://www.tilopay.com/developers/api/recurrentes/realizar-pago/process-recurrent-payment

```http
POST /api/v1/processRecurrentPayment
```

## Qué hace [#que-hace]

Procesa un cobro con una tarjeta ya tokenizada, sin formulario.

## Autenticación [#autenticacion]

Requiere el token bearer del API en el header `Authorization` — ver [autenticación](/developers/api/autenticacion).

## Parámetros [#parametros]

<Param id="process-recurrent-payment-parametro-key" name="key" type="string" required>
Llave relacionada con el cliente. Se obtiene en Admin · Tilopay Checkout.
</Param>

<Param id="process-recurrent-payment-parametro-amount" name="amount" type="string" required>
Monto de la compra.
</Param>

<Param id="process-recurrent-payment-parametro-currency" name="currency" type="string" required>
Moneda de la compra en formato ISO, por ejemplo USD, CRC, GTQ.
</Param>

<Param id="process-recurrent-payment-parametro-ordernumber" name="orderNumber" type="string" required>
Número de orden, puede ser alfanumérico.
</Param>

<Param id="process-recurrent-payment-parametro-capture" name="capture" type="string" required>
Captura y autoriza: 1 sí, 0 no.
</Param>

<Param id="process-recurrent-payment-parametro-email" name="email" type="string" required>
Correo del tarjetahabiente.
</Param>

<Param id="process-recurrent-payment-parametro-card" name="card" type="string" required>
Token de tarjeta, debe ser el token v2

- **hashVersion**: Utilizar solo en caso de implementar la verificación de hash, posibles valores [V1, V2], pod defecto se usa V1.
</Param>

## Ejemplo de request [#request]

Los valores `<...>` son marcadores: reemplazalos por tus credenciales y datos.

```json
{
  "key": "<api_key>",
  "amount": "10.00",
  "currency": "USD",
  "orderNumber": "1213",
  "capture": "1",
  "email": "myemail@exapmle.com",
  "card": "511111_00GOB1111"
}
```

## Respuesta [#respuesta]

```json
{
  "type": "200",
  "response": "1",
  "description": "Transacción aprobada",
  "auth": "123456",
  "tpt": 734329,
  "order_id": "12135",
  "tilopayTransaction": 734329,
  "orderHash": "f3ad85046d249bc7a781eed5285a5ded92045a2e11108063504deec72ec9b338"
}
```

Para interpretar una respuesta que no es de éxito, ver [cómo leer una respuesta de error](/developers/api/procesos-operativos/errors).