Paylogos
  1. PIX
Paylogos
  • GUIA DE IMPLEMENTAÇÃO
    • INTRODUÇÃO E ASPECTOS GERAIS
      • Introdução a Paylogos
      • Requisitos de segurança
      • Autenticação
      • Bandeiras aceitas
      • Conta Gráfica Paylogos
      • Webhook
        • Notificações e eventos
        • Webhook com autorização
    • CADASTRO E CREDENCIAMENTO
      • Compradores
    • GESTÂO DE TRANSAÇÃO E RECEBÍVEIS
      • Pagamentos digitais
      • Recebível
      • Pagamentos Recorrentes (Planos e Assinaturas)
      • Recibo
      • Eventos de webhook
      • Dúvidas frequentes (FAQ)
      • Cartão de crédito online
        • Cobrando com cartão de crédito online
        • Coletando dados de cartão
        • Autorização direta de transações
        • Cobrando com o id do customer (customer_id)
        • Cobrando com o id do cartão (card_id)
        • Pré-autorização de transações
        • Parcelando transações
        • Utilizando Data Only
        • Utilizando 3DS MPI
      • Boleto bancário
        • Cobrando com boleto bancário
        • Layout boleto
        • Gerando um boleto
        • Multa, juros e descontos
      • PIX
        • Cobrando com Pix online
        • Pix online
        • Preparando o seller para oferta do Pix online
        • Criando uma transação Pix online
        • Regras de Payout Pix online
      • Cancelamentos e Extornos
        • Cancelando transações cartão
        • Solicitação de cancelamento e estorno de boletos
        • Estorno da transação Pix
    • REPASSES E TRANSFERÊNCIAS
      • Transferência
      • Política de recebimento
      • Saldo de conta
      • Eventos de webhook
      • Dúvidas frequentes (FAQ)
  • REFERÊNCIAS DE API
    • INTRODUÇÃO E ASPECTOS GERAIS
      • Introdução
      • Requisitos de segurança
      • Autenticação
      • Testando
      • Códigos de erro
    • CADASTRO E CREDENCIAMENTO
      • Compradores
        • Criar comprador
        • Listar compradores
        • Alterar comprador
        • Recuperar detalhes de comprador por ID
        • Remover comprador por ID
        • Buscar comprador por CPF/CNPJ
    • TOKENIZAÇÃO DE CARTÃO
      • Tokenização de cartão
        • Criar novo token de cartão
    • GESTÃO DE TRANSAÇÕES E RECEBÍVEIS
      • Gestão de cartão
        • Associar cartão com comprador
        • Listar detalhes de cartão pelo identificador
        • Remover cartão pelo identificador
      • Transações
        • Criar transação - Autorização Direta
        • Criar transação - Usando Customer ID
        • Criar transação - Usando Card ID
        • Criar transação - Boleto com PIX
        • Criar transação - Boleto Simples
        • Criar transação - Boleto Completo
        • Criar transação - PIX
        • Listar transações
        • Listar detalhes de transação pelo identificador
        • Alterar detalhes de transação pelo identificador
        • Estornar transação
        • Disponibilizar link carta de cancelamento
      • Source
        • Criar source para utilização transação
        • Listar detalhes de source pelo identificador
        • Remover source pelo identificador
      • Boleto
        • Enviar cobrança de boleto por email
        • Listar detalhes de boleto
        • Solicitar cancelamento de boleto
      • Planos de Recorrência
        • Criar um plano
        • Listar planos
        • Recupera um plano pelo identificador
        • Alterar plano pelo identificador
        • Deletar um plano pelo identificador
      • Assinatura de Recorrência
        • Criar uma assinatura
        • Listar assinaturas
        • Listar os detalhes de uma assinatura pelo identificador
        • Alterar os detalhes de uma assinatura pelo identificador
        • Remover uma assinatura pelo identificador
        • Suspender uma assinatura pelo identificador
        • Reativa uma assinatura pelo identificador
      • Fatura de Recorrência
        • Criar uma fatura avulsa
        • Listar faturas
        • Listar os detalhes de uma fatura pelo identificador
        • Remover uma fatura pelo identificador
        • Aprovar fatura pendente
        • Estornar e reembolsar fatura
      • Recibo
        • Enviar recibo por email
        • Enviar recibo por SMS
        • Recuperar detalhes do recibo
        • Renderizar template de recibo HTML
      • Recebível
        • Listar detalhes de recebível
        • Listar recebíveis por transação
    • REPASSES E TRANSFERÊNCIAS
      • Saldo de Conta
        • Listar contas por buyer
        • Listar histórico de lançamentos pelo identificador da conta
        • Listar histórico de lançamentos de conta
        • Listar histórico de lançamentos de conta por buyer
        • Recuperar saldo
      • Transferências
        • Listar transferências
        • Recuperar detalhes de transferência
        • Listar transações associadas a transferência
      • Lançamentos Futuros
        • Listar lançamentos futuros
      • Saldo atual de Conta
        • Recuperar saldo atual de conta
    • NOTIFICAÇÕES E EVENTOS
      • Webhook
        • Criar webhook
        • Listar webhooks
        • Recuperar detalhes de webhook
        • Remover webhook
  1. PIX

