Obtenha o valor, o número do pedido e o
nome do comerciante de uma captura de WeChat Pay

Onde o Valor, o Nome do Comerciante e o Número do Pedido Ficam na Tela

Na tela de detalhes de uma transação do WeChat Pay — a página que você acessa ao tocar em um pagamento no histórico de transações da sua Carteira (钱包) — o valor é a primeira coisa que você verá: um número grande perto do topo, exibido em yuan (¥) com duas casas decimais. Para pagamentos a comerciantes, a moeda é quase sempre CNY. Para transações transfronteiriças processadas pela liquidação global do WeChat Pay, o valor pode aparecer na moeda local do comerciante (HKD, USD, EUR) com o equivalente em RMB mostrado em texto menor abaixo. Se a sua captura de tela incluir ambos os valores, aquele que você deve usar depende do que você está rastreando — o valor que você pagou (a dedução do seu saldo ou cartão) ou o valor que o comerciante recebeu.

O nome do comerciante (商户) aparece abaixo do valor, geralmente acompanhado por um pequeno ícone ou etiqueta de categoria atribuída pelo WeChat Pay — "餐饮" (alimentação), "交通" (transporte), "购物" (compras). Este é o nome comercial registrado que o comerciante informou ao WeChat Pay ao abrir sua conta de comerciante. Para uma loja conhecida, como uma rede de supermercados, o nome na tela corresponderá à marca da loja. Para um vendedor ambulante que usa um código QR de recebimento pessoal, o nome do comerciante pode ser algo menos reconhecível — o nome comercial registrado do vendedor, em vez do nome da barraca que você conhece. Este é o campo mais importante para confirmar antes de registrar a transação: se você está vinculando este pagamento a um fornecedor específico nos seus registros, certifique-se de que o nome na captura de tela seja aquele que você procurará depois.

O número do pedido (订单号 ou 交易单号) é o campo em letras pequenas na parte inferior da tela de detalhes, normalmente uma sequência de 28 dígitos que começa com um prefixo de data como 4200002193. O WeChat Pay gera dois números de referência diferentes para cada transação: o número do pedido do WeChat Pay (transaction_id, 微信支付订单号), que é o ID de rastreamento interno da plataforma, e o número do pedido do comerciante (out_trade_no, 商户订单号), que é a referência atribuída pelo sistema do comerciante à venda. A tela de detalhes geralmente mostra um ou ambos, dependendo da integração do comerciante. O número do pedido do WeChat Pay é o identificador mais consistente — toda transação tem um, independentemente da configuração do comerciante. Se a sua captura de tela incluir ambos, registre o número do pedido do WeChat Pay como referência principal; é o que você usaria para rastrear uma cobrança contestada ou conciliar com um extrato bancário.

O método de pagamento — qual cartão bancário ou se o pagamento veio do seu saldo do WeChat (零钱) — e o horário exato da transação (com precisão de segundos, no horário de Pequim) também aparecem nesta tela. Se você está extraindo dados para fins fiscais ou de reembolso, o carimbo de data/hora indica o momento exato em que o pagamento foi processado, o que pode ser relevante para determinar a qual período contábil uma transação pertence.

Por que um print de uma transferência para um amigo parece diferente de um pagamento a um comerciante

O WeChat Pay lida com três tipos distintos de transações por meio de três telas diferentes, e os campos visíveis em cada uma não são o mesmo conjunto. Saber qual tipo seu print captura determina quais dados você consegue extrair de fato.

Pagamentos a comerciantes — escanear um código QR em uma loja, pagar por um Mini Program ou usar o Quick Pay (被扫), em que o caixa escaneia seu código de barras — geram a tela de confirmação mais rica: valor, nome do comerciante com etiqueta de categoria, número do pedido, método de pagamento e data/hora. Essa é a tela descrita acima, e ela contém todos os três campos abordados neste artigo.

