# Consultar el estado de una transacción Tarjeta Presente

Después de iniciar un pago o una captura, utilice esta guía para recuperar el estado actual de cualquier transacción Tarjeta Presente. Este es el mecanismo principal de consulta (polling) tras el escaneo de un código QR, para confirmar una captura con éxito o para solucionar problemas de una transacción que no devolvió una respuesta clara en su integración de hardware físico.

## Requisitos

Antes de seguir los pasos, debe:

- **Credenciales de la API**: Póngase en contacto con el equipo de Soporte a la Integración para obtener su `client_id` y `client_secret`.
- **Token Bearer**: Genere su token con sus credenciales utilizando el [punto de enlace de Autenticación](https://docs.globalgetnet.com/en/products/online-payments/regional-api/swagger#tag/authentication).
- **ID de Pago**: Debe tener el UUID devuelto en la transacción original (autorización, captura o generación de código QR).

## Proceso de estado de la transacción

La Getnet Regional API proporciona dos variantes de búsqueda bajo la estructura de **Payment Record Management**.

### Recuperar por ID de Pago (Payment ID)

Esta es la forma estándar de obtener el registro completo de la transacción, incluyendo su estado e historial de operaciones. Llame al [punto de enlace Get Transaction](https://docs.globalgetnet.com/en/products/online-payments/regional-api/swagger#tag/payment-record-management/get/dpm/hub-payment-info/v1/payments/info/{payment_id}) con el `payment_id`.

```bash
curl --request GET \
  --url 'https://api.pre.globalgetnet.com/dpm/hub-payment-info/v1/payments/info/8719d0c4-2c3f-4360-abd9-8daf3834fe1f' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'
```

#### Ejemplo de respuesta

```json
{
  "payment_id": "8719d0c4-2c3f-4360-abd9-8daf3834fe1f",
  "order_id": "ORDER-101",
  "status": "CAPTURED",
  "payment": {
    "amount": 30960,
    "currency": "CLP",
    "payment_method": "DIRECT_CREDIT",
    "brand": "VISA",
    "authorization_code": "204050",
    "authorized_at": "2026-02-19T14:30:00.000Z"
  },
  "records": [
    {
      "type": "response",
      "content": {
        "status": "AUTHORIZED",
        "payment_id": "8719d0c4-2c3f-4360-abd9-8daf3834fe1f",
        "authorized_at": "2026-02-19T14:30:00.000Z"
      }
    },
    {
      "type": "response",
      "content": {
        "status": "CAPTURED",
        "captured_at": "2026-02-19T14:45:00.000Z"
      }
    }
  ]
}
```

### Recuperar por Clave de Idempotencia (Opcional)

Utilice esta variante para confirmar el resultado de una operación específica vinculada a un pago, como un reintento en una solicitud de captura. Llame al [punto de enlace Get by Idempotency Key](https://docs.globalgetnet.com/en/products/online-payments/regional-api/swagger#tag/payment-record-management/get/dpm/hub-payment-info/v1/payments/info/{payment_id}/{idempotency_key}).

```bash
curl --request GET \
  --url 'https://api.pre.globalgetnet.com/dpm/hub-payment-info/v1/payments/info/8719d0c4-2c3f-4360-abd9-8daf3834fe1f/capture-key-001' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'
```

## Referencia de estados

| Estado | Significado | Siguiente acción |
| --- | --- | --- |
| `APPROVED` | Reserva de autorización realizada (dos pasos) o código QR listo. | Proceder a la captura o consultar el pago final. |
| `CAPTURED` | Venta finalizada y fondos liquidados. | No se requiere ninguna acción adicional. |
| `DENIED` | Denegado por el emisor o fallo del sistema. | Notificar al cliente y reintentar si procede. |
| `ERROR` | Error inesperado de hardware o de red. | Contactar con Soporte con el `payment_id`. |

## Próximos pasos

- **Cancelar un pago**: Revierta una transacción autorizada utilizando el `payment_id`.
- **[Pagos con código QR](/es/global-api/sep-card-present/payment-guides-cp/qr-code-cp)**: Consulte este punto de enlace para confirmar que se han transferido los fondos tras un escaneo.
- **[Pagos de un solo paso](/es/global-api/sep-card-present/payment-guides-cp/single-step-payment-cp)**: Procese ventas estándar directamente en el terminal.