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

❗️

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 marketplace é 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 ([email protected]) ou clicando aqui.

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 ([email protected]) ou clicando aqui.

🚧

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.

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.