📌 FAQ – Tópicos Relacionados no Pix

CPF

O CPF (Cadastro de Pessoas Físicas) é um número de identificação fiscal usado no Brasil para pessoas físicas. É como um CNPJ pessoal que todo cidadão brasileiro ou residente estrangeiro deve ter.
Ele é usado para vários fins, incluindo transações financeiras, abertura de contas bancárias, pagamento de impostos e muito mais. Exemplo: 268.211.520-98
Formato JSON: 26821152098
Validação de formato: ^[0-9]{11}$

CNPJ

O CNPJ (Cadastro Nacional da Pessoa Jurídica) é um número de identificação fiscal usado no Brasil para empresas e outras pessoas jurídicas. É como o CPF, mas para empresas. Toda empresa registrada no Brasil deve ter um CNPJ, que é usado para fins comerciais, como abertura de contas bancárias, emissão de notas fiscais, pagamento de impostos, contratação de funcionários, entre outros. Exemplo: 58.255.572/0001-00
Formato JSON: 58255572000100
Validação de formato: ^[0-9]{14}$

Chave Pix

O Chave Pix é como um "endereço único" que você pode usar para receber pagamentos instantâneos no Brasil de forma rápida e fácil. Essa chave atua como um identificador exclusivo vinculado à sua conta bancária no Brasil. Mesmo se você estiver nos EUA, você pode ter uma conta bancária brasileira e usar o Pix. O Chave Pix pode ser associado a vários tipos de informações, como CPF/CNPJ, número de telefone, e-mail ou até mesmo uma chave aleatória gerada pelo sistema. Essa variedade permite que você escolha a maneira mais conveniente de receber pagamentos sem precisar compartilhar informações bancárias confidenciais, como números de contas bancárias e agências. Quando alguém faz uma transferência para você, basta fornecer sua Chave Pix, seja CPF/CNPJ, telefone, e-mail ou chave aleatória. Isso simplifica muito o processo de pagamento, pois elimina a necessidade de preencher vários dados bancários, como era exigido anteriormente.

ID da transação

Esse identificador serve para identificar exclusivamente uma cobrança específica. Portanto, o txid é utilizado pelo usuário destinatário em seus processos de conciliação de pagamentos recebidos via Pix. Este identificador pode ser gerado automaticamente pela API Pagstar (apenas para cobranças imediatas) ou pode ser fornecido pelo parceiro. Nesse caso, o parceiro deve garantir que o valor txId seja exclusivo para o receptor (CPF/CNPJ).
O txid deve ter um comprimento mínimo de 26 caracteres e um comprimento máximo de 35 caracteres. Os caracteres aceitos neste contexto são: A-Z, a-z, 0-9.
Validação de formato: ^[A-Za-z0-9]{35}$

Status da carga

O campo "status" representa o status da cobrança de pagamento imediato e pode assumir os seguintes estados:

• ATIVO: Este status indica que a cobrança do Pix está ativa e disponível para pagamento. A cobrança está em andamento e pode ser cumprida pelo pagador.
• CONCLUÍDO (status final): Este status significa que a cobrança do Pix foi concluída com sucesso. A transação de pagamento associada à cobrança foi executada e os fundos foram transferidos do pagador para o destinatário.
• REMOVED_BY_RECIPIENT (status final): Este status indica que a cobrança do Pix foi retirada ou cancelada pelo usuário destinatário (que solicitou o pagamento). Essa ação pode ser iniciada pelo destinatário por vários motivos, como cancelar a transação, precisar modificar os detalhes do pagamento ou outros motivos administrativos.
• REMOVED_BY_PSP (status final): Este status significa que a cobrança do Pix foi retirada ou cancelada pela Pagstar Finance. A remoção da cobrança pela Pagstar Finance pode ocorrer por motivos de conformidade, problemas técnicos ou outras considerações operacionais (como quando expirado, por exemplo).

E2e (endToEndId)

A identificação endToEndId (e2e) é um componente crucial que garante a rastreabilidade e a integridade da transação. É um identificador único atribuído a cada transação de pagamento, permitindo o rastreamento de ponta a ponta do pagador ao beneficiário. Esse identificador permanece constante durante todo o ciclo de vida da transação, desde o início até a conclusão, e serve como ponto de referência para reconciliação e resolução de disputas.
O endToEndId normalmente é gerado pela parte iniciadora e incluído na instrução de pagamento. Pode consistir em vários elementos de dados, como uma combinação de caracteres alfanuméricos, números de referência de transação ou quaisquer outros identificadores especificados pelo sistema de pagamento. Esse ID ajuda a diferenciar uma transação de outra e evita duplicação ou interpretação incorreta.
Além disso, o endToEndId desempenha um papel crucial na manutenção da integridade e segurança das transações. Ele garante que o pagamento chegue ao destinatário pretendido sem alteração ou interceptação por partes não autorizadas. Ao incluir esse identificador, tanto o remetente quanto o destinatário podem verificar a autenticidade da transação e reconciliá-la com seus respectivos registros.
No geral, o endToEndId no pagamento Pix facilita o processamento eficiente das transações, aumenta a transparência e fortalece as medidas de segurança, contribuindo para um ecossistema de pagamentos confiável e contínuo.