Skip to content

Get reservation details

Request to get the details of a reservation, including the charging transaction and the refund if applicable.

GET https://[base_url]/v1/bookings/{booking_number}/voucher-details?hotel_id={hotel_id}&portal_code={portal_code}

Example:

GET https://[base_url]/v1/bookings/6821456123/voucher-details?hotel_id=11111&portal_code=booking

Query parameters

PARAMETER TYPE REQ. DESCRIPTION
booking_number Integer Yes Integer representing the unique reservation identifier in Roomcloud. Autocore validates against reservation code and CRS ID
hotel_id Integer Yes Integer representing the unique identifier of the hotel in Roomcloud
portal_code String Yes Refers to the OTA associated with a reservation, accepting the following values: booking, expedia, despegar, hyperguest

Endpoint response

Status code: 200

{
    "reservation_id": "22348525802",
    "hotel_id": "13645",
    "hotel": "Hotel Azuan Suites",
    "portal_code": "despegar",
    "checkin_date": "2023-07-27",
    "apply_charge_at": "2023-07-28",
    "bank": "Davivienda",
    "guest": "NOMBRE DEL HUÉSPED",
    "payment_type": "anticipo estadía",
    "payment_status": "Pendiente de pago",
    "transaction": null,
    "refound": null,
    "generated_at": "31-08-2023 01:48:03 PM",
    "voucher_url": "http://api-autocoredev.heippi.com/v1/bookings/22348525802/vouchers?hotel_id=13645&portal_co
    de=despegar"
 }

or

{
    "reservation_id": "22348525802",
    "hotel_id": "13645",
    "hotel": "Hotel Azuan Suites",
    "portal_code": "despegar",
    "checkin_date": "2023-07-27",
    "apply_charge_at": "2023-07-28",
    "bank": "Davivienda",
    "guest": "NOMBRE DEL HUÉSPED",
    "payment_type": "anticipo estadía",
    "payment_status": "Pago aplicado",
    "transaction": {
    "transaction_status": "APPROVED",
    "carrier": "Redeban",
    "transaction_id": "RB-1Rd221",
    "description": "Pago de la reserva: 22348525802, propiedad:
    Hotel Azuan Suites",
    "card_holder": "Despegar",
    "card_num": "**********1111",
    "card_type": "Visa",
    "installments": "1",
    "authorization_code": "1Rd222",
    "payment_date": "28-07-2023 06:03:07 AM",
    "total": 555666.78
    },
    "refound": null,
    "generated_at": "31-08-2023 01:48:03 PM",
    "voucher_url": "http://api-autocoredev.heippi.com/v1/bookings/22348525802/vouchers?hotel_id=13645&portal_co
    de=despegar"
}

or

{
    "reservation_id": "22348525802",
    "hotel_id": "13645",
    "hotel": "Hotel Azuan Suites",
    "portal_code": "despegar",
    "checkin_date": "2023-07-27",
    "apply_charge_at": "2023-07-28",
    "bank": "Davivienda",
    "guest": "NOMBRE DEL HUÉSPED",
    "payment_type": "anticipo estadía",
    "payment_status": "Pago aplicado",
    "transaction": {
    "transaction_status": "APPROVED",
    "carrier": "Redeban",
    "transaction_id": "RB-1Rd221",
    "description": "Pago de la reserva: 22348525802, propiedad:
    Hotel Azuan Suites",
    "card_holder": "Despegar",
    "card_num": "**********1111",
    "card_type": "Visa",
    "installments": "1",
    "authorization_code": "1Rd222",
    "payment_date": "28-07-2023 06:03:07 AM",
    "total": 555666.78
    },
    "refound": {
    "refound_status": "success",
    "authorization_code": "1R111C",
    "transaction_id": "RB-1Rd221",
    "description": "Reverso",
    "date": "28-07-2023 01:36:02 PM",
    "total": 34567.89
    },
    "generated_at": "31-08-2023 01:48:03 PM",
    "voucher_url": "http://api-autocoredev.heippi.com/v1/bookings/22348525802/vouchers?hotel_id=13645&portal_co
    de=despegar"
}

Status code: 401, 403, 404

{
 "code": "Status code",
 "message":"Error description",
 "detail": "Error details"
}