# Consultar Status de Transação Cartão Presente

Após iniciar um pagamento ou captura, use este guia para recuperar o estado atual de qualquer transação Cartão Presente. Este é o principal mecanismo de consulta (polling) após a leitura de um QR Code, para confirmar uma captura bem-sucedida ou investigar uma transação que não retornou uma resposta clara na sua integração de hardware físico.

## Requisitos

Antes de seguir os passos, você precisa:

- **Credenciais da API**: Entre em contato com a equipe de Suporte à Integração para obter seu `client_id` e `client_secret`.
- **Bearer Token**: Gere seu token com suas credenciais usando o [endpoint de Autenticação](https://docs.globalgetnet.com/en/products/online-payments/regional-api/swagger#tag/authentication).
- **Payment ID**: Você deve ter o UUID retornado da transação original (autorização, captura ou geração de QR code).

## Processo de Status da Transação

A Getnet Regional API fornece duas variantes de consulta sob a estrutura de **Payment Record Management**.

### Recuperar por Payment ID

Esta é a forma padrão de obter o registro completo da transação, incluindo seu status e histórico de operações. Chame o [endpoint 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}) com o `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>'
```

#### Exemplo de Resposta

```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 Idempotency Key (Opcional)

Use esta variante para confirmar o resultado de uma operação específica vinculada a um pagamento, como uma tentativa de reprocessamento em uma requisição de captura. Chame o [endpoint 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>'
```

## Referência de Status

| Status | Significado | Próxima Ação |
| --- | --- | --- |
| `APPROVED` | Reserva de autorização realizada (dois passos) ou QR code pronto. | Prossiga para a captura ou consulte o pagamento final. |
| `CAPTURED` | Venda finalizada e fundos liquidados. | Nenhuma ação adicional é necessária. |
| `DENIED` | Recusado pelo emissor ou falha no sistema. | Notifique o cliente e tente novamente, se aplicável. |
| `ERROR` | Erro inesperado de hardware ou rede. | Entre em contato com o Suporte informando o `payment_id`. |

## Próximos Passos

- **Cancelar um Pagamento**: Estorne uma transação autorizada usando o `payment_id`.
- **[Pagamentos via QR Code](/pt/global-api/sep-card-present/payment-guides-cp/qr-code-cp)**: Consulte este endpoint para confirmar que os fundos foram transferidos após uma leitura.
- **[Pagamentos de Passo Único](/pt/global-api/sep-card-present/payment-guides-cp/single-step-payment-cp)**: Processe vendas padrão diretamente no terminal.