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.
• 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 com o payment_id.

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

{
  "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.

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

Próximos Passos

• Cancelar um Pagamento: Estorne uma transação autorizada usando o payment_id.
• Pagamentos via QR Code: Consulte este endpoint para confirmar que os fundos foram transferidos após uma leitura.
• Pagamentos de Passo Único: Processe vendas padrão diretamente no terminal.