Criar Pagamentos via QR Code Cartão Presente (Conta-para-Conta)

Este guia orienta você no processamento de um pagamento via QR Code conta-para-conta em um ambiente Cartão Presente usando a Getnet Regional API. Nesse fluxo, o terminal físico do estabelecimento solicita ao gateway um código QR EMV dinâmico, exibe-o ao cliente, e o cliente o lê com o aplicativo do seu banco para autorizar o pagamento diretamente da sua conta bancária.

Requisitos

Antes de iniciar uma solicitação de QR code, certifique-se do seguinte:

• Credenciais da API: Obtenha seu client_id e client_secret com a equipe de Suporte à Integração.
• Autenticação: Gere um Bearer token por meio do endpoint de Autenticação.
• Hardware do Terminal: Um dispositivo físico (POS/TEF) capaz de exibir imagens ou texto de alta resolução para a renderização do QR code.
• Número de Série: O serial_number físico do dispositivo deve ser fornecido em cada requisição.
• Bandeira do Cartão: Atualmente disponível exclusivamente para Visa e Mastercard.

Como Funciona

O fluxo de QR Code Cartão Presente tem três estágios:

Processo de Pagamento via QR Code

Passo 1: Criar a Requisição de QR Code

Envie uma requisição POST para o endpoint QR Code para gerar o payload do QR EMV.

Campos da Requisição

Exemplo de Requisição

curl --location --request POST 'https://api.pre.globalgetnet.com/dpm/payments-gwproxy/v2/payments/qrcode' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--header 'x-transaction-channel-entry: XX' \
--data-raw '{
  "idempotency_key": "cp-qr-visa-001",
  "request_id": "daac03dc-73db-453f-9bea-b1391669d5d3",
  "order_id": "ORDER-101",
  "amount": 10000,
  "currency": "CLP",
  "payment_method": "PURCHASE",
  "transaction_type": "NO_INTEREST",
  "serial_number": "CL00027L"
}'

Passo 2: Exibir o QR Code

Uma requisição bem-sucedida retorna HTTP 201 com um corpo JSON contendo a string EMV qr_code dentro de additional_data. Renderize esta string como uma imagem escaneável na tela do terminal.

Campos da Resposta

Exemplo de Resposta (HTTP 201)

{
  "payment_id": "03ec0ede-3bc9-42dd-a71b-1c3a670b2b89",
  "seller_id": "e0ed6f00-fdc5-46d6-9557-6a2cac641b09",
  "request_id": "daac03dc-73db-453f-9bea-b1391669d5d3",
  "idempotency_key": "cp-qr-visa-001",
  "order_id": "ORDER-101",
  "amount": 10000,
  "currency": "CLP",
  "status": "APPROVED",
  "reason_code": "00",
  "reason_message": "TRANSACTION EXECUTED SUCCESSFULLY",
  "additional_data": {
    "transaction_id": "890005df15a2-0b1e-4c6e-8ece",
    "qr_code": "00020101021241260009cl.getnet98097605970315204...",
    "qr_code_emv_type": "dynamic",
    "creation_date_qrcode": "2026-02-19T14:48:00.000Z",
    "expiration_date_qrcode": "2026-02-19T14:49:50.000Z",
    "third_party_qr_code_id": "61260970G",
    "third_party_order_id": "61260970G"
  }
}

Para processar a resposta:

1. Extraia additional_data.qr_code e renderize-o como uma imagem QR escaneável na tela do POS.
2. Inicie um cronômetro de contagem regressiva usando expiration_date_qrcode para descartar automaticamente os códigos expirados.
3. Armazene o payment_id para consultar o status de autorização final no Passo 3.

Passo 3: Verificar o Status da Transação

Depois que o cliente escanear o código QR, verifique se o pagamento foi concluído usando um destes métodos:

• Webhooks: Configure sua integração para receber notificações assíncronas de status de pagamento.
• Consulta (Polling): Chame o endpoint Get Transaction com o payment_id retornado no Passo 2.

Respostas de Erro

Próximos Passos

Agora que você entende os pagamentos via QR Code, explore estes recursos relacionados de Cartão Presente:

• Pagamentos de Passo Único: Processe vendas padrão com chip e tarja magnética.
• Pagamentos Pré-autorizados: Gerencie fluxos em dois passos para reservas e capturas atrasadas.
• Cancelar um Pagamento: Estorne uma transação capturada anteriormente.
• Requisitos do Terminal: Verifique se o seu dispositivo suporta capacidades de exibição de QR.
• Fluxo Cartão Presente: Revise os diagramas de sequência de baixo nível para todos os fluxos.