API · processRecurrentPayment

API v1

POST /api/v1/processRecurrentPayment

What it does#

Processes a charge with an already tokenized card, without a form.

Authentication#

Requires the API bearer token in the Authorization header — see authentication.

Parameters#

keystringrequerido#

Key associated with the customer. It is obtained in Admin · Tilopay Checkout.

amountstringrequerido#

Purchase amount.

currencystringrequerido#

Purchase currency in ISO format, for example USD, CRC, GTQ.

orderNumberstringrequerido#

Order number, it can be alphanumeric.

capturestringrequerido#

Capture and authorize: 1 yes, 0 no.

emailstringrequerido#

Cardholder email.

cardstringrequerido#

Card token. It must be the v2 token.

Request example#

The <...> values are placeholders: replace them with your own credentials and data.

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

Response#

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

To interpret a response that is not a success, see how to read an error response.

Last verified: 2026-08-29 · Owner: equipo-integraciones

View as raw Markdown