Notas de versión

Descubre los últimos lanzamientos de funcionalidades, las mejoras de producto y las correcciones de errores de la documentación.

Historial completo

Las entradas anteriores a septiembre de 2025 se mantienen en inglés. Puedes consultar el historial completo en la versión en inglés de esta página.

Usamos el estándar ISO 8601 (YYYY-MM-DD) para las fechas.

Types of changes

NEW para funcionalidades nuevas.

IMPROVEMENTS para cambios en funcionalidad existente.

DEPRECATED para funcionalidades que se eliminarán pronto.

REMOVED para funcionalidades ya eliminadas.

FIX para correcciones de errores.

SECURITY en caso de vulnerabilidades.

Latest

1.4.5 - 2025-08-05

Print ticket on terminal

Ya puedes enviar tickets personalizados para imprimir directamente en una terminal Summit con Cloud Terminal Services.

Para usar esta funcionalidad, envía una solicitud JSON que incluya:

El número de serie de la terminal (serialNumber)

La estructura del ticket (ticketData)

Opcionalmente, una notificación previa a la impresión (showNotification)

→ Así puedes enviar mensajes y diseños de formato a medida para mostrarlos o imprimirlos en el dispositivo.

Previous release notes

1.4.4 - 2025-04-24

New webhook for SPEI Transfers

Publicamos una nueva versión del webhook de transferencia de fondos. Este webhook entrega información detallada del depósito SPEI.

1.4.3 - 2025-03-18

New version of transaction list endpoint

Agregamos una cuarta versión del servicio de listado de transacciones, donde añadimos el filtro de zona horaria.

Se agregó el parámetro timezone para filtrar los resultados de transacciones dentro de una zona horaria específica.

El parámetro de respuesta date se estandarizó al formato RCF 9557.

1.4.1 - 2025-26-02

IMPROVEMENTS para cambios en funcionalidades existentes.

Added the msi parameter to process deferred transactions in the Collect card payments v2 service in Cloud Terminal.

1.4.0 - 2025-28-01

NEW

Cancel push notifications and get status in Cloud Terminal

We have added the parameters ttl, deviceToken in the Collect card payments v2 service and also the response code 010.

Now you can cancel pending push notifications with the new Cancel Push Notification service.

Now you can ebtain the status of a payment request by sending the uniqueReference number in the Get transaction status service.

NEW

New Autopayment field in Cloud Terminal

We've added the object extras Collect card payments v2 service which allows to trigger the payment automatically without waiting for confirmation via the Pay button. Also, the timerFinishTRX allows to specify the number of seconds before the checkout summary screen closes after the purchase is completed and finally, the enableDialogTip parameter allows to decide whether a dialog should appear to the enter the tip amount during the payment process.

1.3.0 - 2024-11-28

NEW

New custom checkout integration type added.

1.2.0 - 2024-11-08

NEW

New version of transaction list endpoint

We added a third version of the transaction list service where some response fields have been renamed.

rejectionCode has been renamed to rejectionCode.

subtotal has been renamed to finalAmount.

surcharge has been renamed to msiFee.

transactionRefundedId has been renamed to refundedTransactionId.

1.1.0 - 2024-08-22

NEW

New version of collect card payments endpoint

We added a new version of the Collect card payments endpoint of the Cloud Terminal API with new properties in the request and response.

Send an alphanumeric unique reference of up to 64 characters in the uniqueReference property when making a request through the Cloud terminal API for traceability in your requests.

{
  "amount": 37,
  "identifier": "c68522bd-bfc1-4b08-bf99-30300806c25a",
  "serialNumber": "TERM123",
  "uniqueReference": "d6732f94-6cf2-4dfb-aed7-11b64b739407"
}

Set whether the POS application will open automatically or whether requests will be queued via notifications with the showNotification property on a request.

{
  "amount": 37,
  "identifier": "c68522bd-bfc1-4b08-bf99-30300806c25a",
  "serialNumber": "TERM123",
  "uniqueReference": "d6732f94-6cf2-4dfb-aed7-11b64b739407",
  "showNotification": true
}

Updated the error response structure.

V1:

{
  "error": "Bad Request",
  "message": [
    "serial_number must not contain special characters"
  ],
  "statusCode": 400
}

V2:

{
  "message": [
    "serialNumber must not contain special characters"
  ],
  "responseCode": "002"
}

Property names in request and response have been updated to camel case instead of snake case in version 2.

V1:

{
  "amount": 37,
  "identifier": "c68522bd-bfc1-4b08-bf99-30300806c25a",
  "serial_number": "TERM123"
}

V2:

{
  "amount": 37,
  "identifier": "c68522bd-bfc1-4b08-bf99-30300806c25a",
  "serialNumber": "TERM123"
}

Now you will be able to know the status of the notifications sent to the terminal. In case there is an error and you cannot identify whether the operation was carried out successfully or not, you can obtain the status of the operation by sending the same reference as above. If the operation exists, you will get one of the following responses, according to the status of the operation.