Transferências para um amigo (转账) geram uma confirmação incorporada ao chat: o valor aparece em um balão no estilo cartão dentro da conversa, o nome de exibição do destinatário no WeChat é mostrado (não um nome de comerciante — não existe "comerciante" em uma transferência pessoa a pessoa), e o horário da transferência é registrado. Não há número do pedido no mesmo sentido de uma transação com comerciante; em vez disso, o WeChat gera um ID de registro de transferência visível no histórico de transações da Carteira. A diferença principal: em um print de transferência, o campo da contraparte é o nome de exibição de uma pessoa — editável, mutável, não uma identidade comercial verificada. Se você está registrando transferências para dividir despesas ou acompanhar renda, registre o ID do WeChat ou o nome de exibição como apareceu na época, mas saiba que a mesma pessoa pode aparecer com um nome diferente nos prints do próximo mês.

Envelopes vermelhos (红包) são o terceiro tipo e o menos rico em dados. Uma confirmação de envelope vermelho mostra o valor recebido (ou enviado), o nome do remetente ou destinatário e uma mensagem de saudação — sem número do pedido, sem comerciante, sem detalhe do método de pagamento. O valor em um envelope vermelho de grupo baseado em sorte é uma divisão aleatória, então o valor que você vê é sua parte de um total que você pode não saber. Para fins de registro, um print de envelope vermelho fornece um campo confiável: o valor. Todo o resto é o mínimo.

A implicação prática: se você está misturando prints dos três tipos de transação em uma mesma pasta e tentando extrair o mesmo conjunto de colunas de cada um, um print de pagamento a comerciante preencherá os três campos, um print de transferência fornecerá o valor e um nome (mas sem número do pedido), e um print de envelope vermelho pode fornecer apenas o valor. Suas definições de colunas precisam considerar essas diferenças — um campo que existe em um tipo de print pode estar ausente em outro.

Por que o OCR tradicional não consegue ler uma captura de WeChat Pay de forma confiável — e o que pode

A abordagem convencional para extrair dados de uma captura de tela — passá-la por OCR e esperar que o texto caia nas colunas corretas — encontra um obstáculo com WeChat Pay por um motivo que nada tem a ver com a qualidade da imagem. É um problema de layout, e está enraizado no design da plataforma.

As telas de confirmação do WeChat Pay não são formulários. O valor não está em um campo rotulado que diga "Valor: ¥__.__" — é um número isolado em fonte grande no topo da tela, acima de um nome de comerciante em fonte média, acima de um número de pedido em fonte pequena na parte inferior. Um motor de OCR tradicional vê três números em tamanhos de fonte decrescentes e não tem forma de determinar qual é o valor, qual é um timestamp e qual é um ID de referência. Ele lê caracteres, não contexto.

O OCR baseado em modelos — desenhando uma caixa delimitadora ao redor de onde o valor "geralmente" aparece — agrava o problema. Uma tela de pagamento a comerciante organiza os campos em um layout diferente de uma tela de transferência. Um pagamento a um comerciante Mini Program (como pedir entrega de comida via Meituan dentro do WeChat) pode adicionar detalhes de itens de linha que empujan o número de pedido mais abaixo na página que uma simples leitura de código QR em uma conveniencia. Uma captura do modo escuro do WeChat inverte o esquema de cores mas mantiene o mesmo conteúdo de texto. Cada variação é um modelo separado a construir e manter, e uma captura de um tipo de transação que você não modelou devuelve lixo.

A alternativa é a extração semântica: em vez de dizer à ferramenta onde cada campo fica na tela, você diz o que procurar — "o número que representa um valor de pagamento," "o nome comercial registrado abaixo," "o número de 28 dígitos perto da parte inferior que começa com um prefixo de data." O motor de extração lê a captura do mesmo modo que uma pessoa a lê: entende que ¥328.50 é um valor e que uma string como 4200002193202403093640737027 é um número de pedido, independentemente de onde cada um apareça na página. O mesmo conjunto de definições de columna — Valor, Comerciante, Número de Pedido — funciona em pagamentos a comerciantes, transferências e até entre plataformas: as mesmas três colunas que extraen dados de uma captura de WeChat Pay também funcionan em uma captura de Venmo, PayPal ou Alipay, porque a extração procura o que os dados significan, não onde ficam.