Criando uma transação Pix online

Para criar uma transação do tipo Pix, será utilizada a mesma API de transação, apenas alterando o "payment_type"(meio de pagamento) para "pix" (parâmetro).
016ee33c594079fe1d0ed81a3711af4f9ac009be1da9b029120b2659d95e02c9-fluxo_pix.jpg
❗️ Sobre o pagamento
Para o cliente “pagador” da transação de Pix será exibida a identificação do seller no campo “mensagem ao pagador”.
Caso uma confirmação de pagamento seja realizada depois da expiração do QR Code, automaticamente uma operação de cancelamento (void) será comandada.

QR Code e "Copia e cola"#

Para obter os dados para gerar QR Code ou para o pagamento "copia e cola" é necessário utilizar a informação que retorna no campo "emv" após a criação do Pix, conforme o exemplo abaixo:
"qr_code": {
            "emv": "00020101021226770014BR.GOV.BCB.PIX2555api.itau/pix/qr/v2/c8f91ed7-9999-4e04-9999-7b3a0169625b5000000053039865802BR5925Zoop Tecnologia E Meios D6009SAO PAULO62070503***9999999"
        }

Tempo de expiração de Pix QR Code.#

É possível o marketplace escolher o tempo limite para expiração de QR Code, podendo ser 05, 10, 15, 30 minutos, 1, 3, 6, 12 ou 24 horas
Atualmente, o limite global para qualquer seller é de 5 minutos, podendo ser ajustado conforme as opções disponíveis. Para atendimento desta alteração, será necessário contatar o nosso Suporte através do e-mail (suporte@paylogos.com.br).

Tempo de expiração de PIX QR Code acima de 24h#

Poderá ser habilitado um tempo acima de 24h para expiração do Pix, onde o limite da duração e tempo máxima será de 730 dias que é o equivalente há aproximadamente 2 anos. Quando habilitada essa opção, a duração poderá ser passada diretamente no request da transação de PIX API de transação.
Para ter acesso a essa funcionalidade, também será necessário contatar o nosso suporte através do e-mail (suporte@paylogos.com.br).
🚧 Atenção!
Só poderá utilizar expiração acima de 24h para clientes que possuam operações exclusivamente online. Caso o parceiro possua operações presenciais, o Pix não poderá ser configurado acima desse limite.
e0b3330363b815a8cd64fa9d897876f1a6c51fcd04f63c7ed14cab2de13d8259-pix_mind_map.jpg

Fluxo de status#

Durante o fluxo de compra uma transação existem diferentes estados de acordo com as atualizações aplicadas.
Você pode verificar o estado atual através do campo "status", sempre retornado no objeto da transação. Também será possível verificar o histórico de uma transação através do campo "history".
New: Uma nova transação foi criada e as informações foram recebidas com sucesso para processamento.
Pending: Observe que o status da transação é retornado como pending, permanecendo neste estado até que o pagamento seja identificado ou então o prazo de validade se encerre.
Succeeded: O pagamento do Pix foi identificado pela Zoop.
Failed: Ocorreu uma falha ao processar a transação.
Canceled: O pagamento foi cancelado/anulado pelo vendedor, logo as taxas cobradas originalmente também serão anuladas, pois esse status também se refere a uma transação de Pix que não foi paga dentro do tempo da validade do limite de expiração.
❗️ Atenção
Atenção
A chave "reference_id" deve ter uma valor único em cada requisição de transação, não podendo ter seu valor informado repetido.
Modificado em 2025-06-04 19:59:05
Página anterior
Preparando o seller para oferta do Pix online
Próxima página
Regras de Payout Pix online
Built with