Created

Get a responseCode 004 if the operation has already been created.

{
  "status": "CREATED",
  "message": "Petición de cobro duplicada uniqueReference:  9b6c37db-231e-464c-a2c1-466e2de9fec1",
  "responseCode": "004"
}

Cancelled

Get a responseCode 005 if the operation has been cancelled.

{
  "status": "CANCELLED",
  "message": "Petición de cobro duplicada uniqueReference:  9b6c37db-231e-464c-a2c1-466e2de9fec1",
  "responseCode": "005"
}

Approved

Get a responseCode 006 if the operation has been approved.

{
  "status": "APPROVED",
  "message": "Petición de cobro duplicada uniqueReference:  9b6c37db-231e-464c-a2c1-466e2de9fec1",
  "responseCode": "006"
}

Refunded

Get a responseCode 007 if the operation has been refunded.

{
  "status": "REFUNDED",
  "message": "Petición de cobro duplicada uniqueReference:  9b6c37db-231e-464c-a2c1-466e2de9fec1",
  "responseCode": "007"
}

New version of transaction list endpoint

We added a second version of the transaction list endpoint with new filters and returned information.

You can now filter by uniqueReference sent at the time of a request via the Cloud Terminal API.

Property names in the response have been renamed with camel case instead of snake case in v2.

V1:

{
    "data": [
        {
            "transaction_id": 130008,
            "authorization_number": "",
            "bank": null,
            "card_brand": "Visa",
            "card_type": null,
            "capture_method": "msc",
            "commission": 0.49,
            "countercharged": false,
            "date": "2024-07-12T10:09:26.000Z",
            "details": null,
            "device": "Device 1",
            "error_detail": "Rechazo por reglas internas",
            "masked_card": "400000******0002",
            "msi": null,
            "retention": 0,
            "rejection_code": null,
            "subtotal": 13.48,
            "surcharge": 0,
            "tip": 0,
            "total_amount": 14.05,
            "transaction_type": "venta",
            "transaction_status": "rechazadaRiesgo",
            "vat": 0.08
        }
    ],
    "currentPage": 1,
    "perPage": 100,
    "total": 1
}

V2:

{
    "data": [
        {
            "transactionId": 130009,
            "authorizationNumber": "",
            "bank": null,
            "cardBrand": "Visa",
            "cardType": null,
            "captureMethod": "msc",
            "commission": 0.49,
            "chargeback": false,
            "date": "2024-07-12T10:09:26.000Z",
            "details": null,
            "device": "Device 1",
            "errorDetail": "Rechazo por reglas internas",
            "masked_card": "400000******0002",
            "msi": null,
            "retention": 0,
            "rejectionCode": null,
            "subtotal": 13.48,
            "surcharge": 0,
            "tip": 0,
            "totalAmount": 14.05,
            "transactionType": "venta",
            "transactionStatus": "rechazadaRiesgo",
            "vat": 0.08,
            "uniqueReference": ""
        }
    ],
    "currentPage": 1,
    "perPage": 100,
    "total": 1
}

Other changes

Added uniqueReference property in notifications via webhooks.

Added uniqueReference property in Cancel payments request.

New refund events in webhooks. Find out more in the Webhooks documentation.

IMPROVEMENTS

The structure of the error response in the Cancel payments endpoint has been updated.

1.0.0 - 2024-07-01

NEW

Discover different ways to receive payments and grow your business.

Types of changes#

Latest#

1.4.5 - 2025-08-05#

Print ticket on terminal#

Previous release notes#

1.4.4 - 2025-04-24#

New webhook for SPEI Transfers#

1.4.3 - 2025-03-18#

New version of transaction list endpoint#

1.4.1 - 2025-26-02#

1.4.0 - 2025-28-01#

Cancel push notifications and get status in Cloud Terminal#

New Autopayment field in Cloud Terminal#

1.3.0 - 2024-11-28#

1.2.0 - 2024-11-08#

New version of transaction list endpoint#

1.1.0 - 2024-08-22#

New version of collect card payments endpoint#

Created#

Cancelled#

Approved#

Refunded#

New version of transaction list endpoint#

Types of changes

Latest

1.4.5 - 2025-08-05

Print ticket on terminal

Previous release notes

1.4.4 - 2025-04-24

New webhook for SPEI Transfers

1.4.3 - 2025-03-18

New version of transaction list endpoint

1.4.1 - 2025-26-02

1.4.0 - 2025-28-01

Cancel push notifications and get status in Cloud Terminal

New Autopayment field in Cloud Terminal

1.3.0 - 2024-11-28

1.2.0 - 2024-11-08

New version of transaction list endpoint

1.1.0 - 2024-08-22

New version of collect card payments endpoint

Created

Cancelled

Approved

Refunded

New version of transaction list endpoint