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.