A mesma abordagem funciona com capturas de tela de qualquer aplicativo de pagamento — Venmo, Zelle, PayPal, Alipay — porque a extração lê o que está na imagem, não qual aplicativo a gerou. Se você recebe pagamentos em várias plataformas, um único conjunto de colunas os reúne em uma planilha sem reconfiguração por aplicativo.

O Que Você Realmente Faz Com Essa Linha Depois de Extraí-la

Obter o valor, o número do pedido e o nome do comerciante de uma captura de tela é a primeira metade. A segunda metade é o que acontece quando esses três valores chegam a uma linha de planilha — e, para a maioria das pessoas que usam WeChat Pay, raramente é um exercício único.

Para conciliação de despesas: as transações do WeChat Pay se acumulam rápido — almoço aqui, um táxi ali, uma conta de utilidade paga por um Mini Programa. No fim do mês, comparar o que seu saldo do WeChat mostra com o que seu extrato bancário diz significa percorrer uma lista rolante de registros de transações dentro do aplicativo, um toque por vez. Uma planilha com linhas extraídas — valor, data, comerciante, número do pedido — dá a você o lado WeChat Pay da conciliação no mesmo formato do seu extrato bancário. O número do pedido é a ponte entre os dois: é o identificador que aparece tanto no seu registro do WeChat Pay quanto, para reembolsos ou disputas, no sistema do comerciante.

Para reembolso: muitas empresas na China e em toda a Ásia exigem uma captura de tela da confirmação do WeChat Pay como documentação de suporte para pedidos de despesas. As equipes financeiras frequentemente digitam manualmente o valor e o comerciante dessas capturas em uma planilha de aprovação. Extrair os três campos principais — em vez de copiar e colar — transforma uma pilha de capturas em uma única tabela de pedidos em segundos. Anexe a tabela ao seu formulário de reembolso e mantenha as capturas originais como backup; os dados extraídos cobrem o que o aprovador realmente precisa ver.

Para registro de renda e registros fiscales: proprietários de pequenas empresas e freelancers que receben pagamentos de clientes através do WeChat Pay — via código QR pessoal ou código de recibo de comerciante — precisan de um registro completo por data, valor e cliente. O histórico de transações dentro do app do WeChat Pay é um feed cronológico, não um livro de contabilidade filtrable, e as ferramentas de exportação integradas do WeChat são desenhadas para contas de comerciante com acesso à API, não para usuários individuais. Um fluxo de trabalho de captura de tela a planilha cria um registro pesquisable e ordenable sem exigir uma atualização de conta de comerciante. Se você está declarando impostos em uma jurisdição que exige documentação de apoio para renda de negócios, a linha extraída — valor, data, contraparte — são os dados que você precisa; a captura de tela é a prova.

O fio que conecta todos estes usos posteriores não é uma profissão específica ou um nível de renda. É o momento em que uma única transação se torna uma de muitas — quando você precisa ver vinte pagamentos do WeChat Pay em uma tabela, não um de cada vez dentro do app.

FAQ

Uma captura de tela do WeChat Pay funciona igual que um recibo para reembolsos de gastos?

A captura de tela contém os três pontos de dados que um informe de gastos típico precisa — valor, comerciante e referência de transação. Se sua empresa ou autoridade fiscal a aceita como recibo depende da sua política específica de documentação. Na China, o número do pedido do WeChat Pay (transaction_id) é uma referência rastreable que tanto o pagador como o banco adquirente do comerciante podem usar para verificar uma transação, o que o torna funcionalmente equivalente a um número de referência de recibo. Para fins fiscales ou de auditoría, conserve a captura de tela original junto com os dados extraídos.

Posso extrair dados de uma captura de tela do WeChat Pay se a interface está em chinês?

Sim. A extração lê os números e textos na imagem independentemente do idioma da interface. Um símbolo ¥ significa o mesmo, quer os rótulos ao redor digam "支付金额" ou "Payment Amount". Se seus nomes de colunas estão em inglês, os valores extraídos preencherão essas colunas independentemente do idioma de origem na captura de tela. Isto também significa que capturas de tela da interface do WeChat Pay em chinês e da interface internacional do WeChat Pay podem ir no mesmo lote.