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).

Fluxo transacionalFluxo transacional

Fluxo transacional

❗️

Sandbox

As transações de Pix podem ser criadas no ambiente de sandbox (teste), porém não devem ser pagas.

❗️

Sobre o pagamento

Para o cliente “pagador” da transação de Pix será exibida a identificação do seller no campo “mensagem ao pagador”.

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-b017-4e04-b744-7b3a0169625b5204000053039865802BR5925Zoop Tecnologia E Meios D6009SAO PAULO62070503***63042330"
        }

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 marketplace é de 5 minutos, podendo ser ajustado conforme as opções disponíveis. Para atendimento desta alteração, é necessário contatar o time de CX por email ([email protected]) ou clicando aqui.

Fluxo de statusFluxo de status

Fluxo de status

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 é 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. As taxas cobradas originalmente também são anuladas. Esse status também refere-se a uma transação de Pix não paga dentro do tempo de validade do QR Code. O evento disparado no caso de expiração de QR Code será "transaction.canceled".


Did this page help you?