Skip to content

Get transaction status

Endpoint to retrieve the current status of a transaction.
This endpoint returns the same payload structure that is delivered via webhook, allowing clients to poll transaction status synchronously if needed.

GET /v2/common/transaction-status?hotel_id={hotel_id}&ref_number={ref_number}&transaction_type={transaction_type}

Example request

GET /v2/common/transaction-status?hotel_id=17&ref_number=gk1mgfo4gr5j&transaction_type=virtual_terminal

Query parameters

PARAMETER TYPE REQ. DESCRIPTION
hotel_id Integer Yes Internal hotel identifier in Autocore.
ref_number String Yes Unique transaction reference code generated during the payment process.
transaction_type String Yes Type of transaction. Accepted values: virtual_terminal, payment_link, automated.

Response body

The response contains URLs related to the transaction and a details object with the transaction status information.

Root fields

FIELD TYPE DESCRIPTION
voucher_url String | Null URL to download the transaction voucher.
redirect_url String | Null Optional redirection URL, if applicable.
details Object Transaction status details.

details

FIELD TYPE DESCRIPTION
type String Transaction operation type. Example: charge.
id String Internal unique transaction identifier.
external_ref_id String External reference number associated with the transaction.
status_code String Technical transaction status code.
status_detail String Human-readable transaction status.
comments String Additional information or comments about the transaction result.
transaction_id String Identifier generated by the payment processor or carrier.
transaction_date Datetime Date and time when the transaction was processed (ISO 8601 format).

Status codes

CODE DESCRIPTION (ES)
pending Pendiente
applied Aplicado
rejected Rechazado
cancelled Cancelado
in_process En proceso
error Error

Response example (200)

{
    "voucher_url": "/v2/terminal-payments/787/vouchers",
    "redirect_url": null,
    "details": {
        "type": "charge",
        "id": "gk1mgfo4gr5j",
        "external_ref_id": "20250707-0001",
        "status_code": "applied",
        "status_detail": "Aplicado",
        "comments": "Pago con referencia 123456 procesado correctamente",
        "transaction_id": "RB-830169",
        "transaction_date": "2026-02-04T09:49:30.560452"
    }
}

Error responses

Status codes: 401, 403, 404

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

Notes

  • This endpoint returns the same structure used by the transaction webhook.
  • It can be used as a polling alternative when webhooks are not available.