API · Realizar cobro CoF

API v1

Una herramienta del MCP envuelve esta operación: Tarjetas guardadas y cobros masivos.

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 Panel administrativo · Integración con plataformas.

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.

hashVersionstring#

Solo si implementás la verificación de hash. Valores V1 o V2; por defecto 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"
}

Respuestas de error#

HTTP 300:

{
  "type": "300",
  "result": "Message error"
}

HTTP 400:

{
  "type": "400",
  "result": "Message error"
}

Para interpretar una respuesta que no es de éxito, ver cómo leer una respuesta de error.

Última verificación: 2026-10-20

Ver como Markdown crudo