API · processRecurrentPayment

API v1

POST /api/v1/processRecurrentPayment

Qué hace#

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

Autenticación#

Requiere el token bearer del API en el header Authorization — ver autenticación.

Parámetros#

keystringrequerido#

Llave relacionada con el cliente. Se obtiene en Admin · Tilopay Checkout.

amountstringrequerido#

Monto de la compra.

currencystringrequerido#

Moneda de la compra en formato ISO, por ejemplo USD, CRC, GTQ.

orderNumberstringrequerido#

Número de orden, puede ser alfanumérico.

capturestringrequerido#

Captura y autoriza: 1 sí, 0 no.

emailstringrequerido#

Correo del tarjetahabiente.

cardstringrequerido#

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.

Ejemplo de request#

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

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

Respuesta#

{
  "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.

Última verificación: 2026-08-29 · Responsable: equipo-integraciones

Ver como Markdown crudo