Get Updated Reservation Transactions by Hotel (DLM-Based)
This endpoint returns a list of reservation-related operations (payments, refunds, and status updates) that have been created or modified since the last request, based on the internal Data Last Modified (DLM) mechanism.
Request
GET /v2/transactions/vouchers/hotel/{hotel_id}?id_type={id_type}
Example:
GET /v2/transactions/vouchers/hotel/17?id_type=internal
Path Parameters
| Name | Type | Required | Description |
hotel_id | int | Yes | Internal hotel ID. |
Query Parameters
| Name | Type | Required | Description |
id_type | string | Yes | Determines how the hotel ID should be interpreted. Possible values: internal, channel_manager. |
DLM Behavior (Data Last Modified)
The service keeps track of the timestamp of the last request made by this hotel.
This allows to sync data incrementally.
Response Schema
Root Object
| Field | Type | Description |
hotel | object | Basic metadata about the hotel. |
data | array | List of updated reservations / voucher records. |
metadata | object | Extra details such as total items. |
Hotel Object
| Field | Type | Description |
id | int | Internal hotel ID. |
channel_mannager_id | string | Channel manager hotel identifier. |
name | string | Hotel name. |
Data Entry
Each item returned in data represents a reservation voucher with the following fields:
| FIELD | TYPE | DESCRIPTION |
operation_type | String | Type of operation performed. Accepted values: automated, terminal_payment, payment_link. |
id | Integer | Internal operation ID in Autocore. |
reservation_id | String | Unique reservation identifier. |
portal_code | String | Null | Portal code if applicable. |
checkin_date | Date | Null | Reservation check-in date (YYYY-MM-DD) if applicable. |
guest | String | Guest full name. |
bank | String | Bank associated with the payment. |
payment_type | String | Payment type or concept. |
payment_status_code | String | Technical payment status code. |
payment_status | String | Human-readable payment status. |
transaction | Object | Null | Information about the processed transaction. May be null. |
refound | Object | Null | Information about the refund. May be null. |
generated_at | String | Report generation timestamp (DD-MM-YYYY hh ss AM/PM). |
Transaction Object (nullable)
| FIELD | TYPE | DESCRIPTION |
status_code | String | Transaction status code. |
status | String | Human-readable transaction status. |
status_detail | String | Detailed status description. |
carrier | String | Payment processor/network (e.g., RedeBan). |
transaction_id | String | Carrier-generated transaction identifier. |
authorization_code | String | Carrier-generated authorization identifier. |
description | String | Description of the processed payment. |
payment_method | String | Payment method used (credit_card, etc.). |
payment_card_info | Object | Credit card information used in the transaction. |
installments | String | Number of installments. |
payment_date | Datetime | Date and time of the payment. |
amount | Float | Processed amount. |
currency | String | Currency of the transaction. |
voucher_url | String | URL to the payment voucher. |
Payment Card Info
| FIELD | TYPE | DESCRIPTION |
card_holder | String | Card holder name. |
card_num | String | Masked card number. |
card_type | String | Card brand or type. |
Refund Object (nullable)
| Field | Type | Description |
status_code | string | Refund status code. |
status | string | Translated status. |
status_detail | string | Additional detail. |
authorization_code | String | Carrier-generated authorization identifier. |
transaction_id | string | Refund transaction reference. |
refund_date | datetime | When the refund was processed. |
amount | float | Refund amount. |
currency | string | Currency. |
voucher_url | string | Link to refund voucher. |
Status Codes
The following status codes may appear in root, transaction, or refound.
| CODE | ORIGINAL (ES) |
pending | Pendiente |
invalid_card | Tarjeta no válida |
rejected | Rechazado |
applied | Aplicado |
cancelled | Cancelado |
early_checkout | Salida anticipada |
overdue | Vencido |
in_process | En proceso |
partial_refound | Reembolso parcial |
total_refound | Reembolso total |
rejected_refound | Reembolso rechazado |
pending_refound | Reembolso pendiente |
in_process_refound | Reembolso en proceso |
in_validation | En validación |
cancelled_charge | Cobro cancelado |
no_card_data | Sin datos de pago |
invalid_card_data | Datos de pago inválidos |
error | Error |
Status Detail Values
The following values may appear inside transaction.status_detail or refound.status_detail.
| DETAIL (ES) |
Recaudo: Aprobado |
Recaudo: Aprobación pendiente |
Recaudo: Rechazado |
Recaudo: Cancelado |
Reembolso: Aprobado |
Reembolso: Aprobación pendiente |
Reembolso: Rechazado |
Supported Portals
The following values may appear in portal_code when the reservation originates from a connected OTA, wholesaler, or booking engine.
| PORTAL KEY | DESCRIPTION |
booking | Booking.com |
expedia | Expedia |
despegar | Despegar |
hyperguest | HyperGuest |
hotelbeds | Hotelbeds |
scalabed | Scalabed |
hopper | Hopper |
roomcloud | RoomCloud |
roibos | Roibos |
tbo | TBO Holidays |
roiback | Roiback |
siteminder_engine | SiteMinder Booking Engine |
channels_plus | Channels+ |
cloudbeds_engine | Cloudbeds Booking Engine |
profitroom | Profitroom |
open_travel_service | Open Travel Service |
webbeds | Webbeds |
simple_booking | Simple Booking |
airbnb | Airbnb |
hostelworld | Hostelworld |
mirai | Mirai |
gnahs | GNA Hotel Solutions (GNAHS) |
Example Response
The following response represents a valid sample:
{
"hotel": {
"id": 17,
"channel_mannager_id": "0001",
"name": "Test Hotel"
},
"data": [
{
"operation_type": "payment_link",
"id": 163,
"reservation_id": "bk_123456789",
"portal_code": "booking",
"checkin_date": "2025-06-21",
"guest": "Jhon Doe",
"bank": "Davivienda",
"payment_type": "anticipo estadía",
"payment_status_code": "in_process_refound",
"payment_status": "Reembolso en proceso",
"transaction": {
"status_code": "applied",
"status": "Aplicado",
"status_detail": "Recaudo: Aprobado",
"carrier": "redeban",
"authorization_code": "AK7-123456",
"transaction_id": "RB-774454",
"description": "Pago exitoso de link de pago hz824gjch4fd por: $125,000.00",
"payment_method": "credit_card",
"payment_card_info": {
"card_holder": "David Rojas",
"card_num": "**********1111",
"card_type": "Visa"
},
"installments": "1",
"payment_date": "2025-09-24 19:39:23.825846",
"amount": 125000.0,
"currency": "COP",
"voucher_url": "localhost:8081/v1/bookings/123/vouchers?type=payment_link"
},
"refound": {
"status_code": "in_process_refound",
"status": "Reembolso en proceso",
"status_detail": "Reembolso: Aprobación pendiente",
"authorization_code": "AK7-123456",
"transaction_id": "RB-774454",
"refund_date": "2025-09-24 19:39:38.849530",
"amount": 25000.0,
"currency": "COP",
"voucher_url": "localhost:8081/v1/bookings/123/vouchers?type=payment_link&transaction_id=3234"
},
"generated_at": "09-10-2025 02:59:32 PM"
},
{
"operation_type": "automated",
"id": 12652,
"reservation_id": "3462688899",
"portal_code": "despegar",
"checkin_date": "2025-11-26",
"guest": "Jane Doe",
"bank": "Davivienda",
"payment_type": "anticipo estadía",
"payment_status_code": "pending",
"payment_status": "Pendiente",
"transaction": null,
"refound": null,
"generated_at": "18-11-2025 04:56:00 PM"
},
],
"metadata": {
"total_items": 2
}
}
Status code: 401, 403, 404
{
"code": "Status code",
"message":"Error description",
"detail": "Error details"
}